简介TCA6416A是一款通过I2C接口扩展16位GPIO的芯片常用于嵌入式系统中按键扫描、LED控制等场景。该资源面向单片机驱动开发或Linux底层驱动调试人员提供可直接移植的C语言驱动源码包含寄存器配置、输出控制、极性设置及初始化等核心接口。资源共2个文件1个h头文件负责寄存器地址与函数声明1个c源文件实现具体读写逻辑压缩包仅2KB结构精简适合快速集成到现有工程。已有387人学习下载可作为I2C从设备驱动编写的入门参考。通过阅读源码开发者可以掌握TCA6416A寄存器配置流程、I2C读写时序的组织方式并在此基础上扩展适配不同主控平台减少重复造轮子的时间。1. TCA6416A 驱动这份 rar能直接跑吗坑在哪TCA6416A 驱动这份 rar很多人是奔着“解压就能用”去下载的但真正的坑不在驱动代码里而在芯片的默认状态上。这颗 16 位 I2C GPIO 扩展芯片解决的是主控引脚不够用的问题适合嵌入式驱动开发、硬件调试、产品原型验证这三类场景。我拆过好几套同类资源结论一致寄存器表背熟、时序写对、避坑清单随身带一两个小时就能跑起来反过来光看代码不动手连调最容易在 I2C 地址和方向配置上翻车。这篇从拆包讲到移植把能省的弯路一次省掉。2. 拆开资源包寄存器地图与驱动骨架先对清 8 个寄存器拿到 TCA6416A.rar 之后我习惯先把文件清单和芯片手册对照一遍。这份资源里的驱动源码、平台配置、测试程序基本都齐但真正决定能不能跑起来的是你对这颗芯片寄存器的理解程度。2.1 先背熟这张寄存器表8 个寄存器决定一切TCA6416A 这类 I2C GPIO 扩展芯片本质就是一个挂在 I2C 总线上的寄存器组。CPU 通过 I2C 写寄存器让它输出电平读寄存器拿到外部输入状态。整颗芯片只有 8 个寄存器地址从 0x00 排到 0x07踩坑基本都在这 8 个地址上。寄存器地址名称读写属性作用0x00Input Port 0只读读回 P0~P7 当前输入电平0x01Input Port 1只读读回 P10~P17 当前输入电平0x02Output Port 0读写设置 P0~P7 输出电平写 1 拉高0x03Output Port 1读写设置 P10~P17 输出电平0x04Polarity Inversion 0读写输入极性翻转对应位写 1 则读回值取反0x05Polarity Inversion 1读写P10~P17 极性翻转开关0x06Configuration 0读写方向控制某位写 0输出写 1输入0x07Configuration 1读写P10~P17 方向控制第一要记住的是 0x06/0x07 和 0x02/0x03 的关系。很多人以为写了 Output Port 就能让引脚输出但芯片上电后 Configuration 默认是 0xFF也就是所有引脚都是高阻输入态Output 寄存器里写什么都不会真正送到引脚上。所以驱动初始化第一步永远是先配方向这一步漏了后面全是白调。第二要记住 Input Port 和 Output Port 虽然都叫 Port语义完全不同。读 0x02 拿到的只是输出锁存器里的值不是引脚上实际的电平想知道外部把某个引脚拉高还是拉低必须读 0x00/0x01。如果同一颗芯片的引脚同时被外部信号和输出寄存器驱动只有读 0x00 才能看到真实电平这是排查“写了没反应”和“读了不对”的分界线。2.2 解压后先找这三个文件驱动核心、平台头文件、测试程序这份 rar 解开后是一套内核态 I2C client 驱动加一个用户态测试程序。我看包的习惯是先把文件清单过一遍重点找三个文件tca6416a_core.c、tca6416a_platform.h、test_tca6416a.c。文件作用必读原因tca6416a_core.c驱动主文件包含 probe、I2C 读写、GPIO 操作函数读写时序和寄存器操作都在这tca6416a_platform.h平台配置头文件地址、总线号、方向掩码、中断引脚test_tca6416a.c用户态测试程序移植前先在命令行验证寄存器操作Makefile 或编译脚本编译配置确认要用的内核版本和头文件路径如果包里没有 test 文件建议自己补一个后面第 5 章的 i2cget/i2cset 也能干同样的事。拿到代码我先看 tca6416a_core.c 里的 probe 函数一个驱动写得好不好probe 里三件事一眼就能看出来有没有先读 Configuration、有没有把中断请求线程化、有没有把寄存器读写的错误码透传出来。2.3 设备树里挂接reg 写 0x20 不是 0x40在 I2C 总线上设备树里的 reg 属性填的是 7 位从地址不是 8 位写地址。TCA6416A 的地址引脚 A0/A1/A2 全接地时7 位从地址是 0x20内核在总线上发送时自动左移一位变成 0x40。这是标准做法但也是移植时最容易写错的地方。i2c1 { tca6416a: tca6416a20 { compatible tca6416a-gpio; reg 0x20; gpio-controller; #gpio-cells 2; interrupt-parent gpio_ext; interrupts 7 IRQ_TYPE_EDGE_FALLING; }; };compatible 字符串必须和驱动里 i2c_driver.id_table 写的完全一致否则 probe 不会被执行。interrupts 里的 7 是接到主控的外部中断号IRQ_TYPE_EDGE_FALLING 对应 INT# 引脚下降沿触发因为芯片中断输出是低电平有效事件发生时从高拉低。如果这里写了 IRQ_TYPE_LEVEL_LOW也可以工作但需要注意中断处理函数里必须清掉中断条件否则会一直被拉低这个细节在第 4 章展开。3. 读写时序逐个过probe 初始化、读输入、写输出的参数细节很多移植失败不是看不懂代码而是没理解 I2C 读写时序本身。TCA6416A 的寄存器操作看着简单但读和写的事务结构完全不同写输出还有一个“一次传三字节”的习惯做法。3.1 probe 里第一件事把 Configuration 写成你要的方向上电默认全输入这是芯片的设计不是 Bug。所以 probe 里第一步就是根据平台配置写 0x06/0x07注意不要写死成 0x00因为板子上可能部分引脚要做输入用掩码最稳。#include linux/i2c.h #include tca6416a_platform.h static int tca6416a_write_reg(struct i2c_client *client, u8 reg, u8 val) { u8 buf[2] { reg, val }; struct i2c_msg msg { .addr client-addr, .flags 0, /* 0 表示写事务 */ .len 2, /* 第 1 字节是寄存器地址第 2 字节是数据 */ .buf buf, }; int ret i2c_transfer(client-adapter, msg, 1); return (ret 1) ? 0 : -EIO; } static int tca6416a_probe(struct i2c_client *client) { int ret; /* 按平台头文件里的掩码初始化方向0 输出1 输入 */ ret tca6416a_write_reg(client, 0x06, TCA6416A_CFG_P0); if (ret) return ret; ret tca6416a_write_reg(client, 0x07, TCA6416A_CFG_P1); if (ret) return ret; return 0; }逻辑说明这个函数把“寄存器地址 一个数据字节”打包成一个 2 字节的写事务。i2c_transfer 返回的是成功传输的消息数所以返回值要跟 1 比较而不是跟 0 比较。很多新手写成 if (ret 0)把“传了 0 条消息”也当成功结果寄存器根本没写进去。参数说明TCA6416A_CFG_P0 是 0x00~0xFF 的掩码。比如要 P0~P3 输出、P4~P7 输入就写成 0xF0要全部输出就是 0x00全部输入就是 0xFF。高字节同理。这个掩码不要放在驱动核心文件里写死应该留在平台头文件里换板子只改头文件。3.2 读输入端口先写寄存器地址再重复起始位读数据GPIO 扩展芯片不像 EEPROM 那样能用“只读地址”直接读必须先告诉芯片要读哪个寄存器然后才能把数据读回来。这两步必须放在同一个事务里完成。拆成两次 I2C 事务会引入 STOP 和 START虽然大多数情况下也能读到但总线中间插了别的设备操作就可能错位。static int tca6416a_read_port(struct i2c_client *client, u8 reg, u8 *val) { struct i2c_msg msgs[2]; int ret; msgs[0].addr client-addr; msgs[0].flags 0; /* 第一段写寄存器地址 */ msgs[0].len 1; msgs[0].buf reg; msgs[1].addr client-addr; msgs[1].flags I2C_M_RD; /* 第二段读数据自动插入重复起始位 */ msgs[1].len 1; msgs[1].buf val; ret i2c_transfer(client-adapter, msgs, 2); return (ret 2) ? 0 : -EIO; }说明内核 I2C 子系统看到第一个 message 是写、第二个是读并且地址相同就会在中间插入 REPEATED START而不是 STOP。这一点不需要你手动控制但必须理解否则用 i2cget 一条条敲命令调试没问题一写成驱动就怀疑人生。如果要一次读回两个输入端口把 msgs[1].buffer 换成长度 2 的数组设置 len 2 即可。芯片支持自动地址递增读 0x00 时连续读 2 个字节第二个字节就是 0x01 的内容。3.3 写输出端口一次写三字节别拆成两次TCA6416A 的寄存器地址会自动递增连续写时地址指针自动跳到下一个寄存器。写 16 路输出时从 0x02 开始连续写三个字节是最稳的做法。static int tca6416a_write_outputs(struct i2c_client *client, u16 val) { u8 buf[3] { 0x02, val 0xFF, (val 8) 0xFF }; struct i2c_msg msg { .addr client-addr, .flags 0, .len 3, .buf buf, }; return (i2c_transfer(client-adapter, msg, 1) 1) ? 0 : -EIO; }逻辑说明buf[0] 是起始寄存器地址buf[1] 写给 Output Port 0buf[2] 因为地址自动递增落到 Output Port 1。一次事务写完两个字节避免中间被其他线程或中断打断造成高低字节不一致。如果业务只需要操作某一位比如只翻 P3也建议读回当前输出值、改位、再整口写回。TCA6416A 同一字节的 8 个引脚共享一个寄存器任何一位的更新都会把整个字节覆盖式写进去读-改-写必须基于 Output Port 寄存器而不是 Input Port。多线程场景下这个读-改-写序列要用互斥锁保护否则两个线程同时读回同一个旧值再写回后写的会把先写的位变化覆盖掉。4. 避坑手册五个翻车现场每个都有原因和后悔药这份资源我前后给三个板子移植过遇到的问题高度集中。下面五条是出现频率最高的每一条都有现场、有原因、有解法。4.1 i2cdetect 扫不到 0x207 位地址和 8 位地址搞混现象i2cdetect -y 1 扫总线TCA6416A 的 0x20 位置是空的0x40 也没有其他设备正常。原因最常见是设备树 reg 里写了 0x40。内核把 reg 当作 7 位地址直接左移一位放总线0x40 左移变成 0x80从机当然不应答。另一个常见原因是地址引脚虚焊从地址变成某个悬空值或者干脆不定。解决先量 A0/A1/A2 的静态电平按公式 0x20 | (A2 2) | (A1 1) | A0 算一次然后单独扫这个地址i2cdetect -y -r 1 0x20 0x20。如果还是空重点检查 SCL/SDA 上拉电阻4.7k 到 10k 都行但不能没有。这块板子当初就是漏了上拉总线一直低电平所有 I2C 设备都探不到。4.2 写 0x55 读回全是 0方向寄存器还是输入现象i2cset 写 Output Port 0 为 0x55用万用表量引脚全是低电平或高阻读 Input Port 0 全是 0x00。原因Configuration 上电是 0xFF引脚全输入。Output Port 寄存器是写了但它只是锁存器引脚处于输入态时不会驱动外部。解决先把 0x06 写成 0x000x07 写成 0x00再写 0x02/0x03。验证顺序是 i2cset -y 1 0x20 0x06 0x00再 i2cset -y 1 0x20 0x02 0x55最后用万用表量 P0 引脚。注意有些初始化代码会故意保留部分输入不要想当然认为 Configuration 一定是 0x00要读回来确认。4.3 中断只触发一次读输入寄存器清中断被漏掉现象按键按下 INT# 拉低第一次 gpio 中断正常之后再按没反应INT# 一直停留在低电平。原因芯片的中断逻辑是输入电平变化时拉低 INT#读取 Input Port 寄存器后如果引脚电平已经恢复原状态中断条件才被清除。只处理中断但不读输入寄存器中断锁存一直不释放后续变化进不来。解决在中断处理函数里强制读一次 0x00 和 0x01两个端口都读一遍。哪怕应用只需要低字节高字节不读也可能残留旧状态。读的动作就是清中断的标准操作不是可选项。4.4 I2C 总线 hang 死读写切换缺 restart 或 ACK 没查现象驱动跑一会儿整条总线上其他设备也不应答必须复位主控才能恢复。原因用两个独立的 write 和 read 去模拟“写寄存器地址再读数据”中间发了 STOP设备处于半就绪状态或者第二个 message 的 flags 忘了加 I2C_M_RD把读事务发成了写从机收到错误地址后把总线拉死。解决内核驱动里坚持用双 message 的 i2c_transfer让控制器自动处理重复起始。用户态调试时读操作要用 ioctl 的 I2C_RDWR 组合读写不要先 write 再 read 两次调用。另外每个 i2c_transfer 的返回值都要检查出现 -EREMOTEIO 就说明对方回了 NACK越早暴露越好。4.5 掉电重启后配置丢光寄存器不保存状态现象板子断电重启之前配好的输出方向和电平全部回到默认产品上电瞬间引脚乱跳。原因TCA6416A 的寄存器是 RAM 型不是 EEPROM上电即复位成默认值。驱动如果只在开机初始化一次掉电再上电等于回到起点。解决把配置流程放 probe 是最低要求关键是把“复位后恢复”做成对外接口每次系统 resume 时重写 Configuration 和 Output。硬件上如果引脚上电瞬间必须保持特定电平就在外部加下拉或上拉电阻芯片初始化前软件本来也来不及兜底。5. 移植到自己板子地址映射、三个参数、命令行验证资源里的驱动写得再规整拿到自己板子上也要改配置。这一章是移植清单照着过一遍就能跑。5.1 地址引脚 A2/A1/A0 决定从地址先算清楚再接TCA6416A 的三个地址引脚直接决定 I2C 从地址。接高接低不要靠猜按下面这张表对照。A2A1A07 位从地址8 位写地址0000x200x400010x210x420100x220x440110x230x461000x240x481110x270x4E要说明的是8 位写地址是 7 位地址左移一位0x20 左移一位就是 0x40。如果你用逻辑分析仪抓波形看到从机地址是 0x40那就是 7 位 0x20 正常不是设备地址写错。5.2 移植必改的三个参数总线号、地址、方向掩码tca6416a_platform.h 里集中了所有移植参数换板子只改这个文件。我最常动的三处如下#define TCA6416A_I2C_BUS 1 /* 挂在 I2C1 上改成实际总线号 */ #define TCA6416A_I2C_ADDR 0x20 /* 7 位从地址来自地址引脚 */ #define TCA6416A_I2C_RETRIES 3 /* 传输失败重试次数 */ #define TCA6416A_I2C_TIMEOUT_MS 100 /* 单次传输超时 */ #define TCA6416A_INT_GPIO 87 /* 接到主控的哪个 GPIO */ #define TCA6416A_CFG_P0 0xF0 /* P0~P3 输出P4~P7 输入 */ #define TCA6416A_CFG_P1 0x00 /* P10~P17 全部输出 */TCA6416A_I2C_BUS 要和设备树里挂载的 i2c 节点对应也决定了 i2cdetect -y 后面跟的数字。TCA6416A_CFG_P0 这种掩码是方向配置0 表示输出1 表示输入。TCA6416A_INT_GPIO 是主控侧的中断引脚号不能和总线上其他设备的中断共用否则中断风暴会很难看。如果板子对时序敏感可以把总线速率从默认 100k 调到 400k但要先确认线缆长度和上拉电容400k 下长线容易出毛刺。5.3 命令行快速验证i2cget、i2cset 三步测试法驱动还没编译好之前先用命令行验证硬件链路能省下大量调试时间。# 步骤 1扫描总线确认 TCA6416A 出现在 0x20 i2cdetect -y 1 # 步骤 2把 Configuration 0 写成 0x00P0~P7 全部设为输出 i2cset -y 1 0x20 0x06 0x00 # 步骤 3往 Output Port 0 写 0x55量引脚电压 i2cset -y 1 0x20 0x02 0x55 # 步骤 4把 P0~P7 配成输入读回引脚状态 i2cset -y 1 0x20 0x06 0xFF i2cget -y 1 0x20 0x00命令里 -y 1 的 1 是总线号0x20 是 7 位从地址0x06 是寄存器地址0x55 是写入的数据。步骤 3 写完用万用表量 P0、P2、P4、P6 应该是高电平P1、P3、P5、P7 是低电平。步骤 4 里 i2cget 读 0x00 返回的才是真实输入电平不是输出锁存值。这套命令能跑通再编译驱动基本一次过。6. 进阶用中断把 TCA6416A 变成异步事件源别再用轮询资源包里的基础驱动一般是轮询读输入但产品上真正好用的是中断触发。TCA6416A 的 INT# 引脚本来就是为这个设计的。6.1 用线程化中断处理读输入和清中断把中断请求线程化可以在中断上下文里少干活把读寄存器和清中断放到线程里执行。ret request_threaded_irq(chip-irq, NULL, tca6416a_irq_handler, IRQF_TRIGGER_FALLING | IRQF_ONESHOT, tca6416a, chip);IRQF_ONESHOT 保证中断线程执行期间该中断被屏蔽读 Input Port 清完中断条件后自动重新使能。处理函数里读 0x00 和 0x01 两个字节然后上报给上层。6.2 软件去抖这种芯片没有内部滤波TCA6416A 没有内部输入滤波按键、继电器触点直接接上去中断会抖得不像样。常见做法是读到变化后先等 20ms 再确认电平确认变了才上报。static irqreturn_t tca6416a_irq_handler(int irq, void *dev_id) { u16 val; tca6416a_read_port(client, 0x00, val); msleep(20); /* 简单去抖实际项目可用定时器 */ tca6416a_read_port(client, 0x00, val2); if (val ! val2) return IRQ_HANDLED; /* 稳定后上报给输入子系统或业务层 */ return IRQ_HANDLED; }读两次的目的是确认电平稳定第一次读本身也是清中断的动作。如果你的应用对响应时间敏感20ms 可以改成 5ms但要有思想准备抖动会在快速连续触发时漏报。6.3 验收时用逻辑分析仪抓三段波形驱动写完别急着合入抓波形确认三件事。第一段是初始化写 Configuration 时的 SCL 频率和 ACK 位确认地址对、时序对。第二段是读输入时的重复起始位应该看到地址字节后有 RESTART而不是中间出现 STOP。第三段是按键按下时 INT# 拉低、读寄存器后恢复高电平的完整过程。这三段波形没问题基本可以放心量产。从那以后我每次移植 GPIO 扩展芯片都强制走一遍流程量地址引脚、扫 i2cdetect、命令行验证寄存器、逻辑分析仪过时序四步缺一不可。希望帮到你。本文还有配套的精品资源点击获取