DM9000A 网卡在 VxWorks 下的 END 驱动开发与避坑指南

简介这份资源面向从事嵌入式网络驱动开发的工程师与学习者聚焦DM9000A以太网控制器在VxWorks实时操作系统下的驱动实现帮助读者理解硬件寄存器操作、内核驱动结构与中断处理机制。压缩包共2个文件包含1个c源码与1个txt说明文档整体约18KB源码对应驱动核心逻辑说明文档则提供使用与结构参考便于快速定位关键实现。已有139人学习下载适合作为驱动移植与调试的对照材料。读者可从中获取初始化配置、数据收发流程、中断服务例程设计等具体实现思路结合DM9000A内部RAM缓冲与全双工、半双工及自动协商特性理解如何在内核态完成高效稳定的网络通信对提升VxWorks平台驱动开发能力具有实际参考价值。1. DM9000A 网卡在 VxWorks 下的驱动到底难在哪手上有一块 DM9000A 网卡板子跑的是 VxWorks网口就是起不来——这个场景做嵌入式网络的人多半都遇到过。DM9000A 是 DAVICOM 的一颗单芯片快速以太网控制器8/16 位主机接口SRAM 内置成本低、外围简单在国产化小板子和工业控制板上用得非常多。VxWorks 这边网络协议栈是 Wind River 自己的一套网卡驱动要挂到 MUXMultiplexer层下面跟 Linux 的 net_device 完全不是一个套路。所以标题里这个 DM9000A-VxWorks-driver 组合本质上是把一颗通用以太网芯片接到 VxWorks 的 ENDEnhanced Network Driver框架上让协议栈能收发帧。适合谁看手上有 DM9000A 硬件、跑 VxWorks 6.x 或 7、需要自己写或改网卡驱动的一线工程师。难点不在芯片本身而在 VxWorks 的驱动注册流程、缓存一致性、中断挂接和 BSP 集成这几处下面一层层拆。2. 先搞懂 VxWorks END 模型和 DM9000A 的寄存器映射2.1 为什么 DM9000A 驱动必须走 END 而不是 BSD 驱动VxWorks 的网络驱动有两代模型。老的是 BSD 驱动直接对接 BSD 协议栈接口是if_attach那一套新的是 END 驱动通过 MUX 层和协议栈解耦驱动只负责收发帧协议栈通过muxBind把 END 挂上去。VxWorks 6.x 之后默认走 END因为 END 把驱动和协议栈的耦合拆开了一个驱动能同时服务 IPv4、IPv6、甚至自定义协议。DM9000A 这种芯片寄存器操作简单收发描述符也不复杂用 END 模型是最省事的。核心要实现三个东西END_OBJ结构体、netFuncTable里的收发回调、以及中断服务程序。MUX 层调用你的endStart时你要把网卡初始化好、把接收中断打开调用endSend时你要把 mbuf 链里的数据搬到芯片 FIFO 发出去。常见做法是拿 Wind River 自带的templateEnd.c当骨架把里面跟具体芯片相关的部分替换成 DM9000A 的寄存器读写。别从零写END 的回调签名和状态机很容易漏。2.2 DM9000A 的寄存器窗口和访问时序DM9000A 只有两个外部可见地址INDEX 口和 DATA 口。所有内部寄存器通过先写 INDEX、再读写 DATA 来访问。16 位模式下INDEX 口地址偏移 0DATA 口偏移 4地址线 A2 决定。这个映射必须在 BSP 里配好否则你读出来的全是 0xFF。关键寄存器寄存器地址作用典型值NCR0x00网络控制复位时写 0x01正常 0x00NSR0x01网络状态读 bit2 判断 linkTCR0x02发送控制0x00 默认RCR0x05接收控制0x31 开广播多播promiscuous 视需求ISR0xFE中断状态写 1 清对应位IMR0xFF中断屏蔽0x81 开接收发送中断PAR0x10-0x15MAC 地址从 BSP 或 EEPROM 读FCTR0x0AFIFO 控制0x38 或 0x39RTFCR0x09收发 FIFO 控制0x00访问代码长这样/* DM9000A 寄存器读写base 是 BSP 映射的基地址 */ #define DM9000_INDEX(base) (*(volatile UINT8 *)(base)) #define DM9000_DATA(base) (*(volatile UINT16 *)((base) 4)) static void dm9000_reg_write(UINT32 base, UINT8 reg, UINT16 val) { DM9000_INDEX(base) reg; /* 先写索引 */ DM9000_DATA(base) val; /* 再写数据 */ } static UINT16 dm9000_reg_read(UINT32 base, UINT8 reg) { DM9000_INDEX(base) reg; return DM9000_DATA(base); }逻辑说明DM9000A 的 INDEX/DATA 双口结构决定了每次访问都要先设索引。参数base是 BSP 里sysPhysMemDesc映射后的虚拟地址不是物理地址。volatile必须加否则编译器优化会把连续两次寄存器访问合并读出来就是错的。DATA 口按 16 位访问如果你的板子接的是 8 位模式这里要改成UINT8并且 SRAM 读写要分两次拼。2.3 中断号和 BSP 里的挂接点DM9000A 的中断输出接到 CPU 的哪个 GPIO 或外部中断线这由硬件决定。BSP 里要做两件事一是在sysIntEnable之前把中断向量挂上二是把中断号告诉驱动。VxWorks 里用intConnect挂 ISR/* 在 endStart 里挂中断intVec 从 BSP 配置或 hwconf.c 里取 */ if (intConnect(INUM_TO_IVEC(intVec), dm9000_isr, (int)pDrvCtrl) ! OK) { return ERROR; } sysIntEnable(intVec); /* 使能该中断线 */参数说明intVec是中断向量号不是中断号VxWorks 里用INUM_TO_IVEC转换。pDrvCtrl是驱动控制块指针ISR 里要靠它找到寄存器基地址和 END_OBJ。sysIntEnable在中断控制器层面放行漏了这一步 ISR 永远不触发这是新手最常翻车的地方。3. 从零把 DM9000A 驱动挂到 VxWorks 协议栈3.1 驱动控制块和 END_OBJ 的初始化顺序END 驱动的入口是dm9000EndLoadMUX 层调用它时传入END_OBJ指针。你要在这个函数里分配驱动控制块、填netFuncTable、调muxBind。顺序不能乱typedef struct dm9000_drv_ctrl { END_OBJ endObj; /* 必须放第一个MUX 靠它回调 */ UINT32 base; /* 寄存器基地址 */ UINT8 mac[6]; /* MAC 地址 */ int intVec; /* 中断向量 */ M_BLK_ID rxMblk; /* 接收缓冲 */ BOOL started; /* 是否已 start */ } DM9000_DRV_CTRL; LOCAL NET_FUNCS dm9000NetFuncs { (FUNCPTR)dm9000EndStart, (FUNCPTR)dm9000EndStop, (FUNCPTR)dm9000EndSend, (FUNCPTR)dm9000EndMCastAddrAdd, (FUNCPTR)dm9000EndMCastAddrDel, (FUNCPTR)dm9000EndMCastAddrGet, (FUNCPTR)dm9000EndPollSend, (FUNCPTR)dm9000EndPollReceive, (FUNCPTR)dm9000EndIoctl, (FUNCPTR)endEtherAddressForm, (FUNCPTR)endEtherPacketDataGet, (FUNCPTR)endEtherPacketAddrGet }; int dm9000EndLoad(char *initStr, int unit, END_OBJ *pEnd) { DM9000_DRV_CTRL *pDrvCtrl; pDrvCtrl (DM9000_DRV_CTRL *)calloc(1, sizeof(DM9000_DRV_CTRL)); if (!pDrvCtrl) return ERROR; pDrvCtrl-base DM9000_BASE_ADDR; /* BSP 里定义 */ pDrvCtrl-intVec DM9000_INT_VEC; /* 读 MAC优先从 EEPROM失败则用 BSP 默认值 */ dm9000_read_mac(pDrvCtrl); /* 初始化 END_OBJ挂 netFuncs */ if (endObjInit(pEnd, dm9000NetFuncs, (void *)pDrvCtrl) ! OK) { free(pDrvCtrl); return ERROR; } /* 绑定到 MUX协议类型用 ETHERTYPE 全收 */ if (muxBind(dm9000, unit, MUX_PROTO_ANY, pEnd, dm9000EndLoad, NULL) NULL) { return ERROR; } return OK; }逻辑说明END_OBJ必须是控制块的第一个成员因为 MUX 层拿到END_OBJ指针后会直接强转回你的控制块偏移错了整个驱动就崩。endObjInit把netFuncs挂上之后 MUX 调endStart才会走到你的函数。muxBind的协议类型用MUX_PROTO_ANY表示接收所有以太类型如果只跑 IP 可以收窄到ETHERTYPE_IP但调试阶段建议全收方便抓包。3.2 endStart 里初始化芯片并开中断endStart是 MUX 层在协议栈起来后调用的这里做芯片上电初始化、清中断、开接收LOCAL int dm9000EndStart(END_OBJ *pEnd) { DM9000_DRV_CTRL *pDrvCtrl (DM9000_DRV_CTRL *)pEnd-pDrvCtrl; UINT32 base pDrvCtrl-base; /* 软复位等复位完成 */ dm9000_reg_write(base, 0x00, 0x01); taskDelay(1); /* 至少等 1 tickDM9000A 复位需要时间 */ dm9000_reg_write(base, 0x00, 0x00); /* 写 MAC 地址到 PAR */ for (int i 0; i 6; i) dm9000_reg_write(base, 0x10 i, pDrvCtrl-mac[i]); /* 清所有中断状态 */ dm9000_reg_write(base, 0xFE, 0xFF); /* 开接收中断和发送中断 */ dm9000_reg_write(base, 0xFF, 0x81); /* 接收控制开广播、多播、单播 */ dm9000_reg_write(base, 0x05, 0x31); /* 使能接收 */ dm9000_reg_write(base, 0x01, 0x01); /* 挂 ISR 并使能中断线 */ if (intConnect(INUM_TO_IVEC(pDrvCtrl-intVec), dm9000_isr, (int)pDrvCtrl) ! OK) return ERROR; sysIntEnable(pDrvCtrl-intVec); pDrvCtrl-started TRUE; /* 通知 MUX 链路状态 */ endLinkUp(pEnd); return OK; }参数说明0x00寄存器写0x01是软复位写完必须延时DM9000A 数据手册要求复位后等至少 20usVxWorks 里taskDelay(1)是一个 tick通常够。0xFF写0x81是开接收和发送中断bit0 是接收bit1 是发送bit7 是 link change。0x05写0x31是 RCRbit0 开接收bit4 开广播bit5 开多播。endLinkUp通知 MUX 链路通了协议栈才会开始发 ARP。3.3 中断服务程序里怎么区分收发DM9000A 的 ISR 寄存器0xFE会告诉你中断来源读出来判断LOCAL void dm9000_isr(int arg) { DM9000_DRV_CTRL *pDrvCtrl (DM9000_DRV_CTRL *)arg; UINT32 base pDrvCtrl-base; UINT8 isr; /* 读中断状态读操作本身会清部分位 */ isr dm9000_reg_read(base, 0xFE); /* 写回清中断DM9000A 是写 1 清零 */ dm9000_reg_write(base, 0xFE, isr); if (isr 0x01) { /* 接收中断 */ dm9000_receive(pDrvCtrl); } if (isr 0x02) { /* 发送完成 */ /* 发送完成可以唤醒等待的发送队列 */ pDrvCtrl-txBusy FALSE; } if (isr 0x80) { /* link change */ UINT8 nsr dm9000_reg_read(base, 0x01); if (nsr 0x04) endLinkUp(pDrvCtrl-endObj); else endLinkDown(pDrvCtrl-endObj, 0); } }逻辑说明DM9000A 的中断状态寄存器是写 1 清零读出来之后要立刻写回否则中断会一直触发。接收中断里调dm9000_receive把 FIFO 里的帧读出来封装成 mbuf 后调netJobAdd或者直接endRx交给 MUX。发送完成中断里清txBusy标志让endSend能继续发下一帧。link change 中断里读 NSR 的 bit2 判断链路状态调endLinkUp或endLinkDown通知协议栈。3.4 endSend 里把 mbuf 搬到芯片 FIFO发送路径相对简单DM9000A 的发送 FIFO 寄存器是 0xF8写数据前先写发送长度LOCAL int dm9000EndSend(END_OBJ *pEnd, M_BLK_ID pMblk) { DM9000_DRV_CTRL *pDrvCtrl (DM9000_DRV_CTRL *)pEnd-pDrvCtrl; UINT32 base pDrvCtrl-base; UINT16 len pMblk-mBlkHdr.mLen; UINT8 *pData mtod(pMblk, UINT8 *); if (!pDrvCtrl-started) return ERROR; if (len 64) len 64; /* 以太网最小帧 64 字节 */ /* 等上一次发送完成 */ while (dm9000_reg_read(base, 0xFE) 0x02) ; /* 写发送长度低字节在前 */ dm9000_reg_write(base, 0xFC, len 0xFF); dm9000_reg_write(base, 0xFD, (len 8) 0xFF); /* 把数据写进发送 FIFO */ for (UINT16 i 0; i len; i) dm9000_reg_write(base, 0xF8, pData[i]); /* 启动发送 */ dm9000_reg_write(base, 0x02, 0x01); return OK; }参数说明0xFC和0xFD是发送长度低/高字节寄存器必须先写长度再写数据。0xF8是发送 FIFO 写口每次写 16 位如果数据长度是奇数最后一个字节要补 0。0x02寄存器写0x01是启动发送芯片会自动加前导码和 CRC。mtod是 VxWorks 的宏把 mbuf 转成线性指针如果 mbuf 是链式的要先mblkChainDup或者用mblkGet拉平。4. 缓存一致性和 mbuf 管理这两个坑最容易翻车4.1 接收路径上的 cache invalidate 时机VxWorks 在 ARM 或 PowerPC 上跑的时候DMA 和 CPU 之间的缓存一致性是血泪经验重灾区。DM9000A 的接收 FIFO 是芯片内部 SRAMCPU 通过总线读不涉及 DMA 写内存所以接收路径上不需要 invalidate。但如果你用的是外部 SRAM 做接收缓冲或者芯片配置成 DMA 模式那就必须在读之前 invalidate 对应缓存行。常见做法是在dm9000_receive里读 FIFO 之前调cacheInvalidate读完之后调cacheFlush。但 DM9000A 的 FIFO 读是同步的CPU 读的时候芯片已经把数据推上总线了所以大多数 BSP 里接收路径不加 cache 操作。发送路径同理数据是从内存写到芯片 FIFO芯片不反向写内存所以也不需要 flush。真正需要小心的是 mbuf 本身的内存属性如果 mbuf 是从 cacheable 内存池分配的而你又用 DMA 方式搬数据那就必须处理。4.2 mbuf 分配失败时的后悔药接收中断里要分配 mbuf 来装帧如果内存池空了netMblkClGet会返回 NULL。这时候不能直接丢帧也不能死等正确做法是M_BLK_ID pMblk netMblkClGet(1, 0, NULL); if (pMblk NULL) { /* 内存池空记录统计丢弃当前帧 */ pDrvCtrl-rxDropped; /* 把 FIFO 里的数据读出来丢掉否则 FIFO 会满 */ dm9000_drain_rx_fifo(pDrvCtrl); return; }逻辑说明netMblkClGet从 VxWorks 的网络内存池拿一个 mbuf 加 cluster第二个参数是 cluster 大小0 表示用默认值。返回 NULL 说明池子空了这时候必须把芯片 FIFO 里的数据读出来丢掉否则 FIFO 满之后后续帧全丢而且芯片可能进入错误状态。rxDropped计数器在endIoctl里通过EIOCGSTATS暴露给上层调试时用ifShow能看到。4.3 中断里不能做的事netJobAdd 的正确用法VxWorks 的 ISR 运行在中断上下文不能调可能阻塞的函数比如taskDelay、semTake带超时、malloc。接收路径里如果要做复杂处理应该用netJobAdd把工作推到网络任务里/* ISR 里只做最少的活把 mbuf 挂到队列推给网络任务 */ if (isr 0x01) { M_BLK_ID pMblk dm9000_read_frame(pDrvCtrl); if (pMblk) { /* netJobAdd 把 endRx 调用推到网络任务上下文 */ netJobAdd((FUNCPTR)endRx, (int)pDrvCtrl-endObj, (int)pMblk, 0, 0, 0); } }参数说明netJobAdd的第一个参数是函数指针后面最多五个整型参数。endRx是 MUX 提供的接收入口签名是(END_OBJ *, M_BLK_ID, ...)。把endRx推到网络任务里执行ISR 就能快速返回不会因为协议栈处理慢而丢中断。注意netJobAdd本身是非阻塞的但如果 job 队列满了会返回 ERROR这时候要丢帧并计数。5. 避坑与排查DM9000A 驱动起不来的五个典型现象5.1 现象ifShow 看不到网口muxBind 返回 NULL原因muxBind的协议类型或者 unit 号跟 BSP 里configNet.h的配置对不上。VxWorks 启动时根据configNet.h里的END_TBL_ENTRY数组加载驱动如果muxBind里的名字跟表里的不一致绑定就失败。解决检查configNet.h里END_TBL_ENTRY的endLoadFunc是不是指向你的dm9000EndLoadendLoadString里的 unit 号是不是跟muxBind的 unit 一致。常见做法是在usrNetworkInit之前打印一下endFindByName的返回值确认驱动挂上了。5.2 现象网口能 up但 ping 不通收不到任何帧原因接收控制寄存器 RCR 没配对或者中断没使能。DM9000A 的 RCR 默认值是 0x00接收关闭。如果endStart里漏了写 RCR芯片根本不收帧。解决在endStart里确认dm9000_reg_write(base, 0x05, 0x31)执行了。用示波器量中断线看有没有接收中断。如果中断线一直高说明 ISR 没清中断检查0xFE寄存器是不是写 1 清零了。5.3 现象发送几帧后卡死txBusy 一直为 TRUE原因发送完成中断没触发或者 ISR 里没清发送中断标志。DM9000A 的发送完成中断是 bit1如果 ISR 里只处理了接收没处理发送txBusy永远不会清。解决在 ISR 里加发送完成处理读0xFE判断 bit1写回清零。另外检查0x02寄存器的 bit1 是不是被意外置位DM9000A 发送完成后 bit1 会自动清但如果发送出错bit1 会保持需要在 ISR 里手动清。5.4 现象MAC 地址全是 0 或全是 FF原因EEPROM 读失败或者 PAR 寄存器写反了字节序。DM9000A 的 MAC 地址存在 EEPROM 里上电自动加载到 PAR但如果 EEPROM 是空的或者 I2C 时序不对PAR 就是 0。另外 PAR 寄存器是 6 个 8 位寄存器写的时候字节顺序要对。解决在dm9000_read_mac里先读 PAR如果是全 0 或全 FF就用 BSP 里定义的默认 MAC。写 PAR 的时候按0x10到0x15顺序写每个寄存器写一个字节不要写成 16 位。5.5 现象大包丢帧小包正常原因接收 FIFO 溢出或者 mbuf cluster 太小。DM9000A 的接收 FIFO 是 16KB如果中断处理太慢FIFO 满了就丢帧。另外 VxWorks 默认的 mbuf cluster 是 128 或 256 字节大包需要多个 cluster 链起来如果netMblkClGet的 cluster 大小设小了大包会分配失败。解决在configNet.h里把NUM_RX_MBUFS和 cluster 大小调大常见做法是 cluster 设 2048mbuf 数量设 64 以上。另外在 ISR 里尽快把 FIFO 读空不要做耗时操作用netJobAdd把处理推到网络任务。6. 用 ifShow 和寄存器 dump 验证驱动是否真的通了驱动写完烧进去别急着跑应用先用 VxWorks 自带的工具验证。ifShow是最直接的能看到网口状态、收发包计数、错误计数。如果ifShow里rxPackets和txPackets都在涨说明驱动基本通了。如果rxErrors或txErrors在涨对照上面的避坑章节查。寄存器 dump 是更细的验证手段。在 target shell 里写个小函数把 DM9000A 的关键寄存器读出来打印void dm9000Dump(UINT32 base) { printf(NCR0x%02X NSR0x%02X ISR0x%02X IMR0x%02X\n, dm9000_reg_read(base, 0x00), dm9000_reg_read(base, 0x01), dm9000_reg_read(base, 0xFE), dm9000_reg_read(base, 0xFF)); printf(RCR0x%02X TCR0x%02X FCTR0x%02X\n, dm9000_reg_read(base, 0x05), dm9000_reg_read(base, 0x02), dm9000_reg_read(base, 0x0A)); printf(MAC%02X:%02X:%02X:%02X:%02X:%02X\n, dm9000_reg_read(base, 0x10) 0xFF, dm9000_reg_read(base, 0x11) 0xFF, dm9000_reg_read(base, 0x12) 0xFF, dm9000_reg_read(base, 0x13) 0xFF, dm9000_reg_read(base, 0x14) 0xFF, dm9000_reg_read(base, 0x15) 0xFF); }逻辑说明NCR正常应该是 0x00如果 bit0 是 1 说明芯片还在复位。NSR的 bit2 是 link 状态1 表示链路通。ISR读出来应该是 0x00如果有非零位说明中断没清干净。IMR应该是 0x81如果被意外改了中断就不触发。RCR应该是 0x31TCR应该是 0x00。MAC 地址打印出来跟板子标签对一下不对就查 EEPROM。我自己的习惯是每次改完驱动先跑dm9000Dump确认寄存器状态对了再跑ping。寄存器不对的时候 ping 是玄学时通时不通查起来更费劲。另外ifShow里的collisions和deferrals计数如果一直涨说明双工模式没配对DM9000A 默认是半双工要全双工得在endStart里写0x00寄存器的 bit3。这个坑我踩过板子跟交换机协商成半双工大流量下丢包严重查了两天才发现是双工模式的问题。希望帮到你。本文还有配套的精品资源点击获取