简介这份资源面向嵌入式开发与安全应用工程师围绕Microchip ATSHA204加密芯片提供中文手册与STM32F103平台例程demo帮助读者理解密钥存储、数据加密、哈希算法及I2C/SPI通信等安全机制解决芯片选型、集成与调试中的实际问题。压缩包共550个文件约14.95MB以47个h头文件、40个c源文件、30个o目标文件、30个d依赖文件及uvprojx、uvoptx等Keil工程文件为主另含4个pdf手册、9个sample示例、3个s汇编与若干txt说明覆盖从源码到工程配置的完整开发链路。目前已有612人学习下载。手册系统讲解工作原理、技术规格、硬件接口与安全引擎调用方式例程则演示STM32F103与ATSHA204的通信流程和加密功能调用读者可据此快速搭建验证环境、对照移植代码并掌握密钥管理与数据保护思路适合初学者入门与有经验开发者查阅。1. 从一颗被“锁死”的加密芯片说起如果你做过带安全认证的硬件产品大概率遇到过这种场景板子上的主控要和一颗加密芯片做挑战应答结果 I2C 波形看着正常读回来的数据却永远是0x00或者0xFF折腾半天才发现是配置区被锁了、或者从机地址搞错了。ATSHA204 就是这类芯片里最经典的一颗——它负责密钥存储、SHA-256 摘要运算、随机数生成和一次性配置锁定很多方案用它来做配件防伪、耗材认证、设备授权。但它的中文资料一直比较零散数据手册是英文的配置区那一堆 Slot、OTP、DataZone 的概念第一次看基本是懵的。这份资源把 ATSHA204 的中文手册和 STM32 平台的例程 Demo 放在了一起适合两类人一类是刚接手硬件安全认证、需要快速把芯片跑通的嵌入式新手另一类是想在 STM32 工程里集成挑战应答逻辑、做二次开发的熟手。下面我按“这芯片能干什么 → 例程怎么跑起来 → 代码怎么改”的顺序把这份资料拆开讲一遍。2. ATSHA204 核心机制Slot、密钥与挑战应答链路2.1 芯片内部到底存了什么ATSHA204 的内部存储分成几个区理解这几个区是后面写代码的前提。配置区Config Zone存放序列号、各 Slot 的访问权限、以及是否锁定等标志位数据区Data Zone分成 Slot 0 到 Slot 15每个 Slot 可以存密钥、也可以存数据还有一块 OTP 区只能写一次。芯片出厂时配置区是未锁定的你可以按自己的方案写权限一旦执行 Lock 命令配置区就永久锁死改不回来了。这里有个血泪经验很多新手拿到芯片直接跑例程例程里如果带了 Lock 操作跑一次之后芯片就定型了。所以第一次调试我一般会先只跑读序列号、读随机数这类只读命令确认 I2C 通了再动配置区。/* 读取 ATSHA204 序列号只读操作不会改变芯片状态 */ uint8_t atsha204_read_sn(uint8_t *sn) { uint8_t cmd[4] {0x00, 0x00, 0x00, 0x00}; /* 命令包占位 */ uint8_t resp[32]; /* 组包命令字 0x02 是 Read模式 0x80 表示读配置区 */ cmd[0] 0x02; /* Read 命令 */ cmd[1] 0x80; /* 读配置区 */ cmd[2] 0x00; /* 地址低字节 */ cmd[3] 0x00; /* 地址高字节 */ if (atsha204_send_cmd(cmd, 4) ! 0) { return 1; /* I2C 发送失败 */ } if (atsha204_recv_resp(resp, sizeof(resp)) ! 0) { return 2; /* 接收失败 */ } /* 序列号在返回包的第 1~4 字节前面是长度和状态字 */ memcpy(sn, resp[1], 4); return 0; }这段代码里cmd[0]是命令字cmd[1]是模式后两字节是地址。返回包第一个字节是长度第二个字节是状态真正的数据从第三个字节开始。参数改动的关键点在于cmd[1]读配置区用0x80读数据区用0x00读 OTP 区用0x01搞错了就会一直返回错误状态。2.2 挑战应答是怎么算出来的ATSHA204 最核心的用法是挑战应答。主机生成一个随机挑战Challenge发给芯片芯片用内部某个 Slot 里存的密钥对挑战做 SHA-256 运算把结果返回。主机这边用同样的密钥和挑战自己算一遍两边比对一致就说明配件是正品。这个过程里密钥永远不出芯片这是它比“把密钥存在主控 Flash 里”安全的地方。但要注意参与运算的 Slot 必须配置成允许被 Nonce 和 Digest 命令使用否则芯片会拒绝执行。配置区里每个 Slot 有独立的读写权限位这部分在中文手册里对应“Slot 配置”那一节建议对着手册把每个 bit 的含义过一遍。/* 挑战应答主机发挑战芯片返回摘要 */ uint8_t atsha204_challenge(uint8_t *challenge, uint8_t *response) { uint8_t nonce_cmd[20]; uint8_t digest_cmd[4] {0x08, 0x00, 0x00, 0x00}; /* Digest 命令 */ /* 第一步把挑战作为 Nonce 发给芯片 */ nonce_cmd[0] 0x16; /* Nonce 命令 */ nonce_cmd[1] 0x00; /* 模式 0直接传 32 字节 */ memcpy(nonce_cmd[2], challenge, 32); if (atsha204_send_cmd(nonce_cmd, 34) ! 0) return 1; atsha204_delay_ms(5); /* 等芯片内部完成 Nonce 处理 */ /* 第二步发 Digest 命令指定用哪个 Slot 的密钥 */ digest_cmd[2] 0x00; /* Slot 0 */ digest_cmd[3] 0x00; if (atsha204_send_cmd(digest_cmd, 4) ! 0) return 2; /* 返回的 32 字节就是摘要 */ if (atsha204_recv_resp(response, 32) ! 0) return 3; return 0; }nonce_cmd[1]是模式选择0x00表示挑战直接由主机传入0x03表示让芯片自己生成随机数当挑战。digest_cmd[2]和digest_cmd[3]拼起来是 Slot 编号这里用的是 Slot 0。实际项目里密钥通常放在 Slot 0 或 Slot 1具体看你的配置。延时那 5 毫秒不能省芯片内部做 SHA-256 需要时间发太快会读到旧数据。2.3 和 STM32 的对接方式ATSHA204 支持 I2C 和单总线两种接口STM32 例程里用的是 I2C。接线就四根VCC、GND、SDA、SCLSDA 和 SCL 各接一个 4.7K 上拉电阻到 3.3V。从机地址默认是0xC88 位写地址有些封装是0xCA这个在手册的“设备寻址”一节有说明。STM32 这边用标准外设库或者 HAL 库的 I2C 都行例程里一般会封装一层atsha204_i2c_read/write把底层收发和芯片的时序要求隔离开。芯片对时序有一定要求比如命令之间要有tWW等待时间连续发命令太快会失败。这些延时参数在手册的“时序特性”表里例程里通常用delay_ms或delay_us实现。3. 例程跑通实录从工程导入到读到序列号3.1 工程结构和依赖这份 STM32 例程的目录结构大致是这样的Drivers/下放 STM32 的 HAL 库和 CMSISATSHA204/下放芯片驱动包括atsha204.c、atsha204.h、atsha204_i2c.c和配置文件atsha204_config.hUser/下是main.c和业务逻辑。如果你用的是 Keil直接打开.uvprojx就能编译如果是 IAR 或者 STM32CubeIDE需要把源文件加进工程注意头文件路径要包含ATSHA204/目录。依赖上例程只用了 STM32 的 I2C 外设和 GPIO没有额外的中间件。atsha204_config.h里定义了几个关键宏ATSHA204_I2C_ADDR是从机地址ATSHA204_SLOT_USED是默认使用的 Slot 编号ATSHA204_USE_SOFT_I2C可以切换硬件 I2C 和软件模拟 I2C。如果你的板子 I2C 引脚被占了把ATSHA204_USE_SOFT_I2C打开用任意两个 GPIO 就能跑。3.2 编译前必须改的三个地方第一个是 I2C 从机地址。例程默认0xC8但如果你买的是带 ATSHA204A 的模块地址可能是0xC8也可能是0xCA用逻辑分析仪抓一下最稳。第二个是 Slot 编号例程默认用 Slot 0如果你的密钥已经写在别的 Slot要改ATSHA204_SLOT_USED。第三个是延时函数例程里用的是 HAL 的HAL_Delay如果你的工程里没初始化 SysTick要换成自己的延时实现。/* atsha204_config.h 里需要按实际硬件改的宏 */ #define ATSHA204_I2C_ADDR 0xC8 /* 从机地址常见 0xC8 或 0xCA */ #define ATSHA204_SLOT_USED 0x00 /* 默认使用的密钥 Slot */ #define ATSHA204_USE_SOFT_I2C 0 /* 1 表示用软件 I2C */ #define ATSHA204_I2C_TIMEOUT 100 /* I2C 超时单位 ms */改完这三个宏编译烧录串口应该能打印出芯片的序列号。如果串口没输出先确认printf重定向有没有配好这个和 ATSHA204 本身无关但新手经常在这里卡住。3.3 用串口验证读序列号例程的main里一般会先初始化 I2C然后调用atsha204_read_sn把读到的 4 字节序列号通过串口打印。序列号是芯片出厂时固化的每颗都不一样读到它说明 I2C 通信链路已经通了。如果读回来全是0xFF大概率是上拉电阻没接或者从机地址错了如果全是0x00检查供电芯片没起来。int main(void) { uint8_t sn[4] {0}; uint8_t ret; HAL_Init(); SystemClock_Config(); MX_I2C1_Init(); /* 初始化 I2C1 */ MX_USART1_UART_Init(); /* 初始化串口用于打印 */ ret atsha204_read_sn(sn); if (ret 0) { printf(SN: %02X %02X %02X %02X\r\n, sn[0], sn[1], sn[2], sn[3]); } else { printf(read sn failed, code%d\r\n, ret); } while (1) { /* 主循环 */ } }这段代码里ret的返回值对应不同的失败原因1是发送失败2是接收失败。调试时先看返回值比盲目抓波形快。序列号读通之后再往下做挑战应答就有底了。4. 避坑与排查I2C 通信和配置区的五个常见问题4.1 读回来全是 0xFF 或 0x00现象是串口打印的序列号全是0xFF或者全是0x00。原因通常是三类上拉电阻缺失或阻值不对、从机地址配错、供电电压不对。ATSHA204 的工作电压是 2.0V 到 5.5V但 I2C 电平要跟主控匹配3.3V 主控配 3.3V 供电最稳。解决方法是先用万用表量 SDA 和 SCL 的静态电平正常应该是高电平再用逻辑分析仪抓一次读序列号的波形看从机有没有 ACK。如果从机不 ACK基本就是地址或供电问题。4.2 挑战应答返回状态字 0x01现象是 Digest 命令返回的状态字是0x01表示命令执行失败。原因一般是 Slot 没有配置成允许 Digest 使用或者 Nonce 命令没有先执行。ATSHA204 的 Digest 命令依赖前一步的 Nonce 结果顺序不能反。解决方法是检查配置区里对应 Slot 的IsSecret和WriteConfig位确认这个 Slot 被配置成了密钥槽而不是普通数据槽。如果配置区已经锁了那就只能换一颗芯片重新配置。4.3 连续发命令导致超时现象是单次读序列号正常但连续做挑战应答时第二次或第三次就失败。原因是芯片内部处理 SHA-256 需要时间命令之间要留够tWW等待。手册里tWW典型值是 5 到 10 毫秒具体看命令类型。解决方法是在每次发命令前加delay_ms(5)或更长或者在驱动里封装一个atsha204_wait_ready轮询状态直到芯片空闲。4.4 配置区被锁后无法修改现象是执行 Lock 命令之后再想改 Slot 权限就返回错误。原因是配置区锁定是永久性的锁了就不能改。这是芯片的安全设计不是 bug。解决方法是在锁定之前把配置区的每一个字节都确认好最好先用一颗样片做完整验证确认无误再批量锁定。我一般会在代码里加一个ATSHA204_ALLOW_LOCK宏默认关闭只有量产固件才打开。4.5 软件 I2C 时序不匹配现象是硬件 I2C 能通切到软件 I2C 就失败。原因是软件 I2C 的延时和芯片时序要求不匹配太快或太慢都会导致采样错误。解决方法是根据主频调整delay_us的参数用逻辑分析仪看 SCL 频率控制在 100kHz 左右比较稳。ATSHA204 支持标准模式和快速模式但软件模拟时建议先用 100kHz 跑通再提速。5. 二次开发把例程改成自己的认证方案5.1 密钥写入和 Slot 规划例程默认只读序列号实际项目里第一步是把密钥写进 Slot。写密钥用 Write 命令但要注意如果配置区已经锁了且 Slot 配置成不可写那就写不进去了。所以正确的顺序是先写配置区、再写密钥、最后 Lock。密钥写入时数据要按 32 字节对齐不足的补零。/* 向指定 Slot 写入 32 字节密钥 */ uint8_t atsha204_write_key(uint8_t slot, uint8_t *key) { uint8_t cmd[36]; cmd[0] 0x12; /* Write 命令 */ cmd[1] 0x00; /* 写数据区 */ cmd[2] slot; /* Slot 编号 */ cmd[3] 0x00; memcpy(cmd[4], key, 32); if (atsha204_send_cmd(cmd, 36) ! 0) return 1; atsha204_delay_ms(10); /* 写操作需要更长的等待 */ return 0; }cmd[1]是写模式0x00表示写数据区0x80表示写配置区。写配置区更危险因为一旦写错可能直接锁死建议先用atsha204_read_config把当前配置读出来备份。5.2 主机侧摘要比对芯片返回摘要后主机要自己算一遍做比对。STM32 上可以用软件 SHA-256 库也可以用带硬件加密的型号。比对逻辑很简单主机用同样的密钥和挑战算 SHA-256和芯片返回的 32 字节逐字节比较。一致就通过不一致就拒绝。/* 主机侧验证芯片返回的摘要 */ uint8_t atsha204_verify(uint8_t *challenge, uint8_t *chip_resp, uint8_t *host_key) { uint8_t host_digest[32]; /* 用软件 SHA-256 算主机侧摘要 */ sha256_compute(host_key, 32, challenge, 32, host_digest); /* 逐字节比对 */ if (memcmp(host_digest, chip_resp, 32) 0) { return 0; /* 认证通过 */ } return 1; /* 认证失败 */ }这里sha256_compute的入参顺序要和芯片内部一致通常是“密钥 挑战”或者“挑战 密钥”具体看芯片配置。这个顺序在手册的“Digest 命令”一节有说明搞反了摘要永远对不上。5.3 量产时的配置固化流程量产时不能每颗芯片都手动配要把配置和密钥写入做成自动化流程。我一般会写一个产测工具通过串口或 I2C 批量操作先读序列号记录再写配置区再写密钥最后 Lock每一步都校验返回值。配置区的内容可以存在一个二进制文件里产测工具直接读文件写入避免手敲出错。步骤操作校验方式1读序列号确认非 0xFF2写配置区回读比对3写密钥回读比对如果 Slot 可读4Lock 配置区确认 Lock 状态位5挑战应答自测主机比对通过这张表里的每一步都要有失败重试和日志量产时最怕的是某颗芯片写了一半失败流到下一站才发现。产测工具里加一个“已锁定”标记锁过的芯片不再重复操作。5.4 一个容易忽略的细节最后说一个我踩过的坑ATSHA204 的 I2C 地址在读写时是不一样的写地址是0xC8读地址是0xC9。有些 HAL 库的HAL_I2C_Master_Transmit需要传 8 位地址有些需要传 7 位地址左移一位这个在移植例程时特别容易翻车。我现在的习惯是拿到任何一颗 I2C 芯片先用逻辑分析仪抓一次标准读写波形确认地址和时序都对得上再往工程里集成。从那以后我每次移植新的 I2C 驱动都强制走一遍“抓波形 → 对地址 → 读 ID”的流程省下来的调试时间比抓波形那几分钟多得多。希望这份手册和例程能帮你把 ATSHA204 顺利跑起来。本文还有配套的精品资源点击获取