1 个不稳定版本
0.10.3 | 2024 年 5 月 31 日 |
---|
#487 在 嵌入式开发
10MB
221K SLoC
德州仪器低功耗射频微控制器的 PAC
该仓库包含 TI 低功耗射频(LPRF)系列 Cortex-M 微控制器的外设访问包(PAC)。
所有这些包都是使用 svd2rust 和 tixml2svd 自动生成的。
包
LPRF 芯片系列中的每个设备系列都有自己的 PAC。设备系列是 TI 将具有相同外设的类似设备分组的方式。在此命名方案中 x
是通配符。即 CC2652 和 CC1312 都属于 cc13x2_cc26x2 系列。
为了防止在包中重复太多,每个设备系列只有一个 PAC,而不是每个设备。
以下列出了 PAC
PAC | 支持的设备 | TI SDK 链接 | 目标 |
---|---|---|---|
cc13x0 |
CC1310, CC1350 | https://www.ti.com/tool/download/SIMPLELINK-CC13X0-SDK | thumbv7m-none-eabi |
cc13x1_cc26x1 |
CC1311P3, CC1311R3, CC2651P3, CC2651R3, CC2651R3SIPA | https://github.com/TexasInstruments/cc13xx_cc26xx_sdk | thumbv7em-none-eabi |
cc13x2_cc26x2 |
CC2642R, CC2652R, CC2652RB, CC1312R, CC1352R, CC1352P, CC2652P, CC2652PSIP, CC2652RSIP | https://github.com/TexasInstruments/cc13xx_cc26xx_sdk | thumbv7em-none-eabihf |
cc13x2x7_cc26x2x7 |
CC1312R7, CC1352P7, CC2652P7, CC2652R7 | https://github.com/TexasInstruments/cc13xx_cc26xx_sdk | thumbv7em-none-eabihf |
cc13x4_cc26x4 |
CC1314R, CC1354R, CC1354P, CC2674R, CC2674P | https://github.com/TexasInstruments/cc13xx_cc26xx_sdk | thumbv8m.main-none-eabihf |
cc2640r2 |
CC2640R2 | https://www.ti.com/tool/download/SIMPLELINK-CC2640R2-SDK | thumbv7m-none-eabi |
工作原理
该仓库试图尽可能自动化使用 tixml2svd 和 svd2rust。本节试图描述该仓库是如何构建的。
要查看代码的组织方式,尝试运行以下命令
$ tree -L 2
这将给出类似于以下输出
.
├── Cargo.lock
├── Cargo.toml
├── CONTRIBUTING.md
├── input
│ ├── devices
│ └── Modules
├── LICENSE.txt
├── pacs
│ ├── cc13x0
│ ├── cc13x1_cc26x1
│ ├── cc13x2_cc26x2
│ ├── cc13x2x7_cc26x2x7
│ ├── cc13x4_cc26x4
│ └── cc2640r2
├── README.md
├── svds
│ ├── cc13x0.svd
│ ├── cc13x1_cc26x1.svd
│ ├── cc13x2_cc26x2.svd
│ ├── cc13x2x7_cc26x2x7.svd
│ ├── cc13x4_cc26x4.svd
│ └── cc2640r2.svd
├── tests
│ ├── cc13x0
│ ├── cc13x2-cc26x2
│ ├── cc13x4-cc26x4
│ └── cc2640r2
├── tools
│ └── generate_pacs.py
└── xtask
├── Cargo.toml
└── src
27 directories, 15 files
使用 tools/generate_pacs.py
自动从输入 XML 文件创建 PAC。
输入文件
input
目录包含来自 TI 的设备定义文件。它们可以从 Code Composer Studio (CCS) 安装中复制。
在 Modules
文件夹中的文件使用 TI XML 格式定义设备的外设集。
这些文件用于使用 tixml2svd 生成 svd
文件。
在input/devices
目录中的XML文件是手动维护的。它们基于设备系列。在input/devices
中的单个XML文件将生成一个PAC。
补丁
TI的XML源代码不包含中断定义。因此,还有手动维护的Rust文件,其中包含在Rust中定义中断向量表的所需代码。这些文件用于修补生成的lib.rs
文件。理想情况下,SVD文件也会被修补,但这稍微复杂一些,所以我们现在使用一个更简单的解决方案。
添加或更新设备
要更新源文件,将Modules
文件夹从<INSTALL_LOC>/ti/ccs<CCS_VER>/ccs/ccs_base/common/targetdb/
复制到本仓库中的input/Modules
文件夹。 <INSTALL_LOC>
是您安装CCS的位置。 <CCS_VER>
是您安装的CCS版本,不带任何.
或其他分隔符,因此12.2.0变为1220。
- 如上所述,从CCS复制文件
- 如果添加新的设备系列,在
input/devices/
中创建设备系列XML描述符。- 提示:这些可以从CCS
<INSTALL_LOC>/ti/ccs<CCS_VER>/ccs/ccs_base/common/targetdb/devices
复制。 - 从您想要的系列中选择一个设备并将其复制到树中,并重命名它
- 提示:这些可以从CCS
- 如果添加新的设备系列,创建
device_family_ints.rs
,将device_family
替换为设备系列名称。- 提示:可以使用TI创建的C文件。它可以在
<TI_SDK>/source/ti/devices/<device_family>/inc/hw_ints.h
中找到。
- 提示:可以使用TI创建的C文件。它可以在
- 运行
cargo xtask generate
- 根据您在上一步中创建的向量表更新
device.x