device 模型的一些建议

发布于 2010-01-14 11:45:41 浏览：4285 订阅该版

[tocm]

目前在设计串口方面的功能，发现使用 device 的rx_indicate接口，有点局限，提出建议请参考。

先上rt_device结构：
```c
struct rt_device
{
	struct rt_object parent;
/* device type */
	enum rt_device_class_type type;
/* device flag and device open flag*/
	rt_uint16_t flag, open_flag;
/* device call back */
	rt_err_t (*rx_indicate)(rt_device_t dev, rt_size_t size);
	rt_err_t (*tx_complete)(rt_device_t dev, void* buffer);
/* common device interface */
	rt_err_t  (*init)	(rt_device_t dev);
	rt_err_t  (*open)	(rt_device_t dev, rt_uint16_t oflag);
	rt_err_t  (*close)	(rt_device_t dev);
	rt_size_t (*read)	(rt_device_t dev, rt_off_t pos, void* buffer, rt_size_t size);
	rt_size_t (*write)	(rt_device_t dev, rt_off_t pos, const void* buffer, rt_size_t size);
	rt_err_t  (*control)(rt_device_t dev, rt_uint8_t cmd, void *args);
#ifdef RT_USING_DEVICE_SUSPEND
	rt_err_t (*suspend) (rt_device_t dev);
	rt_err_t (*resumed) (rt_device_t dev);
#endif
/* device private data */
	void* private;
};
/*@}*/
#endif

#ifdef __cplusplus
}
```
* 结构中有个rt_err_t (*rx_indicate)(rt_device_t dev, rt_size_t size); 回调安装点。
* 使用者通过下面的接口设置挂载点；
```c
rt_err_t rt_device_set_rx_indicate(rt_device_t dev, rt_err_t (*rx_ind )(rt_device_t dev, rt_size_t size))
{
	RT_ASSERT(dev != RT_NULL);

dev->rx_indicate = rx_ind;
	return RT_EOK;
}
```

## 局限场景：
设备使用者的局部设置了一个邮箱（注意是局部变量），open串口设备，使用control接口设置接收警告水位，再调用rt_device_set_rx_indicate()函数想设置一个回调，回调函数在另外一个函数中，没法引用到上面提到的邮箱局部变量，所以造成一个限制——只可以将邮箱设置为全局变量，才能使用device目前的回调机制。

rt_device_set_rx_indicate()接口参数中仅仅能够设置回调函数，不能体现安装者本身的信息，所以是否应该再添加一个参数——void *param；这就有利于安装使用者的信息了。这个信息可以挂在rt_device结构中，作为设备使用者信息，当然，也可以在open()时设置这个信息，作为设备拥有者的标志。

如果dev中含有这个信息，在回调函数上，如下：
**rt_err_t (*rx_indicate)(rt_device_t dev, rt_size_t size);**
因为含有dev参数，就可以引用打开本设备的对象任何必要信息了。