行空板K10信息科技实验盒(基础版)
前言
随着信息技术在现代教育体系中的核心地位愈发显著,有效实施信息科技课程已成为教育工作者肩负的重要职责。在此背景之下,行空板K10信息科技人工智能实验盒应运而生,专为满足中小学信息科技课程的教学需求而精心打造。这款教学辅助工具旨在为广大教师和学生提供一个功能全面、易于操作的学习平台,助力大家轻松探索信息技术的无限魅力。
行空板K10信息科技人工智能实验盒集成了摄像头、双麦克风、小音箱等一系列关键组件,无需额外外接设备,即可轻松实现从基础传感器实验到复杂人工智能项目的全方位实践探索。其内置的丰富传感器种类(输入输出控制、环境感知、运动方向感知、障碍检测),结合先进的SIoT(智能物联网)技术,能够帮助学生构建完整的物联网信息系统。同时,内置的RFID(无线射频识别)模块也为教学带来了更多创新的灵感和可能。
此外,行空板K10信息科技人工智能实验盒凭借其高集成度和人性化的收纳设计,在教学场景中展现出极高的实用性。它不仅便于携带,还大大提升了教学效率,助力教师更高效地开展信息技术课程教学,促进学生对信息科技知识的深入理解和掌握。
目标
-
介绍行空板K10信息科技实验盒的主要组件及其功能,帮助用户熟悉各部分的使用方法。
-
指导用户进行基本的硬件连接和软件安装,以便顺利开启行空板K10信息科技实验盒的奇妙之旅。
-
提供基础示例项目,帮助用户通过实际操作来熟悉行空板K10信息科技实验盒的使用,从而掌握关键的技术概念和技能。
适用对象
-
中小学信息科技课程相关的教师及学生:这款实验盒将成为你们教学和学习过程中的得力助手,助力你们轻松掌握信息技术的精髓。
-
对开源硬件和机器人感兴趣的初学者及爱好者:无论你是初学者还是有一定基础的爱好者,行空板K10信息科技实验盒都将为你提供一个充满挑战和乐趣的学习平台。
-
已经使用过行空板K10的用户:如果你已经对行空板K10有所了解,那么本手册将帮助你更深入地挖掘其潜力,探索更多有趣的应用场景。
让我们一起携手踏上这段充满挑战和乐趣的信息科技之旅吧!本文将带你深入探索行空板K10信息科技实验盒的强大功能和多种应用场景,从简单的操作入手,到复杂的项目实施,共同探索信息技术的无限可能性!
一、行空板K10信息科技实验盒通用知识
行空板K10信息科技实验盒是一款专门为满足信息科技课程标准而设计的多功能、高集成的教育实验箱套件。它方便收纳,适合大班教学,能帮助老师高效展开信息科技课程。
1.1 主要特点
-
以行空板K10为核心,搭配摄像头、双麦克风、小音响可实现各类人工智能项目。
-
集成丰富的输入、输出类传感器,接入SIoT可搭建完整的物联网信息系统。
-
提供丰富的扩展接口,支持更多功能的开发。
-
结合教材需求,能够完成过程与控制、物联网、AI等常见项目的实践。
1.2 板载功能
注:5路巡线传感器,电机,三轴陀螺仪属于高配版中的功能。
1.3 详细功能说明
核心部分
行空板K10实验盒以行空板K10为核心,MCU、WIFI、蓝牙等核心参数,可以跳转到行空板K10 WIKI 了解核心部件。
传感器&执行器
| 功能 | 说明 |
|---|---|
| 屏幕 | 2.8寸 240x320 彩色 LCD |
| 光线传感器 | 检测范围:0~64k Lux |
| 加速度传感器 | 三轴加速度 |
| 温湿度传感器 | 温度:-40-85℃ 精度±0.3℃湿度:0-100%RH 精度±2%RH |
| 实体按键 | ON/OFF按键:长按可开机/关机A按键(上按键):与K10单板上A按键功能一样B按键(上按键):与K10单板上B按键功能一样左按键:P8右按键:P9RST:复位按键BOOT:硬件初始化按键 |
| 电导开关 | 引脚:P10输出类型:高低电平 |
| 红外传感器 | 引脚:P13输出类型:高低电平检测距离:9~15cm备注:该传感器可拆卸,出厂时已经安装好。 |
| RFID模块 | 通信接口: I2C最大检测距离:不低于3cm |
| 摄像头 | 200W像素,60度镜头 |
| 红黄绿LED灯 | 直径:8mm输出类型:高低电平红灯和黄灯支持PWM控制 |
| RGB LED灯 | 侧发光 RGB灯 x 4亮度显示:0~255全彩:1600万色 |
| 喇叭 | 方形喇叭 |
| 红外接收传感器 | 红外接收x 1 |
| MEMS麦克风 | MEMS麦克风 x 2 |
| 蜂鸣器 | 蜂鸣器 x 1 |
接口
| 功能 | 说明 |
|---|---|
| USB Type-C接口 | 用于连接PC编程或供电 |
| TF卡接口 | 用于扩展存储空间 |
| 3Pin I/O | P0,P1,P2,P3 |
| 4Pin I2C | 2路I2C接口 |
| 2Pin 水泵接口 | P4 |
指示灯
| 功能 | 说明 |
|---|---|
| 电量指示灯 | 状态:白色,紫色,红色白色表示电量50%~100%,紫色表示电量25%~50%,红色表示电量0%~25%。 |
| USER指示灯 | 状态:闪烁红色USER灯闪烁表示系统正常运行 |
| POWER指示灯 | 状态:红色电源灯,开机就显示红色 |
| 充电指示灯 | 状态:绿色接上充电线时一直亮绿色,充满电后熄灭 |
电源
| 功能 | 说明 |
|---|---|
| 供电 | 18650电池供电 |
| 工作电压 | 3.3V |
| 最大工作电流 | 1500mA |
1.4 尺寸
长x宽x高:160mmx120mmx33mm
![]() |
![]() |
1.5 存储卡操作
行空板K10信息科技实验盒的左侧上方,有一个micro SD卡槽,高配版的行空板K10信息科技实验盒,在出厂时插好了内存卡。
-
取卡操作:通过按压弹出的方式进行取卡,切勿强行取卡,以免损坏卡槽或存储卡。
-
插卡操作:将SD插入卡槽中,听到卡被扣住的声音,才算插卡完成,插入方式见下面操作图。
1.6 行空板K10通用知识
行空板K10是一款专为快速体验物联网和学习人工智能而设计的开发学习板,100%采用国产芯片,知识产权自主可控,符合信息科技课程中编程学习、物联网及人工智能等教学需求。行空板K10的核心特点如下:
1. 高度集成:行空板K10集成了LCD彩屏、WiFi蓝牙、摄像头、麦克风、扬声器、RGB指示灯、多种传感器及丰富的扩展接口,无需额外连接其他设备,便可轻松实现传感器控制、物联网应用以及人脸识别、语音识别、语音合成等人工智能项目。
2. 人工智能算法集成:内置了基础的图像检测、语音识别、语音合成等AI算法,并集成了摄像头、麦克风、扬声器等器件,助力广大师生轻松开始AI学习。
3. 大尺寸全彩显示屏:配备了2.8寸全彩显示屏,分辨率高,色彩丰富,为创意提供了无限可能,无论是制作精美的图形界面还是展示丰富多彩的图像,都能让作品更加生动有趣。
4. 物联网支持:可作为物联网系统中的终端节点使用,满足物联网教学需求,集成了WiFi和蓝牙模块,全面支持物联网应用。
5. 接口丰富、可扩展性强:拥有丰富的扩展接口,支持板载接口和金手指接口,可以根据自己的需求连接各种外部设备,拓展更多的功能。
6. 多种编程方式:支持图形化编程和MicroPython编程,无论编程新手还是经验丰富的科创老师,都能找到适合自己的编程方式。
- 更多详细内容,请查看行空板K10官方文档。
二、编程平台
- 下载官方mind+软件或在线版:https://mindplus.cc/
2.1 上传模式的使用
2.1.1 使用Mind+图形化编程
-
其中v1.8版本 下载方法请参考行空板K10快速使用教程中的4.软件准备
-
编程软件打开后,切换到“上传模式”,并点击“扩展”,在“主控板"中,选择”行空板K10“。
-
行空板K10信息科技实验盒对应的内置模块库,需要在“扩展”的“用户库”中,使用链接进行检索并加载:
行空板K10信息科技实验盒库链接:https://gitee.com/zhaoruiz/ext-unihiker-k10-box
-
添加完成后,点击“返回”,切换到编程界面。
-
-
v2.0版本和在线版本,进入界面与1.8版本不同
- 打开后,在程序设计下,选择上传模式。

- 点击“扩展库”,找到“主控板”下的“行空板K10”模块点击完成添加,点击返回后,就可以在“指令区”找到行空板K10,然后通过先点击下载,下载成功后再次点击,完成行空板K10加载。

- 然后在模块扩展部分检索、下载并加载实验盒。

- 添加完成后,点击“返回”,切换到编程界面。

- 打开后,在程序设计下,选择上传模式。
2.1.2 连接主控-行空板K10
-
使用USB线将行空板K10信息科技实验盒与电脑进行连接,连接成功后,长按开/关机键“ON/OFF”,等待“POWER”指示灯亮起。
-
在Mind+中,点击菜单栏的“连接设备”,找到对应的“UNIHIKER K10”设备,并点击,完成设备连接。
-
编写程序,分别在行空板K10信息科技实验盒屏幕上的第2、4、6行,显示不同颜色的文字”K10信息科技实验盒“。
-
点击“上传到设备”,等待程序上传完成。
-
程序上传成功后,K10屏幕上,显示不同颜色的文字“K10信息科技实验盒”。
-
若编译任何代码都报错,请查看:公测版解压问题
-
特别提示:行空板K10单板上完成的程序,都可以在行空板K10信息科技实验盒上运行。
2.2 Micropython代码模式的使用
Micropython代码模式仅在Mind+ v2中支持使用,在线版和软件都支持。
| 使用方式 | 入口 | 说明 |
|---|---|---|
| Mind+ 2.0 软件版 | Mind+ 官方下载页 | 连接稳定,适合课堂电脑固定安装使用 |
| Mind+ 在线版 | https://ide.mindplus.top/home/ | 适合无需安装软件的在线编程场景 |
2.2.1 使用Mind+编程
-
选择micropython 代码编辑模式

-
打开编辑器,选择设备
2.2.2 连接主控
-
与Mind+编程软件连接
用usb线将K10接入电脑,然后在编辑界面点击“连接设备”,在弹出的窗口中选择连接com口,点击“连接”完成设备连接。

- 首次连接会自动烧录固件,烧录过程和完成后的图示如下:

- 首次连接会自动烧录固件,烧录过程和完成后的图示如下:
-
编写自己的项目程序
选择打开项目,打开一个项目文件夹,开始编写程序

-
快速打开程序
打开并运行程序
在编辑界面的左侧“项目文件”中选择“打开文件夹”,然后选择要打开的项目文件夹。
注意:Micropython代码编程只能在本地项目文件夹内完成代码文件的保存。

打开项目文件夹后,我们就能看到项目程序文件,此时软件会自动创建main.py程序。

单击要运行的活动程序文件,就能在右侧看到程序,直接点击运行观察程序运行情况。

三、行空板K10信息科技实验盒基础使用说明
3.1上传模式
3.1.1传感器
角度传感器
| 积木 | ![]() |
| 功能说明 | 读取板载角度传感器的值。当传感器顺时针转动时,返回的值会增大;逆时针转动时,值会减小。输出值的范围为 0 到 4095。 |
示例项目:在主控屏幕上,绘制矩形框,并通过转动角度传感器来填充矩形框。
示例程序:
示例效果:
声音传感器
| 积木 | ![]() |
| 功能说明 | 读取声音强度,检测到的声音越大,数值越高。 |
示例项目:将获取到的声音强度值,实时的显示在K10屏幕上。
示例程序:
示例效果:

按键
| 积木 | ![]() |
| 功能说明 | 该指令用于判断试验箱上板载的上(A)、下(B)、左(P11)、右(P12)按键,是否被按下。 |
示例项目:在K10屏幕上绘制一个小圆球,通过上下左右按键,控制K10屏幕上的小圆球进行上下左右移动。
示例程序:
示例效果:
电导开关
| 积木 | ![]() |
| 功能说明 | 该指令用于判断实验盒上的P10引脚是否被导通。 |
| 示例项目:当电导开关被接通后,K10屏幕上显示心形图案,否则,显示心碎图案。 | |
| 示例程序: |
示例效果:
红外检测传感器
| 积木 | ![]() |
| 功能说明 | 该指令用于判断红外传感器是否检测到前方是否有障碍物。 |
| 示例项目:实验盒前方的红外避障传感器检测到前方有障碍物时,K10屏幕上显示障碍物提示图片,否则,不显示。 | |
| 示例程序: |
示例效果:
RFID射频识别
| 积木 | ![]() |
| 功能说明 | 初始化RFID模块。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于向标签卡写入数据。注意:1. 白卡前4个数据块为只读区,不可写入数据。从第5个数据块开始,可以进行写入操作。2. 白卡的数据结构为每个数据块可存放4个字节数据,因此写入时,每个数据块只能写入4个字节。3. 圆形卡的所有数据块都是可读写操作的,并且每个数据块可以写入16个字节。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于从标签卡中,读取指定数据块的所有数据。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于从标签卡中,读取指定数据块指定指令字节的数据。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于读取标签卡的编号。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于判断检测到的标签编号,是否是我们填入的编号。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于判断在检测区是否检测到标签卡。 |
示例项目-01:读取标签卡的UID编号,并将读取到的编号显示在K10屏幕上。
示例程序:
示例效果:
示例项目-02:当识别到白卡的编号(04b3e1b5)时,在K10屏幕上显示文字“欢迎回家”,当识别到其他编号的卡时,显示文字“请刷正确的卡”。
示例程序:
示例效果:
项目示例-03:通过实验盒上的左按键,向卡片的第5个数据块种的第一个字节写入数据10,然后通过按下右键,查看写入的数据是否成功。
示例程序:
示例效果:
3.1.2执行器
红绿灯
| 积木 | ![]() |
| 功能说明 | 该指令用于控制板载的红(P2)、黄(P3)、绿(P4)三个LED灯亮或灭。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于设置板载的红灯、黄灯、路灯的亮度。 |
示例项目:控制红黄绿三个灯执行三次亮灭后,再控制三个灯的亮度由灭——逐渐亮,再由亮——逐渐灭。
示例程序:
示例效果:
蜂鸣器
| 积木 | ![]() |
| 功能说明 | 控制蜂鸣器发出不同频率的声音。 |
| 积木 | ![]() |
| 功能说明 | 控制蜂鸣器停止发声。 |
示例项目:通过实验盒上的上下左右按键,控制蜂鸣器发出“哆瑞咪发”的声音。
示例程序:
RGB LED灯
| 积木 | ![]() |
| 功能说明 | 该指令用于初始化连接在P9引脚上的RGB灯。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于设置RGB灯的亮度。最低值为:0,RGB灯灭;最大值为:255,RGB灯最亮状态。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于控制RGB灯全部熄灭。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于设置指定的RGB LED灯的显示颜色。一共有4个RGB灯,灯的编号从0-3。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于将指定范围内的 RGB LED 灯设置为彩虹颜色效果 |
| 积木 | ![]() |
| 功能说明 | 该指令用于将所有 RGB LED 灯的颜色向前移动指定单位的位置。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于将所有RGB LED灯的颜色进行循环的旋转操作。颜色会根据指定的单位进行旋转。 |
| 积木 | ![]() |
| 功能说明 | 该指令用于通过RGB三原色的值,控制RGB ELD的灯颜色显示。每个颜色的值为0-255。 |
示例项目-01:分别设置4个RGB LED灯显示彩虹色,然后通过角度传感器控制RGB LED灯的亮度。
示例程序:
示例效果:
示例项目-02:通过将RGB灯循环移动一个单位,实现跑马灯的效果。
示例程序:
示例效果:
水泵开关
| 积木 | ![]() |
| 功能说明 | 控制水泵开启或关闭。 |
硬件连接:将水泵连接到P4水泵引脚。
示例项目:通过实验盒上的按钮,控制水泵开关。按下上键,打开水泵,按下下键,关闭水泵。
示例程序:
示例效果:
综合项目
项目1-土壤湿度控制好
硬件准备:
-
实验盒 x1
-
水泵 x1
-
土壤湿度传感器 x1
硬件连接:
示例项目:通过实验盒上的A、B按键调节土壤湿度阈值,当检测到的土壤湿度值小于设置的土壤湿度阈值时,水泵自动打开;否则,水泵自动关闭。
示例程序:
示例效果:
项目2-温控空调
硬件准备:
-
实验盒 x1
-
风扇模块 x1
硬件连接:
示例项目:实验盒上的上下按钮用于调节温度阈值,左右按钮用于开启或关闭空调。开始空调后,空调会自动判断当前的温度与温度阈值的大小,当当前温度大于预设温度时,空调自动开启(风扇转动);否则,空调关闭。
示例程序:
示例效果:
3.2 MicroPython代码模式
使用 USB 线将行空板 K10 连接到电脑,在 Mind+ 中选择 MicroPython 代码模式和对应串口。打开本地项目文件夹后,选择并运行程序文件;MicroPython 程序需保存在本地项目文件夹中。
本部分只展示核心基础的功能,大多数显示等功能与行空板K10保持一致,可进入下面链接查看:https://www.unihiker.com.cn/wiki/k10/micropython_unihiker_k10#%E6%98%BE%E7%A4%BA%E5%9B%BE%E5%BD%A2
3.2.1 基础功能程序
屏幕显示
功能:实验盒屏幕显示 Hello K10和 你好
from unihiker_k10 import screen
screen.init(dir=2)
screen.clear()
screen.show_bg(color=0xFFFFFF)
screen.draw_text(text="Hello K10", x=60, y=100, font_size=24, color=0x0000FF)
screen.draw_text(text="你好", x=60, y=200, font_size=24, color=0x0000FF)
screen.show_draw()
效果如图:

板载按键
功能描述:按下 A 或 B 键时,串口中对应状态值发生变化。
from unihiker_k10 import button
import time
bt_a = button(button.a)
bt_b = button(button.b)
while True:
print("A:", bt_a.status(), "B:", bt_b.status())
time.sleep(0.1)
示例效果:同时按下A/B键,观察串口数据

温湿度传感器
功能描述:持续检测和输出环境温湿度数据。
from unihiker_k10 import temp_humi
import time
while True:
temp = temp_humi.read_temp()
hum = temp_humi.read_humi()
print("温度:", temp, "湿度:", hum)
time.sleep(1)
示例效果:串口持续输出当前温度和湿度数据。

光线传感器
功能描述:用手遮挡或用手电筒靠近光线传感器,串口中的数值会变化。
from unihiker_k10 import light
import time
while True:
light_value = light.read()
print("光照强度:", light_value)
time.sleep(1)
示例效果:

声音传感器
功能描述:读取环境声音强度,并通过串口持续输出数值。
from k10_box import voice
import time
while True:
sound_value = voice.read()
print("声音强度:", sound_value)
time.sleep(0.1)
示例效果:靠近声音传感器说话或拍手,串口中的声音强度数值会变化。

旋钮传感器
功能描述:读取旋钮的当前数值,并通过串口持续输出。
from k10_box import knob
import time
while True:
value = knob.read()
print("旋钮数值:", value)
time.sleep(0.1)
示例效果:转动旋钮后,从小到大变化。
加速度检测
功能描述:读取实验盒的运动强度,用于检测晃动状态。
from unihiker_k10 import acce
import time
while True:
strength = acce.read_strength()
print("加速度强度:", strength)
time.sleep(0.1)
示例效果:晃动实验盒时,串口输出的加速度强度发生变化。
LED
功能描述:控制实验盒 LED 周期性点亮和熄灭。
from k10_box import led
import time
while True:
led.red_digital(1)
time.sleep(1)
led.red_digital(0)
time.sleep(1)
示例效果:实验盒 LED 每隔 1 秒亮灭一次。
RGB灯
功能描述:RGB灯在彩色和紫色之间不断切换。
from unihiker_k10 import rgb
import time
#灯号(0,1,2,全部)显示颜色()
rgb.write(num = -1,color=0x0000FF)#可以用-1或不传num代表全部
time.sleep(1)
#灯号(0,1,2,全部)显示颜色R()G()B()
rgb.write(num = 0,R=255,G=0,B=0)
time.sleep(1)
#关闭(全部,0,1,2,3)RGB
rgb.write(num = -1,color=0x000000)
time.sleep(1)
while True:
rgb.write(color=0xFF00FF)
time.sleep(1)
rgb.write(num = 0, R=255,G=0,B=0)
rgb.write(num = 1, R=0,G=255,B=0)
rgb.write(num = 2, R=0,G=0,B=255)
rgb.write(num = 3, R=0,G=255,B=255)
time.sleep(1)
rgb.clear()
time.sleep(1)
rgb.write(color=0x0000)
time.sleep(1)
示例效果:
蜂鸣器
功能描述:控制蜂鸣器以指定频率短暂发声。
from k10_box import buzzer
import time
buzzer.play(349)
time.sleep(1)
buzzer.stop()
示例效果:蜂鸣器响 1 秒后停止。
水泵
功能描述:通过 P4 数字输出控制水泵打开,等待一会关闭。
from unihiker_k10 import pin
import time
water_pump = pin(4)
time.sleep(1)
water_pump.write_digital(1)
time.sleep(10)
water_pump.write_digital(0)
示例效果:连接在 P4 的水泵浇水 10 秒打后关闭。
舵机
功能描述:连接在 P1 的舵机会在 30° 和 150° 两个位置之间切换。
from unihiker_k10 import servo
import time
s1 = servo(1)
while True:
s1.angle(value=30)
time.sleep(1)
s1.angle(value=150)
time.sleep(1)
示例效果:
超声波
功能描述:测量距离,并输出。
from k10_box import sr04
import time
while True:
print(sr04.distance()) #读取超声波距离
time.sleep(0.1)
示例效果:
设备唯一标识
功能描述:读取设备唯一标识,并将其显示在实验盒屏幕上。
from unihiker_k10 import screen
import machine
unique_id = machine.unique_id().hex()
screen.init(dir=2)
screen.clear()
screen.show_bg(color=0xFFFFFF)
screen.draw_text(text=f"uuid: {unique_id}", x=10, y=120, font_size=24, color=0xFFA500)
screen.show_draw()
示例效果:

3.2.2 无线通信与物联网程序
RFID 近场识别
翻转实验盒,按模块版本选择 v1 或 v2 驱动。
RFID v1 / v2 代码选择
| RFID 版本 | 导入代码 | 背后显示 |
|---|---|---|
| v1 | from pn7150 import rfid |
RFID |
| v2 | from fm17550 import rfid |
RFID v2 |
功能描述:读取RFID卡的uuid。
rfid = rfid(sda=Pin(47), scl=Pin(48))
card = rfid.scanning(wait=False)
uid = card.read_uid()
读取卡片 UID
from machine import Pin
from pn7150 import rfid #根据版本切换修改,v1
from fm17550 import rfid #根据版本切换修改,v2
import time
rfid = rfid(sda=Pin(47), scl=Pin(48))
while True:
card = rfid.scanning(wait=False)
if card:
uid = card.read_uid()
print("UID:", uid)
time.sleep(1)
示例效果:

蓝牙 HID
功能描述:电脑连接蓝牙 mpy_hid 后,晃动实验盒可模拟按下空格键,按 A 键可模拟回车键。
from unihiker_k10 import hid, keycode, acce, button
import time
ble_hid = hid(name="mpy_hid")
bt_a = button(button.a)
while True:
print("蓝牙连接:", ble_hid.isconnected())
acc_strength = acce.read_strength()
if acc_strength <= 700:
ble_hid.keyboard_send(keycode.SPACE)
if bt_a.status() == 1:
ble_hid.keyboard_send(keycode.ENTER)
time.sleep(0.1)
示例效果:
WiFi 连接
功能描述:连接无线网络,串口输出网络连接状态和 IP 地址等信息
from k10_base import WiFi
wifi = WiFi()
wifi.connect(ssid="你的WiFi名称", psd="你的WiFi密码", timeout=50000)
print("连接状态:", wifi.status())
print("网络信息:", wifi.info())
示例效果:串口输出网络连接状态和 IP 地址等信息。

MQTT / SIoT 通信
连接 SIoT
from k10_base import WiFi, MqttClient
wifi = WiFi()
wifi.connect(ssid="你的WiFi名称", psd="你的WiFi密码", timeout=50000)
mqttclient = MqttClient()
mqttclient.connect(
server="你的SIoT服务器IP",
port=1883,
client_id="",
user="siot",
psd="dfrobot"
)
print("MQTT连接状态:", mqttclient.connected())
发布消息
mqttclient.publish(topic="siot/test", content="hello")
订阅消息
import time
def received_test():
msg = mqttclient.message(topic="siot/test")
print("收到消息:", msg)
mqttclient.received(
topic="siot/test",
callback=received_test
)
while True:
time.sleep(1)
操作步骤:
-
实验盒和电脑接入同一无线网络;
-
进入下载SIoT软件,并解压文件夹,双击start SIoT.bat 即可启动新版SIoT,启动之后会弹出小黑窗启动服务器。

-
在浏览器输入”计算机IP地址:8080“,输入账号 "siot" ,密码 "dfrobot",进入数据管理页。进入数据管理页后创建主题““siot/test””。

示例效果:

3.2.3 MicroPython 综合案例
项目1-环境数据采集
硬件准备
| 器材 | 数量 | 说明 |
|---|---|---|
| 行空板K10信息科技实验盒 | 1 | 使用板载温湿度、光线、声音传感器和屏幕 |
| USB 数据线 | 1 | 连接电脑和实验盒 |
示例项目:描述
运行程序后,实验盒持续采集环境数据。温度、湿度、光照数据显示在屏幕上,声音数据输出到串口,适合用于认识环境数据采集过程。
示例程序
from unihiker_k10 import temp_humi, light, screen
from k10_box import voice
import time
screen.init(dir=2)
screen.clear()
screen.show_bg(color=0xFFFFFF)
while True:
temp_c = temp_humi.read_temp()
humidity = temp_humi.read_humi()
light_level = light.read()
sound_level = voice.read()
screen.draw_rect(x=0, y=0, w=320, h=240, bcolor=0xFFFFFF, fcolor=0xFFFFFF)
screen.draw_text(text=f"温度: {temp_c}℃", x=60, y=60, font_size=24, color=0x0000FF)
screen.draw_text(text=f"湿度: {humidity}%", x=60, y=110, font_size=24, color=0x00FF00)
screen.draw_text(text=f"光照: {light_level}", x=60, y=160, font_size=24, color=0xFFA500)
screen.show_draw()
print("声音:", sound_level)
time.sleep(0.1)
示例效果
项目2-模拟智能楼梯灯
硬件准备
| 器材 | 数量 | 说明 |
|---|---|---|
| 行空板K10信息科技实验盒 | 1 | 使用板载光线传感器、声音传感器和红色 LED |
| USB 数据线 | 1 | 连接电脑和实验盒 |
示例项目
当光照强度小于设定阈值,并且声音强度大于设定阈值时,程序点亮红色 LED,模拟“夜间有人经过时楼梯灯亮起”的效果;否则红色 LED 熄灭。
示例程序
from k10_box import voice, led
from unihiker_k10 import screen, light
import time
screen.init(dir=2)
screen.clear()
screen.show_bg(color=0xFFFFFF)
screen.draw_text(text="声音强度:", x=40, y=60, font_size=24, color=0x0000FF)
screen.draw_text(text="光照强度:", x=40, y=120, font_size=24, color=0x0000FF)
screen.show_draw()
def update_display(sound_level, light_level):
screen.draw_text(text=str(sound_level), x=160, y=60, font_size=24, color=0x0000FF)
screen.draw_text(text=str(light_level), x=160, y=120, font_size=24, color=0x0000FF)
screen.show_draw()
while True:
sound_intensity = voice.read()
light_intensity = light.read()
update_display(sound_intensity, light_intensity)
print(f"光: {light_intensity}, 声: {sound_intensity}")
if light_intensity < 300 and sound_intensity > 65:
led.red_digital(1)
led_status = "ON"
time.sleep(3)
else:
led.red_digital(0)
led_status = "OFF"
示例效果
用手遮住光线传感器,并对着声音传感器说话,红色 LED 点亮。

项目3-门铃通知即时到
硬件准备
| 器材 | 数量 | 说明 |
|---|---|---|
| 行空板K10信息科技实验盒 | 2 | 一台作为门铃端,一台作为用户端 |
| USB 数据线 | 2 | 分别连接两台实验盒 |
| 运行 SIoT 的电脑 | 1 | 作为 MQTT / SIoT 服务器 |
项目框架
本项目模拟物联网门铃系统。输入端为门铃端 A 键,计算与转发由 SIoT / MQTT 服务完成,输出端为用户端屏幕提示信息。
两台实验盒均通过 USB 连接电脑并连接同一 WiFi。电脑启动 SIoT 服务后,门铃端按下 A 键,向 siot/doorbell 主题发布消息;用户端订阅该主题,收到消息后在屏幕上显示“有人按门铃”。

操作步骤
-
实验盒和电脑接入同一无线网络;
-
进入下载SIoT软件,并解压文件夹,双击start SIoT.bat 即可启动新版SIoT,启动之后会弹出小黑窗启动服务器。

-
在浏览器输入”计算机IP地址:8080“,输入账号 "siot" ,密码 "dfrobot",进入数据管理页。进入数据管理页后创建主题“siot/doorbell”。

示例程序
门铃端程序:
from k10_base import WiFi, MqttClient
from unihiker_k10 import button
import time
bt_a = button(button.a)
wifi = WiFi()
wifi.connect(ssid="你的WiFi名称", psd="你的WiFi密码", timeout=50000)
wifi.status()
wifi.info()
mqttclient = MqttClient()
mqttclient.connect(
server="你的SIoT服务器IP",
port=1883,
client_id="",
user="siot",
psd="dfrobot"
)
mqttclient.connected()
while True:
if bt_a.status() == 1:
mqttclient.publish(topic="siot/doorbell", content="有人按门铃")
time.sleep(1)
用户端程序:
from k10_base import WiFi, MqttClient
from unihiker_k10 import screen
import time
wifi = WiFi()
wifi.connect(ssid="你的WiFi名称", psd="你的WiFi密码", timeout=50000)
wifi.status()
wifi.info()
mqttclient = MqttClient()
mqttclient.connect(
server="你的SIoT服务器IP",
port=1883,
client_id="",
user="siot",
psd="dfrobot"
)
mqttclient.connected()
screen.init(dir=2)
screen.show_bg(color=0xFFFFFF)
screen.draw_text(text="用户端", color=0x0000FF, x=100, y=50)
screen.show_draw()
def received_msg():
msg = mqttclient.message(topic="siot/doorbell")
if msg == "有人按门铃":
print(msg)
screen.draw_text(text=msg, color=0x000000, x=90, y=160)
screen.show_draw()
mqttclient.received(
topic="siot/doorbell",
callback=received_msg
)
while True:
time.sleep(0.1)
示例效果
按下门铃端 A 键后,用户端屏幕显示“有人按门铃”。

项目4-智能环境监测与报警
硬件准备
| 器材 | 数量 | 说明 |
|---|---|---|
| 行空板K10信息科技实验盒 | 1 | 使用温湿度传感器、屏幕、蜂鸣器 |
| 继电器 | 2 | 用于空调控制、加湿器控制 |
| USB 数据线 | 1 | 连接电脑和实验盒 |
| 运行 SIoT 的电脑 | 1 | 接收环境数据和警报消息 |
硬件连接
温湿度传感器为实验盒板载器件。示例程序中 pin(2) 用于空调控制输出,pin(3) 用于加湿器控制输出;蜂鸣器为实验盒板载器件。联网后,程序将温度、湿度、空调状态、恒湿器状态和警报状态发布到 SIoT。

示例项目:
程序持续读取温度和湿度。当温度不在 18℃ 到 22℃ 范围内时,空调控制输出打开;当湿度不在 50% 到 60% 范围内时,加湿器控制输出打开。若空调或加湿器连续运行时间超过阈值,蜂鸣器报警,并向 SIoT 发布警报消息。
示例程序
from unihiker_k10 import screen, temp_humi, pin
from k10_box import buzzer
from k10_base import WiFi, MqttClient
import time
wifi = WiFi()
wifi.connect(ssid="你的WiFi名称", psd="你的WiFi密码", timeout=50000)
wifi.status()
wifi.info()
mqttclient = MqttClient()
mqttclient.connect(
server="你的SIoT服务器IP",
port=1883,
client_id="",
user="siot",
psd="dfrobot"
)
mqttclient.connected()
p2 = pin(2)
p3 = pin(3)
screen.init(dir=2)
screen.clear()
screen.show_bg(color=0xFFFFFF)
ac_timer = 0
humidifier_timer = 0
ALERT_THRESHOLD = 30
def update_display(temp, hum, ac_status, humidifier_status):
screen.draw_rect(x=0, y=0, w=320, h=240, bcolor=0xFFFFFF, fcolor=0xFFFFFF)
screen.draw_text(text="温度:" + str(temp) + "℃", x=30, y=30, font_size=24, color=0x0000FF)
screen.draw_text(text="空调:" + ac_status, x=30, y=80, font_size=24, color=0x0000FF)
screen.draw_text(text="湿度:" + str(hum) + "%rh", x=30, y=130, font_size=24, color=0x0000FF)
screen.draw_text(text="加湿器:" + humidifier_status, x=30, y=180, font_size=24, color=0x0000FF)
screen.show_draw()
while True:
temp = temp_humi.read_temp()
hum = temp_humi.read_humi()
mqttclient.publish(topic="siot/温度", content=str(temp))
mqttclient.publish(topic="siot/湿度", content=str(hum))
if temp > 22 or temp < 18:
ac_status = "打开"
p2.write_digital(value=1)
mqttclient.publish(topic="siot/空调", content="打开")
ac_timer += 1
else:
ac_status = "关闭"
p2.write_digital(value=0)
mqttclient.publish(topic="siot/空调", content="关闭")
ac_timer = 0
if hum > 60 or hum < 50:
humidifier_status = "打开"
p3.write_digital(value=1)
mqttclient.publish(topic="siot/恒湿器", content="打开")
humidifier_timer += 1
else:
humidifier_status = "关闭"
p3.write_digital(value=0)
mqttclient.publish(topic="siot/恒湿器", content="关闭")
humidifier_timer = 0
if ac_timer > ALERT_THRESHOLD or humidifier_timer > ALERT_THRESHOLD:
buzzer.play(349)
time.sleep(0.5)
buzzer.stop()
mqttclient.publish(topic="siot/警报", content="出现异常,请管理员处理")
else:
mqttclient.publish(topic="siot/警报", content="正常")
update_display(temp, hum, ac_status, humidifier_status)
time.sleep(1)
示例效果
运行后,实验盒屏幕显示温度、湿度、空调状态和加湿器状态。若空调或加湿器持续运行超过阈值,蜂鸣器响起,并向 SIoT 发布警报消息。




























