BabyOS适用于MCU项目,她是一套管理功能模块和外设驱动的框架。
对项目而言,缩短开发周期。项目开发时选择适用的功能模块及驱动。直接进入功能代码编写的阶段。
对工程师而言,减少重复工作。调试过的功能模块和驱动代码放入BabyOS中管理,以后项目可以直接使用,去掉重复调试的工作。
代码结构
BabyOS代码分为3部分:
BabyOS仓库:功能模块和驱动 ,一般情况下用户不需要改动,可以将此仓库作为子模块。
BabyOS_Config:配置文件和设备注册文件
BabyOS_Hal:硬件抽象层, 不同分支对应不同硬件平台,选择对应平台下载,没有合适的则选择master分支
适用项目
使用裸机开发的项目推荐基于BabyOS进行。
使用操作系统开发的项目,BabyOS可作为功能库及驱动库使用。
使用方法
基于STM32F107上使用SPIFLASH及KV功能模块为例
1.添加文件
BabyOS //可作git子模块使用 ├── bos │ ├── algorithm //常用算法,无需添加其中文件 │ ├── core //核心文件,全部包含至工程 │ ├── drivers //驱动文件,选择spiflash驱动添加至工程 │ ├── modules //功能模块,全部添加至工程,由配置文件b_config.h配置 │ ├── thirdparty //第三方代码,选择SFUD第三方代码添加至工程 │ └── utils //实用代码,选择delay部分代码添加至工程 ├── doc //相关文档 ├── LICENSE //开源协议 └── README.md BabyOS_Config //克隆后放入工程目录,全部添加至工程 BabyOS_Hal //克隆后放入工程目录,添加hal、gpio、uart、spi部分
//进入用户工程目录执行 git submodule add https://gitee.com/notrynohigh/BabyOS.git git clone https://gitee.com/notrynohigh/BabyOS_Config.git //克隆配置文件及设备注册文件 git clone https://gitee.com/notrynohigh/BabyOS_Hal.git //克隆后切换到对应平台的分支,如果没有则采用master分支作为模板
2.增加系统定时器
//例如使用滴答定时器,中断服务函数调用:void bHalIncSysTick(void); //注:定时器的周期与b_config.h里_TICK_FRQ_HZ要匹配
3.选择功能模块
b_config.h进行配置,勾选其中的KV Enable/Disable项
4.注册设备
//b_device_list.h,在里面添加使用的外设。例如项目只需要使用SPIFlash,那么添加如下代码: // 设备 驱动 描述 B_DEVICE_REG(SPIFLASH, bSPIFLASH_Driver[0], "flash") //如果没有注册任何设备,取消B_DEVICE_REG(null, bNullDriver, "null")的注释 //B_DEVICE_REG(null, bNullDriver, "null")
5.修改硬件接口
b_hal.h中根据实际连接图修改GPIO和SPI号
#define HAL_SPIFLASH_QSPI_EN 0 #define HAL_SPIFLASH_TOTAL_NUMBER 1 #define HAL_SPIFLASH_IF {{B_HAL_QSPI_INVALID, B_HAL_SPI_1, {B_HAL_GPIOB, B_HAL_PIN12}},}
6.修改硬件抽象层SPI部分
(依赖硬件平台,使用STM32 HAL库为例)
//b_hal_spi.c int bHalSPI_Send(bHalSPINumber_t spi, uint8_t *pbuf, uint16_t len) { if(pbuf == NULL) { return -1; } switch(spi) { case B_HAL_SPI_1: HAL_SPI_Transmit(&hspi1, pbuf, len, 0xfff); break; default: break; } return 0; } int bHalSPI_Receive(bHalSPINumber_t spi, uint8_t *pbuf, uint16_t len) { if(pbuf == NULL) { return -1; } switch(spi) { case B_HAL_SPI_1: HAL_SPI_Receive(&hspi1, pbuf, len, 0xfff); break; default: break; } return 0; }
7.修改硬件抽象层GPIO部分
(依赖硬件平台,使用STM32 HAL库为例)
void bHalGPIO_WritePin(uint8_t port, uint8_t pin, uint8_t s) { GPIO_PinState sta = (s) ? GPIO_PIN_SET : GPIO_PIN_RESET; HAL_GPIO_WritePin(GPIO_PortTable[port], GPIO_PinTable[pin], sta); }
8.基于SPIFLASH使用KV功能
#include "b_os.h" //头文件 //b_config.h配置文件中使能KV存储 int main() { uint8_t buf[128]; bInit(); //初始化,外设的初始化会在此处调用 if(0 == bKV_Init(SPIFLASH, 0xA000, 4096 * 4, 4096)) //初始化KV存储,指定存储设备SPIFLASH { b_log("bKV_Init ok...\r\n"); } //存储键值对(可用于存储系统配置信息) bKV_Set("name", (uint8_t *)"BabyOS", 7); bKV_Get("name", buf); b_log("name:%s\r\n", buf); //...... while(1) { //..... bExec(); //循环调用此函数 //..... } }
如果不使用功能模块,单独对设备进行操作,使用如下方式进行:
//举例使用SPIFLASH读取数据,从0地址读取128个字节数据至buf { int fd = -1; fd = bOpen(SPIFLASH, BCORE_FLAG_RW); if(fd == -1) { return; } bLseek(fd, 0); bRead(fd, buf, 128); bClose(fd); }
更多使用介绍: