driver

README

驱动

驱动在Rulex里面被定义成最底层的设施，对于硬件而言，可能是个通信方式，对于软件而言，可能是个通信协议。

硬件驱动

比如串口、USB以及RJ45等直接操作硬件端口的方式，都称之为硬件驱动。

软件驱动

比如某个设备桥接的时候需要一种底层协议，比如可能是个UnixSocket或者是信号等，可能就是普通的二进制协议。

标准驱动

目前有部分厂商设备接入, 未来更多驱动可以由产商实现。或者根据不同的设备类型来自己实现个性化需求。

关于写驱动的建议

1. 驱动永远关注“读”和“写”，而不要关注读出来的是不是对的
2. 设备只管问驱动要数据，然后将其加工成应用格式，设备不关注读写细节
3. 资源只管数据流向而不用管怎么来的，只管输送或者接收

综上所述，设备、资源本质上是两类东西，设备是真实物理器材，资源是逻辑存在的软件源或者目标。

现阶段支持的驱动

目前支持下面几个基础驱动

名称	版本	简介
通用modbus_rtu	1.0	modbus RTU 模式
通用modbus_tcp	1.0	modbus RTU 模式
通用串口	1.0	通用串口读写
rtu_485_ther	1.0	485温湿度传感器
tss200	1.0	多指标环境参数传感器
yk08	1.0	国产8口继电器控制器
raw_uart_driver	1.0	通用串口数据透传驱动
s1200	1.0	西门子S1200系列的DB读写驱动
usr g776	1.0	有人G776型号的4G DTU模块

提示：未来可能不会在RULEX内置其他新设备，而是通过外部插件的形式，上面表格里的这些设备可以认为是个基准示例。

Documentation

Overview

uart_driver相当于是升级版，这个是最原始的基础驱动

Index

• func NewModBusRtuDriver(d *typex.Device, e typex.RuleX, Registers map[string]*common.RegisterRW, ...) typex.XExternalDriver
• func NewModBusTCPDriver(d *typex.Device, e typex.RuleX, Registers map[string]*common.RegisterRW, ...) typex.XExternalDriver
• func NewRawUartDriver(ctx context.Context, e typex.RuleX, device *typex.Device, ...) typex.XExternalDriver
• func NewSnmpDriver(d *typex.Device, e typex.RuleX, client *gosnmp.GoSNMP) typex.XExternalDriver

Functions

func NewModBusRtuDriver

func NewModBusRtuDriver(
	d *typex.Device,
	e typex.RuleX,
	Registers map[string]*common.RegisterRW,
	handler *modbus.RTUClientHandler,
	client modbus.Client) typex.XExternalDriver

func NewModBusTCPDriver

func NewModBusTCPDriver(
	d *typex.Device,
	e typex.RuleX,
	Registers map[string]*common.RegisterRW,
	handler *modbus.TCPClientHandler,
	client modbus.Client) typex.XExternalDriver

func NewRawUartDriver

func NewRawUartDriver(
	ctx context.Context,
	e typex.RuleX,
	device *typex.Device,
	serialPort serial.Port,
) typex.XExternalDriver

初始化一个驱动

func NewSnmpDriver

func NewSnmpDriver(
	d *typex.Device,
	e typex.RuleX,
	client *gosnmp.GoSNMP,
) typex.XExternalDriver