面向MCU的小型前后台系统

只看该作者 · 2025-1-26 22:37

JxOS简介
JxOS面向MCU的小型前后台系统，提供消息、事件等服务，以及软件定时器，低功耗管理，按键，led等常用功能模块。
gitee仓库地址为（复制到浏览器打开）：
https://gitee.com/jeremyceng/JxOS/tree/masterJxOS├───demo_code 参考代码，未整理代码│├───jxos jxos│ ├───bsp 过时分类，将逐步归类到 driver 和 lib 中│ ├───kernel 内核，提供系统内核功能：任务、事件、消息、公告板、邮箱、管道、注册、内存分配……│ ├───driver 使用静态初始化的功能代码模块，使用config.h文件进行配置；此目录下的代码大部分与硬件相关，如：传感器、按键扫描、屏幕…… （driver 与 lib 有时并没有清晰的界限，如driver:led_blink 就有可能抽象成 lib:sw_pwm）│ ├───lib 使用动态初始化的功能代码模块，使用初始化函数进行配置；此目录下的模代码大部分与硬件无关，如：环形缓冲区、crc16、栈、软件定时器…… │ ├───sys_service 基于任务实现的系统服务，如：低功耗管理、软件定时器、打印输出……（只有对外接口，不发出对外消息）│ └───std_app 基于任务实现的常用标准应用，如独立按键扫描、按键多次点击、指示灯闪烁……（此类模块和user app属于同一级别，只不过已经标准化；此类模块发出对外消息，也有对外接口，用于兼容不能支持消息功能的硬件平台）│├───platform│ ├───N76E003 ┐│ ├───N76E003 ├─── 基于 jxos 实现的，使用不同平台硬件的具体项目│ └───STM8S103K3 ┘│├───JSnet ┐├───.... ├─── 基于 jxos 实现的功能模块└───SRTnet ┘

kernel 提供系统内核功能：任务、事件、消息、公告板、邮箱、管道、注册、内存分配……
driver 使用静态初始化的功能代码模块，使用config.h文件进行配置；此目录下的代码大部分与硬件相关，如：传感器、按键扫描、屏幕…… （driver 与 lib 有时并没有清晰的界限，如driver:led_blink 就有可能抽象成 lib:sw_pwm）
lib 使用动态初始化的功能代码模块，使用初始化函数进行配置；此目录下的模代码大部分与硬件无关，如：环形缓冲区、crc16、栈、软件定时器……
sys_service 基于任务实现的系统服务，如：低功耗管理、软件定时器、打印输出……（只有对外接口，不发出对外消息）
std_app 基于任务实现的常用标准应用，如独立按键扫描、按键多次点击、指示灯闪烁…… （此类模块和user app属于同一级别，只不过已经标准化；此类模块发出对外消息，也有对外接口，用于兼容不能支持消息功能的硬件平台）
platform 基于 jxos 实现的，使用不同平台硬件的具体项目
在某些编译器环境下可能出现以某些限制（不支持函数指针，不支持中断处理函数中调用其他函数，不支持函数指针带参数，不支持结构体），因此 std_app 提供的消息可能无法使用，作为补充std_app 也会同时提供全局变量来传出信息和函数接口来传入信息
为提高代码的兼容性；尽量不要使用函数指针
为提高代码的可复用性，std_app 中的功能尽量在 driver 和 lib 中实现，std_app 中的代码仅作为提供系统tick和统一对外接口的功能
模块和 std_app 可以提供多个不同实现方法的文件，但保持对外接口的统一
对外提供两套接口方案 jxos_public.h 提供高级接口（消息事件等），jxos_public_lite.h 提供低级接口（全局变量，函数）
Instructions
- 导入 jxos_public.h 即可调用系统所有的对外接口
- 每个项目通过 jxos_init_config.c 和 jxos_config.h 对系统进行配置，即每个项目有独立配置文件
- 在 jxos_init_config.c 实现需要硬件支持的系统模块硬件初始化，以及用户任务的初始化顺序
- 在 jxos_config.h 配置系统模块的参数和使能
- event 用于任务内部的信号同步，主要是将中断信号传递到任务
- msg 用于任务之间的消息传递，使用 jxos_msg_get_handle 可通过消息名（字符串）获取消息句柄
如何建立新项目：获取 Jxos 所有文件和目录结构在 \platform 目录下建立当前工程的目录（platform\芯片型号\工程命名\）在 \工程名称目录下新建工程文件（keil、iar 等IDE的newproject）在 \工程名称目录下新建 \config 目录，增加 jxos_config.h type.h 系统配置文件在 \config 目录下增加工程用到的功能模块的配置文件（如 button_config.h sim_timer_config.h ...）在 \工程名称目录下新建 \framework 目录在 \framework 目录下增加 main.c ，实现main函数，在main函数中调用jxos_run() （ void main(void) {jxos_run();} ）在 \framework 目录下增加 isr.c ，实现工程需要的中断处理函数在 \framework 目录下增加 callback_handler.c ，实现工程用到的功能模块的callback函数建议在 \工程名称目录下新建 \app 目录，实现用户功能任务建议在 \芯片型号目录下增加芯片需要用到的库文件目录在IDE的新工程中导入 jxos.c 在IDE的新工程中导入需要的Jxos模块的文件（kernel、sys_service ...）在IDE的新工程中导入 main.c， isr.c， callback_handler.c 在IDE的新工程中导入用户任务文件（\工程名称\app\）在IDE的新工程中增加include目录，包括：\joxs，\platform\芯片型号\工程命名\config 在IDE的新工程中增加其他的include目录，如芯片库文件的头文件按照框架实现用户任务如何配置与使用 kernel如何配置与使用 sys_service如何配置与使用 std_app如何使用标准框架的 driver 模块如何使用标准框架的 lib 模块