这是一款由EG800Z系列QuecDuino开发板与二十余种传感器及执行器深度融合打造的入门级实验套件。
QuecDuino入门级传感器实验套件，是专为初学者、创客及教育领域量身定制的一站式开发平台。它完美继承了Arduino开源硬件的易用基因，并创新性地集成了移远通信（Quectel）领先的蜂窝网络技术，让您的物联网构想摆脱繁琐配置，轻松照进现实。
产品特点
- 物联网开发：不同于传统的 Arduino Uno，本套件内置网络通信能力，让你写的代码可以直接连接互联网，无需依赖电脑或额外的 WiFi 模块。
- 工业级稳定性：采用移远通信 (Quectel) 工业级模组，适应 -35℃ 到 85℃ 的宽温工作环境，不仅适合学习，也适合工业原型验证。
- 传感器丰富：多达数十种传感器外设供用户学习使用，丰富的硬件组合能完美还原真实的物联网开发需求。
!! 本仓库收录 QuecDuino 入门级传感器实验套件搭配使用的基于 UniRTOS 开发平台的实验案例。
更多关于 UniRTOS 平台开发方式，请访问 UniRTOS文档中心
| Module | 描述 | |
|---|---|---|
| 01 | LED Module | 基础 IO 输出控制案例，通过高低电平实现 LED 亮灭，是嵌入式入门最基础的数字输出实践。 |
| 02 | Single Button Module | 基础 IO 输入检测案例，实现按键按下 / 松开逻辑，学习按键状态识别。 |
| 03 | RGB LED Module | 实现红 / 绿 / 蓝三原色混色。 |
| 04 | Microphone (MIC) Module | 检测周围环境中的声音强度。 |
| 05 | Buzzer Module | 蜂鸣器控制案例，可实现固定音调提示音。 |
| 06 | Water Level Detection Module | 电阻式液体检测传感器，检测水位高度、有无水、漏水报警等场景。 |
| 07 | Reed Switch Module (KY-025) | 干簧管磁感应开关，靠近磁铁时触发通断信号。 |
| 08 | Obstacle Detection Module (KY-032) | 障碍物检测模块是红外反射式数字检测器件，也叫红外避障模块，用于近距离障碍物检测、循迹、避障、限位触发。 |
| 09 | Mini Reed Switch (KY-021) | 迷你磁簧，全称迷你磁簧开关（干簧管模块），是一种利用磁场控制通断的无源开关组件，这类磁性感应器件一般作为门磁检测、位置检测、限位触发使用。 |
| 10 | Photoresistor Module (KY-018) | 光敏电阻传感器是一种能够将光信号转换为电信号的传感器，其阻值会随着光照强度的变化而改变。 |
| 11 | Flame Detection Module (KY-026) | 火焰检测模块是用于探测火焰 / 明火的传感器模块，通过接收火焰产生的红外光，输出高低电平信号，实现火灾报警、火源检测。 |
| 12 | Magic Light Cup Module (KY-027) | 魔术光环模块（KY‑027）是倾斜感应 + LED 发光二合一数字模块，内置水银开关与高亮 LED，用于倾斜检测、姿态触发、状态指示、创客互动项目。 |
| 13 | Tilt Switch Module (KY-020) | 倾斜开关是姿态感应数字开关器件，也被称作滚珠开关、倾倒传感器，常用于倾斜检测、防倒保护、姿态触发、智能报警场景。 |
| 14 | Ultrasonic Module (HC-SR04) | 基于声波反射的距离测量传感器，通过发射与接收超声波计算物体距离，常用于小车测距、障碍物检测、液位 / 水位测量场景。 |
| 15 | Human Touch Module (KY-036) | 电容式触摸检测传感器，通过人体触碰改变电容信号，实现触摸开关、触摸按键功能，替代传统机械按键提升交互体验。 |
| 16 | Digital Tube Module (JY005) | 单位数码管模块是数字显示器件，由 7 段发光二极管组成，用于显示 0-9 数字及简单符号，广泛用于计数、计时、状态显示、创客 DIY 场景。 |
| 17 | Laser Transmitter Module (KY-008) | 激光发射模块通过半导体激光二极管，将电能高效转化为激光发射出去。它广泛用于激光测距、激光雷达、光纤通信、激光指示、红外夜视等场景。 |
| 18 | Mercury Switch Module (KY-017) | 水银开关模块，常用于倾斜报警、防倒保护、姿态检测、触发控制场景。 |
| 19 | Temperature & Humidity Sensor (AHT20) | 温湿度传感器作为常见的传感器之一，是一种装有湿敏和热敏元件，能够用来测量温度和湿度的传感器装置。 |
| 20 | Analog Piezoelectric Vibration Sensor | 模拟压电陶瓷震动传感器是一款用于检测振动、碰撞或者声波的传感器模块。它使用压电陶瓷技术，能够在受到压力或震动时输出相应的模拟信号。 |
- 一块移远通信提供的pico开发板 (下文以该开发板为例)。
- USB数据线（USB-A转USB-C）。
- PC (Windows)。
- unirtos-toolchain.exe：编译工具链安装程序，点此获取。
- Python：用于运行unirtos-cli工具，版本要求3.9及更高版本。
- Git：unirtos-cli使用该工具拉取SDK、库源码等，版本要求2.20及更高版本。
- unirtos-cli：UniRTOS的命令行工具，用于一键拉取SDK、快速创建工程。
- USB驱动：用于PC识别模块的USB枚举口，点此获取。
- QFlash.exe*：模块固件烧录程序，用于烧录UniRTOS编译生成的固件，点此获取。
- EPAT工具：芯片厂商提供的日志捕获工具，用于查看模块运行日志以分析应用程序执行情况，点此获取。
- QCOM工具：移远通信提供的COM口工具程序，用于执行和验证AT命令，点此获取。
在固件编译烧录前需要保证软件环境配置完成，参考快速上手。
打开一个新的PowerShell窗口，执行以下命令：
unirtos-cli ls-demos执行结果如图：
unirtos-cli ls-demos [-f] [-j] [-d <project-dir>]- 功能描述：输出出远程Demo及其版本列表。
- 参数说明：
| 参数 | 说明 |
|---|---|
| -f, --force | 强制更新*<unirtos_root>/demos/manifests*（忽略1小时更新间隔） |
| -j, --json-output | 添加该参数后，结果将以JSON格式输出 |
| -d, --project-dir | 起始目录。命令会从该目录开始，向上逐级查找env_config.json配置文件；如果找到，则使用其中定义的unirtos_root路径，否则使用默认路径*~/.unirtos*。 |
继续在PowerShell窗口执行以下命令：
unirtos-cli new -r unirtos_helloworld_demos -d E:\unirtos-cli_demos执行完成后，工具将自动从官方Demo仓库下载helloworld示例，并生成新的项目工程。
执行结果如图：
unirtos-cli new [-r] <project-name> [-v <version>] [-d <project-dir>] [-f]- 功能描述：创建一个新的项目，支持两种模式：一种是基于模板创建，另一种是直接基于现有Demo创建。
- 参数说明：
| 参数 | 默认值 | 说明 |
|---|---|---|
| project-name | 必填 | 项目名称（仅限名称，不可包含路径分隔符），不能与-r参数同时使用 |
| -r, --from-demo | 关闭 | 基于远程已有的 Demo 创建项目 |
| -v, --version | 省略 | 指定远程Demo的版本（支持 1.0.0、v1.0.0 等格式）。该参数仅可与参数-r同时使用；省略时自动选用最新版本 |
| -d, --project-dir | .（当前目录） | 指定项目基目录。项目最终会创建在*/*路径下 |
| -f, --force | 关闭 | 强制更新*<unirtos_root>/demos/manifests*后再基于Demo创建。该参数仅可与-r同时使用 |
打开PowerShell窗口，进入创建的工程目录（unirtos-cli new命令-d参数携带的路径），执行以下命令：
unirtos-cli env-setup执行命令后，unirtos-cli会根据env_config.json的默认配置从远程拉取SDK到本地，默认存放路径为C:\Users\<用户名>\.unirtos。后续拉取相同版本时，将直接复用本地已缓存的SDK，无需再次从远程下载。
命令执行结果如图：
unirtos-cli env-setup [-d <project-dir>]- 功能描述：根据env_config.json的配置，拉取指定版本的SDK和所有依赖库到本地存储目录。
- 参数说明：
| 参数 | 默认值 | 说明 |
|---|---|---|
| -d, --project-dir | .（当前目录） | 包含env_config.json的项目目录 |
环境拉取完成后，项目目录下会自动生成一个VS Code工作区文件。双击打开该文件，工作区将同时包含当前项目及拉取的SDK，方便使用VS Code开发时直接查看SDK中的函数头文件、附加组件等内容。
进入新创建的工程所在目录。如图：
unirtos_helloworld_demos-1.0.0/
├── CMakeLists.txt // CMake构建脚本
├── env_config.json // unirtos-cli使用的环境配置文件
├── hello_world.c // 应用源代码
├── README.md // 应用说明文档
└── unirtos_hel....code-WorkSpeace // VS Code项目工作区文件
默认路径为C:\Users\ <用户名> \ .unirtos，拉取的SDK位于该路径下的“sdk”目录。如图为1.0.1版SDK：
目录树：
├─cmake // CMake相关配置文件
├─qos_applications/ // 用于存放应用示例于业务代码
│ ├─app_init // App层初始化相关文件
│ └─unirtos_std // AT侧相关功能
├─qos_components/ // 系统组件与中间件
│ ├── components/ // 可裁剪功能组件
│ └── system/ // 系统服务、驱动、协议栈
├─qos_kernel/ // 存放平台内核适配相关工程
│ └── eigen_718/ // 典型平台适配
└─qos_tools // 编译及调试工具
│ └── python/ // 构建/配置/打包 Python工具
├─build.sh // 一键构建脚本
├─CMakeLists.txt // UniRTOS编译的主CMake工程文件
├─Kconfig // 主配置入口，管理宏控依赖及约束条件
└──...
如果实际使用非EG800ZCN_LA模组，需要修改编译其他实际使用的型号，如“EC800ZCN_LF”。当前指定编译EG800ZCN_LA固件，在工程目录下打开powershell窗口，输入命令：
unirtos-cli build -m EG800ZCN_LA -v EG800ZCNLAR01A01_OCPU_20260625在PowerShell窗口执行固件编译命令，等待编译结束后，在日志末尾会提示固件编译结果，编译成功如图所示：
unirtos-cli build [-d <project-dir>] [-j <jobs>] [-m <module>] [-v <version>]- 功能描述：调用UniRTOS工具链编译当前外部应用。
- 参数说明：
| 参数 | 默认值 | 优先级 | 说明 |
|---|---|---|---|
| -d, --project-dir | .（当前命令执行路径） | — | 项目目录 |
| -j, --jobs | 4 | CLI > env_config.build.jobs > 4 | 并行编译线程数 |
| -m, --module | env_config.build.module | CLI > env_config.build.module | 模块名，例如 EG800ZCN_LA |
| -v, --version | 应用根目录名称 | CLI > env_config.build.version > 应用根目录名称 | 固件版本字符串 |
固件包输出路径位于项目目录的“qos_build\release”路径下。
打开QFlash程序，点击“Load FW Files”：
选择对应工程目录下qos_build\release文件夹中的*.hbinpkg*文件。
设备长按电源键开机，打开设备管理器，查看“端口 (COM和LPT)”中的Quectel USB AT Port，记录COM通道号：
打开QCOM，选择AT口(通过设备管理器查看)，输入“AT”，验证固件是否烧录成功，回复“OK”表示成功。
点击“Device Communication”，选择串口设备并点击“打开”：
选择设备管理器中的Quectel USB DIAG Port通道，点击“OK”查看日志输出：
点击“Database State”，选择数据库文件以匹配日志数据库：
选择qos_build\release自定义版本文件夹下的DBG/comdb.txt文件，点击“Update”：
在“UniLogViewer”选项卡，点击“Stop”停止日志记录：
使用“Ctrl+F”搜索“hello world”，点击“Find Previous”查看hello world程序日志：
欢迎参与共建，建议按以下方式提交：
- 提交前先执行一次基础验证：env-setup、build、clean。
- 使用清晰的提交说明，描述改动目的、影响范围和验证结果。
- 新增功能或行为变化时，同步更新 README 与相关文档。
- 通过 Issue 或 Pull Request 提交问题修复与功能改进。