#ti #low-power #module

no-std cc2640r2_pac

TI cc2640r2 微控制器系列的外设访问包

1 个不稳定版本

0.10.3 2024 年 5 月 31 日

#487嵌入式开发

BSD-3-Clause

10MB
221K SLoC

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

CI

该仓库包含 TI 低功耗射频(LPRF)系列 Cortex-M 微控制器的外设访问包(PAC)。

所有这些包都是使用 svd2rusttixml2svd 自动生成的。

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

工作原理

该仓库试图尽可能自动化使用 tixml2svdsvd2rust。本节试图描述该仓库是如何构建的。

要查看代码的组织方式,尝试运行以下命令

$ 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。

  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

依赖项