Lib.rs

› 加密学
#低功耗 #ti #模块

无std cc13x4_cc26x4_pac

德州仪器cc13x4/cc26x4微控制器系列的外设访问包

由 seanmlyons22 所有。

1个不稳定版本

0.10.3 2024年5月31日

#379 in 加密学

BSD-3-Clause

16MB
350K SLoC

德州仪器低功耗射频微控制器的PACs

CI

此仓库包含德州仪器低功耗射频（LPRF）系列Cortex-M微控制器的外设访问包（PACs）。

所有这些包都是使用svd2rust和tixml2svd自动生成的。

包

在LPRF芯片系列中的每个设备系列都有自己的PAC。设备系列是德州仪器分组具有相同外设的相似设备的组。在这个命名方案中，x是一个通配符。即CC2652和CC1312都属于cc13x2_cc26x2系列。

为了防止在包中大量重复，每个设备系列只有一个PAC，而不是每个设备。

以下列出了PACs

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文件创建PACs。

输入文件

input目录包含来自德州仪器的设备定义文件。可以从Code Composer Studio（CCS）安装中复制。

位于Modules文件夹内的文件以德州仪器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。

  1. 按照上述方法将CCS中的文件复制过来
  2. 如果添加新的设备系列，请在input/devices/中创建设备系列XML描述符。
    • 提示：这些可以从CCS <INSTALL_LOC>/ti/ccs<CCS_VER>/ccs/ccs_base/common/targetdb/devices中复制。
    • 从您想要的系列中选择一个设备并将其复制到树中并重命名
  3. 如果添加新的设备系列，请创建device_family_ints.rs，将device_family替换为设备系列名称。
    • 提示：可以使用TI创建的C文件。它可以在<TI_SDK>/source/ti/devices/<device_family>/inc/hw_ints.h中找到。
  4. 运行cargo xtask generate
  5. 根据您在上一步创建的向量表更新device.x

依赖项