【蓝牙5.2 PB-03F教程】二次开发环境搭建

显示全部楼层 · 2024-10-16 15:19:17

一：硬件介绍
PB-03F-Kit 是针对 PB-03F 模组设计的。开发板实物如下图。

PB-03F开发板介绍
PB-03F开发板是由深圳市安信可科技有限公司开发的蓝牙模块。使用的PHY6252这样一款高集成度的低功耗蓝牙系统级芯片(SoC)，专为物联网(IoT)、移动设备、可穿戴电子设备、智能家居等各种应用而设计。
产品特性：
    支持 BLE5.2，速率支持：125Kbps，500Kbps，1Mbps，2Mbps
    拥有 64 KB SRAM，256KB flash，96 KB ROM，256bit efuse
    支持 UART/GPIO/ADC/PWM/I2C/SPI/PDM/DMA 接口
    支持多种休眠模式，深度睡眠电流小于 1uA
    支持串口本地升级和远程固件升级（FOTA）
    通用 AT 指令可快速上手
    支持二次开发，集成了 Windows 开发环境
PB-03F开发板规格书：
https://docs.ai-thinker.com/_media/pb-03f-kit%E5%BC%80%E5%8F%91%E6%9D%BF%E8%A7%84%E6%A0%BC%E4%B9%A6v1.0.0_1_.pdf
PB-03F-Kit开发板外观图

尺寸图：

板载有RGB 灯、按键、CH340等资源，可以很方便的进行二次开发。
二. 资料获取
主要在安信可科技官网或奉加微电子官网下载一些需要的开发资料。
三. 开发环境搭建
开发环境主要使用Keil5集成开发软件。
1. Keil5软件安装
keil5软件安装，百度一下教程这里就不赘述了。
2. SDK下载
在官网下载SDK，然后解压。

SDK目录结构

3. 烧录工具下载
在官网下载PhyPlusKit软件

四. 点灯程序编译(嵌入式的hello world)
1. LED原理图
开发板板载有一个RGB灯，原理图如下。
我们将点亮蓝色（Blue）的LED，所以代码要做的工作就是控制P18（GPIO_18）输出高电平。

2. 代码编写
在gpio例程的基础上修改代码即可。
打开SDK下面的example\peripheral\gpio例程，双击下图工程文件。

建议关闭低功耗模式。
因为芯片休眠了，LED的输出也会关闭。
点击魔法棒，选择C/C++选项。

宏说明：
· CFG_SLEEP_MODE=PWR_MODE_SLEEP ：使能低功耗模式，固件程序执行过程中，会在空闲过程进入睡眠，睡眠之后调试器无法进行调试跟踪，断点也失效
· CFG_SLEEP_MODE=PWR_MOD_NO_SLEEP ：关闭低功耗模式，固件程序执行过程中，处理器一直处于唤醒状态。
将CFG_SLEEP_MODE=PWR_MODE_SLEEP修改为CFG_SLEEP_MODE=PWR_MODE_NO_SLEEP。
修改后如图：

修改gpio_demo.c函数
gpio示例演示的是按键功能，这里示例写的功能太复杂了。
我们将其简化为点亮蓝色LED（GPIO_18 输出高电平）。
找到void Key_Demo_Init(uint8 task_id)将其全部注释掉。

替换为如下：

修改后的参考代码为：

//void Key_Demo_Init(uint8 task_id)
//{
// uint8_t i = 0;
// key_TaskID = task_id;
// LOG("gpio key demo start...\n");
// hal_gpio_init();
// hal_gpioretention_register(P20);
// hal_gpio_write(P20,1);
hal_gpio_pin2pin3_control(P2,1);
// /*
// when use key,please set the following parameters:
// 1.key number,config KEY_NUM in key.h
// 2.gpio used,config key_state.pin
// P00~P03:default jtag,we can use it as key when no debug.
// P04~P07,P11~P15:default gpio,use it easily.
// P08:mode select pin,cannot used as other usage.
// P09~P10,it is uart in burn mode which cannot config.it is configable when in debug mode.
// P16~P17:xtal pin,when use this pins,please use rc as system frequency.config hal_rtc_clock_config(CLK_32K_RCOSC) in hal_init first.
// P18~P34:wakeup is supported,but interrupt is not supported,so config it as key is not suggested.
// 3.idle level,config key_state.idle_level
// 4.key type,if only use press and release,ignore the long press and release code
// 5.taskID and callback function
// */
key_state.key[0].pin = GPIO_P14;//default gpio
key_state.key[1].pin = GPIO_P15;
key_state.key[2].pin = GPIO_P00;//default jtag
key_state.key[3].pin = GPIO_P01;
key_state.key[4].pin = GPIO_P02;
key_state.key[5].pin = GPIO_P03;
key_state.key[6].pin = GPIO_P16;//default xtal
key_state.key[7].pin = GPIO_P17;//default xtal
key_state.key[0].pin = GPIO_P09;
key_state.key[1].pin = GPIO_P10;
// key_state.key[0].pin = GPIO_P03;
key_state.key[1].pin = GPIO_P15;
// for(i = 0; i < HAL_KEY_NUM; ++i)
// {
// key_state.key[i].state = HAL_STATE_KEY_IDLE;
// key_state.key[i].idle_level = HAL_LOW_IDLE;
// if(key_state.key[i].pin == GPIO_P16)
// {
// hal_pwrmgr_register(MOD_USR2,NULL,P16_wakeup_handler);
// hal_gpio_cfg_analog_io(key_state.key[i].pin,Bit_DISABLE);
// LOG("P16 is used\n");
// }
// else if(key_state.key[i].pin == GPIO_P17)
// {
// hal_pwrmgr_register(MOD_USR3,NULL,P17_wakeup_handler);
// hal_gpio_cfg_analog_io(key_state.key[i].pin,Bit_DISABLE);
// LOG("P17 is used\n");
// }
// else if((key_state.key[i].pin == GPIO_P09) || (key_state.key[i].pin == GPIO_P10))
// {
// uart_port_reconfig();
// }
// }
key_state.key[0].idle_level = HAL_LOW_IDLE;
key_state.key[1].idle_level = HAL_HIGH_IDLE;
// key_state.task_id = key_TaskID;
// key_state.key_callbank = key_press_evt;
// key_init();
// osal_start_timerEx(key_TaskID, KEY_DEMO_ONCE_TIMER, 5000);
// osal_start_reload_timer(key_TaskID, KEY_DEMO_CYCLE_TIMER, 5000);
//}
void Key_Demo_Init(uint8 task_id)
{
key_TaskID = task_id;// 任务id，先暂时不用管。
// 此写函数默认会调用hal_gpio_pin_init(pin,GPIO_OUTPUT);
hal_gpio_write(GPIO_P18,HAL_HIGH_IDLE); // GPIO18 输出高电平，点亮LED
}

复制代码

然后点击编译，如下图所示。

这里的编译有3个警告，是因为这个c文件定义了函数却没有调用。就点亮led可以暂时先忽略此警告。

After Build - User command #2: fromelf.exe .\Objects\gpio_demo.axf --i32combined --output .\bin\gpio_demo.hex
注意这一行的 --output .\bin\gpio_demo.hex告诉了我们输出的gpio_demo.hex固件在bin目录下。
五. 程序烧录
1. 安装串口驱动
开发板使用的驱动芯片是CH340，所以烧录之前先安装CH340的驱动。
安装方法，搜索一下就有，就不赘述了。
2. 烧录工具
连接开发板，打开PhyPlusKit软件。打开串口COM3，选择UXTDWU。

此时会看到右侧一直输出。说明开发板连接成功。