如何增加一个新的平台支持¶
当前工程根据不同的模组采用了不同的配置方式,具体配置信息在 module_config
目录下,如果未指定对应的模组配置信息,将采用平台默认的配置信息,现在已支持 esp32 和 esp8266 平台。工程默认为 PLATFORM_ESP32
平台的 WROOM-32
模组。
对于同款芯片不同通讯接口的模组,由于在 esp-at 中编译的代码不同,我们不能采用默认的 module_espxxxx_default 配置。
假设新的平台为 ESP32 SDIO AT,我们需要使用 SDIO 作为通讯介质,我们以此为例,进行阐述如何添加新的平台设备。
1. 创建模块信息¶
假设平台名称为 PLATFORM_ESP32
,模块名称为 WROOM32-SDIO
,打开 components/customized_partitions/raw_data/factory_param/factory_param_data.csv
,按照标题
platform | module_name | magic_flag | version | module_id | tx_max_power | start_channel | channel_num | country_code | uart_baudrate | uart_tx_pin | uart_rx_pin | uart_ctx_pin | uart_rts_pin | tx_control_pin | rx_control_pin |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
在最后添加
PLATFORM_ESP32 | WROOM32-SDIO | 0xfcfc | 1 | 1 | 1 | 1 | 13 | CN | -1 | -1 | -1 | -1 | -1 | -1 | -1 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2. 修改工程模块信息¶
打开 Makefile
,修改平台名称和模块名称,对于英文字母,请使用大写格式
export ESP_AT_PROJECT_PLATFORM ?= PLATFORM_ESP32
export ESP_AT_MODULE_NAME ?= WROOM32-SDIO
**
3. 创建平台相关的配置¶
3.1 进入
module_config
, 将同款芯片的默认配置module_esp32_default
拷贝一份为module_esp32-sdio
3.2 此处我们不需要修改 partition 分区表和 IDF 版本,所以
at_customize.csv
、IDF_VERSION
和partitions_at.csv
都不做修改3.3 修改
sdkconfig.defaults
文件- 配置使用
module_esp32-sdio
目录下的分区表文件,需要修改如下配置:
CONFIG_PARTITION_TABLE_CUSTOM_FILENAME="module_config/module_esp32-sdio/partitions_at.csv" CONFIG_PARTITION_TABLE_FILENAME="module_config/module_esp32-sdio/partitions_at.csv" CONFIG_AT_CUSTOMIZED_PARTITION_TABLE_FILE="module_config/module_esp32-sdio/at_customize.csv"
使用 sdio 配置,由于工程中已经包含选择 sdio 的配置,所以我们只需要将选择 sdio 的配置加入到
sdkconfig.defaults
文件即可- 移除 UART AT 相关配置
CONFIG_AT_BASE_ON_UART=y
并新增
CONFIG_AT_BASE_ON_SDIO=y
- 配置使用
4. 修改链接的库文件¶
由于 ESP32 SDIO AT 和 ESP32 UART AT 是同一个平台,使用的是相同的 at core 库,所以我们不需要再新增库文件。
若需要使用新的 lib, 则将 lib 复制到 components/at/lib
目录下,并将 lib 命名为 libxxxx_at_core.a
, 其中 xxxx
为平台名称。假如根目录下的 Makefile
设置的 ESP_AT_PROJECT_PLATFORM ?= PLATFORM_ESP8848
,那么库的名称就要命名为 libesp8848_at_core.a
。