ZHCABT9C May 2020 – October 2022 AWR6843 , AWR6843AOP , IWR1642 , IWR1843 , IWR6443 , IWR6843 , IWR6843AOP
表 2-2 列出了将现有 xWR1642 应用程序代码移植到 xWR1843 所需的变更。
本节提供的迁移说明仅适用于迁移到 MMWAVE-SDK 3.3。
在将现有 xWR1843 应用程序迁移到 MMWAVE-SDK 3.3 以外的 SDK 版本时，应遵循相应 SDK 版本说明中提供的增量迁移说明。
| 编号 | 总结 | 受影响的部分 | 必需的变更 |
|---|---|---|---|
| 1 | xWR1843 需要 MMWAVE-SDK 3.2.1 或更高版本 注意：建议使用 SDK 3.3.0 或更高版本以包含最新的 API 更新。 | Makefile 或 CCS 工程 | 应用程序代码必须使用 MMWAVE-SDK 3.3.0 或更高版本重新编译，才能在 xWR1843 上运行 Makefile：如果您使用 SDK makefile，则无需更改，因为这会在 SDK 3.3 环境设置脚本中自动处理： C:\ti\mmwave_sdk_03_03_xx_xx\packages\scripts\windows\setenv.bat 或 CCS Projectspec：如果应用程序是使用 CCS projectspec 编译的，则需要更新 DSS projectspec 和 MSS projectspec 中的 products 属性，如下所示。 <property name="products" value="com.ti.rtsc.SYSBIOS:6.73.01.01;com.ti.MMWAVE_SDK:3.3.0.03;"/> 示例：有关 xWR1843 的参考 CCS 工程，请参阅“18xx – 毫米波 SDK 演示”，位于：毫米波工业工具箱。 |
| 2 | 更改器件类型 | Makefile 或 CCS 工程 | Makefile：对于基于 SDK makefile 的构建，请在 setenv.bat 中设置 MMWAVE_SDK_DEVICE=iwr18xx/awr18xx。 C:\ti\mmwave_sdk_03_03_xx_xx\packages\scripts\windows\setenv.bat 或 CCS Projectspec：如果使用 CCS projectspec 编译应用程序，请在 DSS projectspec 和 MSS projectspec 中将定义 SOC_XWR16XX 更改为 SOC_XWR18XX。 示例：有关 xWR1843 的参考 CCS 工程，请参阅“18xx – 毫米波 SDK 演示”，位于：毫米波工业工具箱。 |
| 3 | 更新 RadarSS 固件文件路径 | Makefile 或 CCS 工程 (mss) | 需要在 metaimage 生成步骤中使用 xWR18xx_radarss_rprc.bin。Makefile：如果您使用 SDK makefile，则无需更改，因为这会在基于 MMWAVE_SDK_DEVICE 变量的 SDK 3.3 环境设置脚本中自动处理。 或 CCS Projectspec：如果使用 CCS projectspec 编译应用程序，请在 metaimage 生成步骤（编译后处理步骤）中将 xwr16xx_radarss_rprc.bin 替换为 xWR18xx_radarss_rprc.bin 示例：有关 xWR1843 的参考 CCS 工程，请参阅“18xx – 毫米波 SDK 演示”，位于：毫米波工业工具箱。 |
| 4 | 使用 xWR18xx 平台链接器命令文件 | Makefile 或 CCS 工程 | Makefile：如果您使用 SDK makefile，则无需更改，因为这会在基于 MMWAVE_SDK_DEVICE 变量的 SDK 3.3 环境设置脚本中自动处理。 或 CCS Projectspec：如果使用 CCS projectspec 编译应用程序，请将 r4f_linker.cmd 和 c674x_linker.cmd 的包含路径分别更新为： COM_TI_MMWAVE_SDK_INSTALL_DIR/packages/ti/platform/xwr18xx/r4f_linker.cmd 和 COM_TI_MMWAVE_SDK_INSTALL_DIR/packages/ti/platform/xwr18xx/c674x_linker.cmd。 示例：有关 xWR1843 的参考 CCS 工程，请参阅“18xx – 毫米波 SDK 演示”，位于：毫米波工业工具箱。 |
| 5 | 包括 xWR18xx 驱动程序和 CLI 库 | Makefile 或 CCS 工程 | Makefile：如果您使用 SDK makefile，则无需更改，因为这会在基于 MMWAVE_SDK_DEVICE 变量的 SDK 3.3 环境设置脚本中自动处理。 或 CCS Projectspec：如果使用 CCS projectspec 编译应用程序，请更新链接器包含路径以选择 *_xwr18xx.aer4f 和 *_xwr18xx.xe674 库版本，例如： -llibsoc_xwr18xx.ae674、-llibsoc_xwr18xx.xe674、-llibcli_xwr18xx.aer4f |
| 6 | 更新传感器前端配置参数 | CLI 配置文件 (.cfg) 和/或源代码 | 更新 chirpCfg CLI 命令和/或 API 中的 TX 通道位图以解决第 3 个 TX 的问题。 示例：有关更多信息，请参阅 C:\ti\mmwave_sdk_03_03_xx_xx\packages\ti\demo\xwr18xx\mmw\profiles 中的示例配置文件。 |
| 7 | 将 16xx SOC 定义替换为 18xx 等效项。 | MSS/DSS 源代码 | 将源代码中的 SOC_XWR16XX_* 定义/宏替换为相应 SOC_XWR18XX_* 定义。 例如： 代码快照：请参阅Topic Link Label5.7。 |
| 8 | 针对 MMWave_open 的 API 更新 SDK 3.3 要求将新参数传递到 MMWave_open | MSS/DSS 启动代码 | MMWave_open：应用程序必须在调用 MMWave_open 之前设置 calibMonTimeUnit 参数的值，如下所示。下图显示了 SDK 68xx 毫米波演示中的参考代码更新（同样适用于 18xx 毫米波演示） 文件：mmwave_sdk_03_03_xx_xx\packages\ti\demo\xwr68xx\mmw\mss\mss_main.c 代码快照：请参阅Topic Link Label5.1。 |
| 9 | 针对 ADCBuf_open 的 API 更新 SDK 3.3 要求将新参数传递到 ADCBuf_open | MSS/DSS 启动代码 | ADCBUF_open：应用程序必须在调用 ADCBUF_open 之前，在 ADCBufparams 结构中设置 socHandle 的值，如下所示。下图显示了 SDK 68xx 毫米波演示中的参考代码更新（同样适用于 18xx 毫米波演示）。 文件：mmwave_sdk_03_03_xx_xx\packages\ti\demo\utils\mmwdemo_adcconfig.c 代码快照：请参阅Topic Link Label5.2。 |
| 10 | 针对 CANFD_init 的 API 更新 SDK 3.3 要求将新参数传递到 CANFD_init | 驱动程序 | CANDF_init：使用 CANFD 驱动程序的应用程序必须将实例 ID 传递给 CANFD_init API，如下所示。目前仅支持值 0。下图显示了 SDK CANFD 驱动程序测试中的参考代码更新（同样适用于 18xx）。 文件：mmwave_sdk_03_03_xx_xx\packages\ti\drivers\canfd\test\xwr618xx\main.c 代码快照：请参阅Topic Link Label5.3。 |
| 11 | 有关 CLI 配置文件的一般说明 | 传感器配置 | 对于重复使用毫米波演示框架的应用程序，请确保配置命令（profileCfg、chirpCfg、frameCfg 等）遵循毫米波演示目录中提供的示例配置文件中提供的格式： C:\ti\mmwave_sdk_03_03_xx_xx\packages\ti\demo\xwr18xx\mmw\profiles。 有关更多信息，请参阅毫米波 SDK 用户指南 的配置文件格式 部分。请参考 Topic Link Label6。 |