Android Sensor 适配层的书写--主要是对函数的介绍

Sensor 适配层的书写-----大家多讨论

前文说了,适配层的基本的接口。现在将接口中的内容扩展说下,其实在sensors.h文件中已经说的很明确了,这里只不过是怕自己有遗忘翻译了一下。
/**
 * Every device data structure must begin with hw_device_t
 * followed by module specific public methods and attributes.
 */
struct sensors_control_device_t {
    struct hw_device_t common;
    
    /**
     *返回一个native_handle_t的指针
     *
     * The caller takes ownership of this handle. This is intended to be
     * passed cross processes.
     *
     *成功返回native_handle_t,失败返回NULL
     */
    native_handle_t* (*open_data_source)(struct sensors_control_device_t *dev);

    /**
     * 释放所有在open_data_source中申请的资源
     * 这个调用的函数是可选的,可以设置为NULL
     * 成功返回0,失败小于0
     *
     * @return 0 if successful, < 0 on error
     */
    int (*close_data_source)(struct sensors_control_device_t *dev);

    /** 使一个sensor有效或者无效
     *
     * 参数:
     *     handle: 需要变化的sensor的handle
     *     enable: 1,使能;0,无效
     * 返回值:
     *     成功为0,失败为1
     */
    int (*activate)(struct sensors_control_device_t *dev, 
            int handle, int enabled);
    
    /**
     * 设置sensor event的间隔时间,单位ms
     *
     * 成功为0,失败小于0
     */
    int (*set_delay)(struct sensors_control_device_t *dev, int32_t ms);

    /**
     * 促使sensors_data_device_t.poll()立即返回-EWOULDBLOCK
     */
    int (*wake)(struct sensors_control_device_t *dev);
};

struct sensors_data_device_t {
    struct hw_device_t common;

    /**
     * 准备读取sensor的数据
     *
     * This routine does NOT take ownership of the handle
     * and must not close it. Typically this routine would
     * use a duplicate of the nh parameter.
     *这个函数不能改变handle的权限,也不能关闭他。标准的做法,只是简单的将nh复制给dev使用;
     * 参数nh:来自于sensors_control_open
     * 返回值:0表示成功,小于0表示失败;
     */
    int (*data_open)(struct sensors_data_device_t *dev, native_handle_t* nh);
    
    /**
     *
     * 调用者必须完成了sensor的数据读取才可以调用此函数。因此可以知道,此函数会将设备节点给关闭掉;
     * 调用此函数不会阻塞poll函数。
     * 成功返回0,失败小于0
     * /
    int (*data_close)(struct sensors_data_device_t *dev);
    
    /**
     * 
     * sensors_data_t指针返回指定的sensor的数据
     * 返回值:sensor的handle
     * poll的实现这里也说的很清楚,是返回指定的sensor的数据,也就是说这个poll不能一次把所有的sensor的数据都拿到
     */
    int (*poll)(struct sensors_data_device_t *dev, 
            sensors_data_t* data);
};
这些函数的调用顺序是如何的呢?这就要看上层JAVA的调用了,反正JNI也指示函数的重定义。(当然这也只是我自己的理解)


其实到了这里大家也都清楚这些函数的作用,整个hal层的代码也只是这些函数的实现。其中这里hal和java的通信的话不得不考虑其中有一个native_handle这样的机制,下面在看看这个再说。

 

你可能感兴趣的:(java,android,struct,jni,methods,structure)