【EG800Z-CN】获取开机原因
本案例使用mk体育pico开发板和UniRTOS，实现了一个获取模组开机原因的简单示例。在程序开发过程中，难免会遇到模组重启的情况，此时可通过获取开机原因来判断异常重启的根源，这对调试程序异常十分有利。
- 开机原因
项目概述
本案例使用mk体育pico开发板和UniRTOS，实现了一个获取模组开机原因的简单示例。在程序开发过程中，难免会遇到模组重启的情况，此时可通过获取开机原因来判断异常重启的根源，这对调试程序异常十分有利。
功能特性
基于专用API的精准开机溯源
- 实时开机原因识别：程序启动后立即调用底层功能函数，精准获取并解析本次系统上电的原因。
- 全面原因覆盖：支持识别多种开机触发源，包括但不限于：主电源上电（Power-On）、软件指令重启（Soft Reset）等。
- 单次高效查询：仅需一次函数调用即可完成原因获取，无需持续轮询，资源消耗极低。
开发准备
硬件要求
- pico开发板，点此购买开发板。
- USB数据线（USB-A转USB-C），点此购买。
软件要求
- unirtos-toolchain.exe：编译工具链安装程序，点此获取。
- Python：用于运行unirtos-cli工具，需使用3.9及更高版本。安装步骤见快速启动-环境搭建章节。
- Git：unirtos-cli使用该工具拉取SDK、依赖库等，需使用2.40及更高版本。安装步骤见快速启动-环境搭建章节。
- unirtos-cli：UniRTOS的命令行工具，用于一键拉取SDK、快速创建工程。安装步骤见快速启动-环境搭建章节。
- USB驱动：用于PC识别模块的USB枚举接口，点此获取。
- QFlash.exe：模块固件烧录程序，用于烧录UniRTOS编译生成的固件，点此获取。
- EPAT工具：芯片厂商提供的日志抓取工具，用于查看模块运行日志以分析应用程序执行情况，点此获取。
快速上手
下载项目
示例代码位于UniRTOS官方创客仓库，点此访问下载。
开发环境搭建
参考?UNIRTOS 快速入门?文档，了解如何搭建开发环境并完成基本开发流程。
项目结构
boot_reason/
├── main
├── inc # 存放项目头文件
└── boot_reason.h # Demo头文件
└── src # 存放项目源码
└── boot_reason.c # Demo源代码
├── media # README所需媒体文件
├── menucongfig # 项目配置的功能选项
├── CMakeLists.txt # Demo构建脚本
└── env_config.json # UniRTOS工程环境配置代码拉取
新开启一个PowerShell窗口，执行以下命令：
# 拉取示例仓库
unirtos-cli new -r unirtos-maker-examples
# 进入该项目
cd unirtos-maker-examples/boot_reason
构建项目
拉取编译环境
unirtos-cli env-setup
在PowerShell窗口执行固件编译命令（如使用模块型号非EG800ZCN_LA，请替换实际需要编译的型号）：
unirtos-cli build -m EG800ZCN_LA -v EG800ZCNLAR01A01_OCPU_20260626
等待编译结束后，PowerShell 窗口末尾会提示固件编译结果：
SUCCESS: Unirtos project built successfully!
硬件连接
使用USB数据线连接开发板和电脑即可。
日志展示
固件烧录后开机启动，可在日志中看到类似输出：
[boot_reason]Enter UniRTOS Power DEMO!
[boot_reason]Boot from power key
代码概览
主要功能接口
unir_pwkey_demo_init??
- 功能：这是整个Demo演示功能的入口点。它的主要职责是创建并启动一个独立的任务（线程），让具体逻辑在后台运行，而不阻塞主程序。
- 关键操作：
- 任务创建：调用qosa_task_create来创建一个名为power_demo的新任务。这个新任务将执行unir_pwrkey_demo_boot_cause函数。
- 重要性：这是用户需要在自己的应用初始化流程中注册的函数。
unir_pwrkey_demo_boot_cause?
- 功能：获取开机原因，根据结果打印信息。
- 关键操作：
- 获取原因：调用qosa_power_get_boot_cause，得到开机原因返回值。
- 日志打印：根据返回值，选择对应的结果，输出日志。
常见问题
程序一直在自己重启？
这是由于unir_pwrkey_demo_process中的自动重启函数导致的。请根据测试需求自行选择是否使用，如无需使用，请将其注释掉。