Linux之IR驱动
背景
在光谱中波长自760nm至400um的电磁波称为红外线,它是一种不可见光。红外遥控成本很低,以前广泛应用在电视,空调等电器的控制上面,现在随着蓝牙遥控器慢慢普及,红外遥控越来越少,但在某些场景,还保留着红外通信
红外属于media子系统里面的rc(remote control)模块,所以相关驱动代码目录为 drivers/media/rc/
相关内核文档:
- Documentation/devicetree/bindings/media/gpio-ir-receiver.txt
- Documentation/devicetree/bindings/media/rc.yaml
下面就从红外的接收、发送和编解码协议简单记录下
接收
红外接收的处理有很多种方式,有些soc有专门的硬件模块,有些使用的是通用的gpio,这里以常见的gpio为例,其他的都大同小异。
用通用的GPIO来接收红外原理比较简单,代码实现主要在:
- drivers/media/rc/gpio-ir-recv.c
- drivers/media/rc/rc-main.c
- drivers/media/rc/rc-ir-raw.c
主要流程
probe函数:
--> devm_rc_register_device 注册rc设备
--> devm_request_irq 申请gpio中断(上升沿和下降沿)
中断处理函数 gpio_ir_recv_irq:
--> gpiod_get_value 获取gpio状态
--> ir_raw_event_store_edge 保存边沿事件数据
重点的是这里的 devm_rc_register_device() 和 ir_raw_event_store_edge() 函数,下面分开具体来看
devm_rc_register_device()函数
devm_rc_register_device
-> rc_register_device
-> ir_raw_event_prepare
-> timer_setup ir_raw_edge_handle: 设置一个定时器
-> INIT_KFIFO: 初始化一个fifo,用来保存ir数据
-> rc_prepare_rx_device: rc_map,keymap相关处理
-> lirc_register: 注册lirc,后面转发keycodes数据给用户空间
-> rc_setup_rx_device: 注册input设备
-> ir_raw_event_register
-> kthread_run ir_raw_event_thread: 运行一个内核线程,
-> kfifo_out: 从上面fifo里拿数据
-> decode: 根据协议解码数据
-> lirc_raw_event: 通过 lirc 转发到用户空间
注:
- LIRC(Linux Infrared Remote Control), 主要提供与核外的交互接口,核外有一个对应的开源软件包,这里对 lirc 就不展开了
- 关于keymap协议相关处理
- 关于decode解码在后面的部分专门来说明
ir_raw_event_store_edge()函数
ir_raw_event_store_edge: 保存这次的电平pulse及上次边沿到这次边沿的时长duration
-> ir_raw_event_store_with_timeout:
-> ktime_get: 保存这次的时间,为last_event
-> ir_raw_event_store
-> kfifo_put: 保存包含pulse和duration数据(struct ir_raw_event结构)到上面的fifo中
-> timer 设置timeout 默认15ms
定时器回调函数ir_raw_edge_handle()里面的处理:
ir_raw_edge_handle
-> 判断时间间隔,ir_raw_event_store 保存超时事件
-> ir_raw_event_handle
-> wake_up_process(dev->raw->thread) 唤醒处理线程
判断时间间隔说明:
如果从上次边沿触发到这次定时器触发的间隔时间interval大于 dev->timeout[这里gpio的方式默认为 IR_DEFAULT_TIMEOUT(125ms)] 就保存一个超时事件 timeout event,否则修改定时器的超时时间为 dev->timeout - ktime_to_us(interval)
发送
发送是接收的逆过程,红外发送主要有通用gpio、pwm等实现方式,主要代码在:
- drivers/media/rc/gpio-ir-tx.c
- drivers/media/rc/pwm-ir-tx.c
- drivers/media/rc/rc-ir-raw.c
- drivers/media/rc/lirc_dev.c
这里主要记录下常用的pwm方式,原理比较简单:
probe 函数: devm_rc_register_device: 注册rc 设备,重要的代码如下:
rcdev->priv = pwm_ir;
rcdev->driver_name = DRIVER_NAME;
rcdev->device_name = DEVICE_NAME;
rcdev->tx_ir = pwm_ir_tx;
rcdev->s_tx_duty_cycle = pwm_ir_set_duty_cycle;
rcdev->s_tx_carrier = pwm_ir_set_carrier;
rc = devm_rc_register_device(&pdev->dev, rcdev);
if (rc < 0)
dev_err(&pdev->dev, "failed to register rc device\n");
最主要是下面三个函数:
pwm_ir_tx() 发送最重要的函数,负责控制pwm来发送红外,用户空间通过lirc最后会调用到这里
- pwm_ir_set_duty_cycle(): 设置pwm的占空比
- pwm_ir_set_carrier(): 设置pwm载波的频率,默认的是38000,即38K
- pwm_ir_tx()函数说明
代码如下,
static int pwm_ir_tx(struct rc_dev *dev, unsigned int *txbuf,
unsigned int count)
{
struct pwm_ir *pwm_ir = dev->priv;
struct pwm_device *pwm = pwm_ir->pwm;
int i, duty, period;
ktime_t edge;
long delta;
period = DIV_ROUND_CLOSEST(NSEC_PER_SEC, pwm_ir->carrier);
duty = DIV_ROUND_CLOSEST(pwm_ir->duty_cycle * period, 100);
pwm_config(pwm, duty, period);
edge = ktime_get();
for (i = 0; i < count; i++) {
if (i % 2) // space
pwm_disable(pwm);
else
pwm_enable(pwm);
edge = ktime_add_us(edge, txbuf[i]);
delta = ktime_us_delta(edge, ktime_get());
if (delta > 0)
usleep_range(delta, delta + 10);
}
pwm_disable(pwm);
return count;
}
为啥发送这里没有协议编码相关的呢?
上面已经说了,tx_ir函数即这里的pwm_ir_tx()最后会被lirc调用到来发送,所以相关协议编码主要在lirc代码里,即lirc_transmit()里的ir_raw_encode_scancode()函数,调用流程如下:
用户空间调用lirc的write函数
-> lirc_transmit()
-> ir_raw_encode_scancode()
-> encode(): 协议编码
-> tx_ir(): 发送函数
-> pwm_ir_tx(): 这里pwm就对应此函数
编解码协议
这里主要记录下最常见最常用的协议之一—NEC协议
NEC协议介绍
NEC协议是众多红外线协议中的一种,以前广泛用在电视机,投影仪设备里,之前的万能电视遥控器就是走的NEC协议
NEC协议的特征:
1.8位地址码和8位命令码长度;
2.单次传输主要分为5部分(不算重复码): 引导码+地址码+地址反码+命令码+命令反码,地址和命令两次传输,提高准确性;
3.停止码主要起隔离作用,一般不进行判断
4.载波频率为38KHz
5.脉冲时间间隔调制
6.位时间为1.125ms和2.25ms,具体见下面说明
NEC码位的定义:一个脉冲对应562.5us的连续载波,一个逻辑1传输需要2.25ms(562.5us脉冲+1687.5us低电平),一个逻辑0的传输需要1.125ms(562.5us脉冲+562.5us低电平)。
而遥控接收头在收到脉冲时为低电平,在没有收到脉冲时为高电平,因此, 我们在接收头端收到的信号为:逻辑1应该是562.5us低+1687.5us高,逻辑0应该是562.5us低+562.5us高。
对于接收方:
- 引导码: 9ms的低电平 + 4.5ms的高电平
- 逻辑0: 562.5us低电平 + 562.5us高电平
- 逻辑1: 562.5us低电平 + 1687.5us高电平
重复码:9ms的低电平 + 2.25ms的高电平
中标题
对于发送方:
如果我们规定1拍是562.5us载波脉冲, 那么:
- 引导码: 16拍的红外发射 + 8拍的空闲
- 逻辑0: 1拍的发射 + 1拍的空闲
- 逻辑1: 1拍的发射 + 3拍的空闲
- 重复码:16拍的红外发射 + 4拍的空闲
结束码:1拍的发射
NEC相关代码
内核中nec协议相关的源码实现在: drivers/media/rc/ir-nec-decoder.c
主要提供上面接收和发送时编解码相关的接口和参数,如decode, encode函数,carrier参数等
static struct ir_raw_handler nec_handler = {
.protocols = RC_PROTO_BIT_NEC | RC_PROTO_BIT_NECX |
RC_PROTO_BIT_NEC32,
.decode = ir_nec_decode,
.encode = ir_nec_encode,
.carrier = 38000,
.min_timeout = NEC_TRAILER_SPACE,
};
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。