基于STM32F103的CH101驅(qū)動(dòng)程序移植

有許多朋友在移植CHX01超聲波傳感器的過(guò)程中可能會(huì)遇到一些挑戰(zhàn)，因此本文將重點(diǎn)介紹一些核心問(wèn)題。雖然本來(lái)有想以手把手的方式來(lái)教授如何移植，但是由于之前移植的時(shí)候沒(méi)有保存具體過(guò)程中的圖文，所以需要花費(fèi)很長(zhǎng)的時(shí)間來(lái)重新完成這項(xiàng)工作。文末也提供了獲取資源的接口，以幫助大家解決移植中出現(xiàn)的問(wèn)題。

01準(zhǔn)備資料

1. 從官網(wǎng)獲取 SmartSonic_HelloChirp_Example_v1_31_0.exe

源碼（CHx01 官網(wǎng)源碼的硬件平臺(tái) MCU: ATSAMG55;IDE:Microchip Studio）

2. 獲取一個(gè) STM32F103CB 的例程，比如我直接使用 STM32CubeF1 的模板。（當(dāng)然你也可以用 STM32CubeIDE 創(chuàng)建一個(gè)工程）在這之前，假設(shè)你已經(jīng)掌握了 Keil IDE 工程下的文件添加、編譯等操作。比如，如下截圖，我精簡(jiǎn)了STM32CubeF1 的模板，將工程名稱修改為：SmartSonic_HelloChirp，并在工程下新建了 Drivers/BSP 和 Drivers/chirpmicro 兩個(gè)Groups。

3. 將SmartSonic_HelloChirp_Example_v1_31_0文件中

SmartSonic_HelloChirp_v1.31.0sourcedriverschirpmicro路徑下的src 和 inc 文件夾拷貝到自己的STM32工程的smart-sonic_-hello-chirpDriverschirpmicro目錄下

02API接口封裝

我在之前的文章《超聲波傳感器(CHx01) 學(xué)習(xí)筆記 Ⅲ-API介紹》中提到所需API接口的相關(guān)內(nèi)容。同樣，在官方提供的例程中有一個(gè) chbsp_dummy.c 文件，它使用 `attribute((weak))` 的方式提供了可選板支持包IO功能的虛擬實(shí)現(xiàn)，可以讓平臺(tái)依據(jù)需求來(lái)支持所需的功能。這種 `attribute((weak))` 例程能夠滿足來(lái)自其他代碼的引用，避免鏈接出現(xiàn)錯(cuò)誤，但它們不會(huì)執(zhí)行任何操作。所有板卡支持包接口的詳細(xì)信息，包括這些可選功能，都可以在 chirp_bsp.h 中找到。

/* Functions supporting debugging */
__attribute__((weak)) void chbsp_debug_toggle(uint8_t __attribute__((unused)) dbg_pin_num) {}
__attribute__((weak)) void chbsp_debug_on(uint8_t __attribute__((unused)) dbg_pin_num) {}
__attribute__((weak)) void chbsp_debug_off(uint8_t __attribute__((unused)) dbg_pin_num) {}
__attribute__((weak)) void chbsp_print_str(char *str) {
    (void)(str);
}
__attribute__((weak)) uint32_t chbsp_timestamp_ms() {
return 0;
}
__attribute__((weak)) int chbsp_i2c_deinit(void){
return 0;
}




/* Functions supporting interrupt-based operation */
__attribute__((weak)) void chbsp_group_io_interrupt_enable(ch_group_t *grp_ptr) {
    (void)(grp_ptr);
}
__attribute__((weak)) void chbsp_io_interrupt_enable(ch_dev_t *dev_ptr) {
    (void)(dev_ptr);
}
__attribute__((weak)) void chbsp_group_io_interrupt_disable(ch_group_t *grp_ptr) {
    (void)(grp_ptr);
}
__attribute__((weak)) void chbsp_io_interrupt_disable(ch_dev_t *dev_ptr) {
    (void)(dev_ptr);
}


/* Functions supporting non-blocking operation */
__attribute__((weak)) int chbsp_i2c_write_nb(ch_dev_t *dev_ptr, uint8_t *data, uint16_t num_bytes) {
    (void)(dev_ptr);
    (void)(data);
    (void)(num_bytes);
return 1;
}


__attribute__((weak)) 
int chbsp_i2c_mem_write_nb(ch_dev_t *dev_ptr, uint16_t mem_addr, uint8_t *data, uint16_t num_bytes) {
    (void)(dev_ptr);
    (void)(mem_addr);
    (void)(data);
    (void)(num_bytes);
return 1;
}


__attribute__((weak)) int chbsp_i2c_read_nb(ch_dev_t *dev_ptr, uint8_t *data, uint16_t num_bytes) {
    (void)(dev_ptr);
    (void)(data);
    (void)(num_bytes);
return 1;
}


__attribute__((weak)) int chbsp_i2c_mem_read_nb(ch_dev_t *dev_ptr, uint16_t mem_addr, uint8_t *data, uint16_t num_bytes) {
    (void)(dev_ptr);
    (void)(mem_addr);
    (void)(data);
    (void)(num_bytes);
return 1;
}




/* Functions supporting controlling int pins of individual sensors (originally only controllable in a group) */
__attribute__((weak)) void chbsp_set_io_dir_out(ch_dev_t *dev_ptr) {
    (void)(dev_ptr);
}
__attribute__((weak)) void chbsp_set_io_dir_in(ch_dev_t *dev_ptr) {
    (void)(dev_ptr);
}
__attribute__((weak)) void chbsp_io_clear(ch_dev_t *dev_ptr) {
    (void)(dev_ptr);
}
__attribute__((weak)) void chbsp_io_set(ch_dev_t *dev_ptr) {
    (void)(dev_ptr);
}
__attribute__((weak)) void chbsp_external_i2c_irq_handler(chdrv_i2c_transaction_t *trans){
    (void)(trans);
}

超聲波傳感器(CHx01) 學(xué)習(xí)筆記 Ⅱ- I2C讀寫操作》中有詳細(xì)的介紹，按照上述API接口逐個(gè)封裝函數(shù)內(nèi)容即可。

03API接口驗(yàn)證

假設(shè)你已經(jīng)將MAX3378EEUD和74LVC1T45用于IO口電平轉(zhuǎn)換，接下來(lái)就是如何獲取傳感器的固定ID，以此來(lái)驗(yàn)證I2C通信接口的正確性。獲取ID的方式可以幫助我們更好地驗(yàn)證I2C通信接口的封裝正確性。

獲取傳感器 ID流程圖

獲取傳感器 IDI2C讀時(shí)序圖

04關(guān)鍵API接口介紹

`int chbsp_i2c_mem_read(ch_dev_t *dev_ptr, uint16_t mem_addr, uint8_t *data, uint16_t num_bytes)`

這個(gè) API 使用內(nèi)存尋址從I2C從機(jī)讀取字節(jié)。需要封裝成一個(gè)，指定一個(gè)字節(jié)寄存器地址并從Slave讀取多個(gè)字節(jié)的函數(shù)。

與 STM32 HAL庫(kù)相關(guān)的函數(shù)是：HAL_I2C_Mem_Read(&hi2c1, Address << 1, RegisterAddr, 1, (uint8_t *)(uint32_t)RegisterValue, (uint16_t)RegisterLen, 1000)

`int chbsp_i2c_read(ch_dev_t *dev_ptr, uint8_t *data, uint16_t num_bytes)`

這個(gè) API 是原始的I2C從機(jī)讀取字節(jié)。需要封裝成一個(gè)，從Slave讀取多字節(jié)的函數(shù)。

與 STM32 HAL庫(kù)相關(guān)的函數(shù)是：HAL_I2C_Master_Receive(&hi2c1, (Address << 1), (uint8_t *)(uint32_t)data, (uint16_t)len, 1000)

`int chbsp_i2c_mem_write(ch_dev_t *dev_ptr, uint16_t mem_addr, uint8_t *data, uint16_t num_bytes)`

這個(gè) API 使用內(nèi)存尋址將字節(jié)寫入I2C從機(jī)。需要封裝成一個(gè)，指定一個(gè)字節(jié)寄存器地址并將多個(gè)字節(jié)寫入從機(jī)的函數(shù)。

與 STM32 HAL庫(kù)相關(guān)的函數(shù)是：HAL_I2C_Mem_Write(&hi2c1, Address << 1, RegisterAddr, 1, (uint8_t *)(uint32_t)RegisterValue, (uint32_t)RegisterLen, 1000)

`int chbsp_i2c_write(ch_dev_t *dev_ptr, uint8_t *data, uint16_t num_bytes)`

這個(gè) API 是原始的將字節(jié)寫入I2C從機(jī)。需要封裝成一個(gè)，將多字節(jié)寫入從機(jī)的函數(shù)。

與 STM32 HAL庫(kù)相關(guān)的函數(shù)是：HAL_I2C_Master_Transmit(&hi2c1, (Address << 1), (uint8_t *)(uint32_t)data, (uint32_t)len, 1000)

`void chbsp_delay_ms(uint32_t num_ms)`

`void chbsp_delay_us(uint32_t us)`

這兩個(gè)延時(shí)函數(shù)要精準(zhǔn)，尤其是 chbsp_delay_ms 毫秒延時(shí)，會(huì)直接影響傳感器的輸出頻率。

下面這兩個(gè)函數(shù)，我們無(wú)需自行封裝任何內(nèi)容，但是它們非常重要。

`int chdrv_group_detect_and_program(ch_group_t *grp_ptr)`

這個(gè)函數(shù)用來(lái)檢測(cè)、編程和啟動(dòng)傳感器。對(duì)于每個(gè)檢測(cè)到的傳感器，會(huì)將傳感器固件被編程到設(shè)備中，并設(shè)置應(yīng)用程序I2C地址。然后傳感器復(fù)位并開(kāi)始執(zhí)行。

一旦啟動(dòng)，傳感器設(shè)備將開(kāi)始內(nèi)部初始化和自檢序列。chdrv_group_wait_for_lock()函數(shù)可用于等待此序列在設(shè)備上完成。此函數(shù)完成后，將使設(shè)備的PROG引腳解除。

`void chdrv_group_measure_rtc(ch_group_t *grp_ptr)`

這個(gè)函數(shù)用來(lái) 校準(zhǔn)傳感器實(shí)時(shí)時(shí)鐘。在這個(gè)函數(shù)里 觸發(fā)IO引腳上的脈沖 時(shí)與選擇的主處理器的時(shí)鐘相關(guān)。

此函數(shù)在INT 引腳上向傳感器設(shè)備發(fā)送一個(gè)脈沖（由主機(jī)MCU定時(shí)），然后回讀每個(gè)單獨(dú)設(shè)備上該脈沖期間經(jīng)過(guò)的傳感器RTC周期的計(jì)數(shù)。結(jié)果存儲(chǔ)在每個(gè)設(shè)備的ch_dev_config結(jié)構(gòu)中，隨后在范圍計(jì)算期間使用。

脈沖的長(zhǎng)度為dev_ptr->rtc_cal_pulse_ms毫秒（通常為100）。此值在ch_init()期間設(shè)置。

如果有多個(gè)傳感器時(shí)，校準(zhǔn)脈沖會(huì)同時(shí)發(fā)送到所有設(shè)備。因此，所有連接的設(shè)備將看到相同的參考脈沖長(zhǎng)度。

還需要實(shí)現(xiàn)兩個(gè)外設(shè)功能

定時(shí)器，定時(shí)周期100ms,在定時(shí)器回調(diào)函數(shù)中周期性調(diào)用

`int chdrv_group_hw_trigger(ch_group_t *grp_ptr)` 啟動(dòng)硬件觸發(fā)模式下開(kāi)始測(cè)量。

int chdrv_group_hw_trigger(ch_group_t *grp_ptr) 函數(shù)通過(guò)簡(jiǎn)單地檢測(cè)INT 引腳上每個(gè)傳感器開(kāi)始被觸發(fā)的測(cè)量。在調(diào)用此函數(shù)之前，每個(gè)傳感器必須已置于硬件觸發(fā)模式。

GPIO外部中斷，在外部中斷回調(diào)函數(shù)中調(diào)用

`sensor_int_callback()` 檢測(cè)傳感器的中斷信號(hào)。每次調(diào)用此函數(shù)時(shí)，都會(huì)在data_ready_devices變量中設(shè)置一個(gè)位以標(biāo)識(shí)中斷設(shè)備。當(dāng)傳感器產(chǎn)生中斷（通過(guò)與active_devices變量比較找到）時(shí)，DATA_READY_FLAG被設(shè)置。該標(biāo)志將在main()循環(huán)中檢測(cè)到。

一個(gè)完成的硬件觸發(fā)INT硬件，并接收傳感器返回的INT信號(hào)的時(shí)序圖

05程序流程圖

主程序

定時(shí)器服務(wù)程序

INT外部中斷服務(wù)程序