头图

Linux之IR驱动

背景

在光谱中波长自760nm至400um的电磁波称为红外线,它是一种不可见光。红外遥控成本很低,以前广泛应用在电视,空调等电器的控制上面,现在随着蓝牙遥控器慢慢普及,红外遥控越来越少,但在某些场景,还保留着红外通信
image.png
红外属于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拍的发射
    image.png

    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,
};

相见
6 声望4 粉丝