OhCode图形化编程:面向初学者的源师兄Blockly编程平台入门教程
【免费下载链接】源师兄L0_开源大师兄基于海思3861芯片平台的源师兄开源项目硬件资料,包括硬件原理图和PCB layout文档。项目地址: https://gitcode.com/yuanshixiong/ysx-v0
本教程面向零基础初学者,带你快速上手OhCode 图形化编程平台——源师兄专为青少年打造的 Blockly 积木编程工具。通过拖拽彩色积木块,即可控制开发板的 OLED 屏幕、按键、温湿度传感器和语音识别模块,4 步完成你的第一个硬件程序,全程无需手写一行代码。
📌快速上手路线:下载安装软件 → 连接开发板选择串口 → 拖拽积木块 → 点击"下载到大师兄"运行程序
一、为什么选择 OhCode:零基础也能学会的图形化编程
OhCode 是专为"源师兄"系列开发的图形化编程软件平台,基于谷歌原生Blockly 框架构建,界面延续了 Scratch 的友好风格,同时深度融合了源师兄硬件自身的特色模块。对新手而言,它有三大优势:
- 🧩零代码门槛:用拖拽积木块代替敲代码,拼对顺序就能运行,中小学生也能独立上手;
- 🔌积木直通硬件:引脚、板载、显示、事件等分类积木直接驱动开发板,改一个参数就能立刻看到屏幕变化;
- 🌱成长路径完整:图形化入门后,可随时切换到 Python 模式与源码开发,学得久、不脱节。
源师兄是"硬件开源 + 软件开源 + 课程开源"三位一体的开源项目,从原理图、PCB 到编程框架全部开放,学生可围绕"数据与编码""身边的算法""物联网""人工智能"等主题学习,更多介绍见 README.md。
二、认识源师兄开发板:一块小板集齐 AI 语音能力
源师兄 L0 基于海思 Hi3861V100芯片,是一块仅4.5cm × 5.16cm的微型计算机,专为青少年编程教育设计,板载能力一次配齐:
| 板载能力 | 能做什么 |
|---|---|
| 🎙 语音识别(云之声芯片) | 说出指令就能控制程序,预置识别词见 云之声识别词.xlsx |
| 🖥 OLED 显示屏 | 显示数据、动画与互动信息 |
| 🌡 温湿度传感器 | 读取环境温湿度 |
| 💡 光线传感器 | 感知环境明暗 |
| 📡 NFC 芯片 | 支持"碰一碰"交互 |
| 🌀 加速度传感器 + 蜂鸣器 + 麦克风 | 姿态识别、声光反馈 |
| 🔘 双按键 A/B + 复位键 | 触发事件、重启程序 |
板底的金手指引脚(0 / 1 / 2 / 3V / GND)搭配 IO 扩展板,可连接电机、家电模块等外部设备,完整引脚定义见下图:
硬件资料方面,原理图与 PCB 均完全开源,可自行查阅 源师兄开发板V2.2_SCH_20220922.pdf,PCB 等文件位于 硬件资料-PCB&原理图/v2.2/ 目录。
三、OhCode 图形化编程平台界面全解析
打开 OhCode 后,界面分为 5 个功能区:
| 区域 | 作用 |
|---|---|
| 顶部工具栏 | 图形化 / Python 模式一键切换,新建、打开工程,选择串口 |
| 左侧开发板预览区 | 实时展示源师兄板子外观,配有运行 / 复位 / 停止按钮 |
| 中间积木分类区 | 全部可拖拽积木块,带搜索框快速定位 |
| 右侧工作区 | 拼接积木、搭建你的程序逻辑 |
| 底部操作栏 | 项目命名保存、"下载到大师兄"一键烧写 |
积木分类速查表:每类积木能做什么
| 分类 | 适合任务 | 代表积木 |
|---|---|---|
| 🟠 事件 | 决定程序何时启动 | 当程序启动时、当按键按下时 |
| 🟧 控制 | 循环与条件判断 | 重复执行、如果…那么… |
| 🟩 运算 | 数学计算与比较 | 加、减、大于、随机数 |
| 🟢 变量 | 存储与读取数据 | 把值设为变量、读取变量 |
| 🟪 显示 | OLED 屏幕输出 | 显示文本、清屏 |
| 🔵 引脚 | 控制金手指 IO | 引脚输出高 / 低电平 |
| 板载 | 读取传感器与外设 | 获取温度、光线强度 |
| 函数 | 把常用逻辑打包复用 | 定义函数 |
| 扩展 / 高级 | 语音、网络等进阶能力 | 语音识别、连接 WiFi |
四、4 步快速上手:做出你的第一个源师兄程序
第 1 步:下载并安装 OhCode 编程软件
从源师兄官方渠道获取 OhCode 安装包,安装后打开程序,顶部工具栏默认停在"图形化"模式,即可进入积木编程界面。
第 2 步:连接开发板并选择正确串口
用 USB 线连接源师兄的Type-C 接口,电脑识别后会生成一个 COM 口。点击顶部工具栏的"串口"按钮,在列表中选中对应的 COM 口即可。
💡 若找不到串口,通常是缺少 CH340G 串口驱动,安装驱动后重新插拔开发板即可。
第 3 步:拖拽积木块编写你的第一个程序
在中间积木区找到积木并拖入右侧工作区,拼出第一个"亮屏 + 实时显示光线值"程序:
- 拖入当程序启动时(橙色事件积木,程序入口);
- 在其下方拼接显示"Hello 源师兄"积木,点亮 OLED 屏;
- 再拼上重复执行循环,内部放入显示当前光线值积木,让屏幕实时刷新环境亮度。
第 4 步:一键"下载到大师兄"运行程序
在底部输入项目名称并保存,点击橙色按钮"下载到大师兄";烧录提示出现时按一次开发板复位键,程序即刻运行——OLED 屏会立刻显示出你拼出的内容 🎉
五、图形化 + Python 双模式:从积木到代码的成长路线
OhCode 顶部工具栏内置"图形化 / Python"切换开关,当积木块不够用时可随时进入代码模式。源师兄生态中还有多边形部落开发的PZstudio 青少年人工智能编程平台,同样是"图形化 + Python"双模式,并支持单步调试与变量查看,适合进阶练习:
切换到 Python 模式后,左侧实时输出程序运行结果,底部"内存变量"面板可查看变量值,配合"调试 / 下一步"按钮即可单步排错:
PZstudio 还兼容主流开源硬件,可直接编程控制 PZduino、PP9、TelioEDU、TelioTT、掌控板、Arduino 等设备:
PZstudio 的详细功能介绍见 软件平台/PZstudio青少年人工智能编程平台.md。
六、图形化编程背后的软硬件框架:一块积木调用了什么
每块积木背后都是完整的软件框架在支撑。源师兄把能力按层次拆好,屏蔽系统差异,向编程框架层提供统一接口:
- 编程层:PZstudio 图形编程、Python 编程,规划中还有 OpenBlock 等框架;
- 框架层:系统能力框架提供统一接口、AI 能力、云接入、NFC 碰一碰等——"显示""运算"积木实际就是调用这一层;
- 系统层 / 芯片驱动层:运行在 OpenHarmony 轻量系统上,驱动 Hi3861、W800 等芯片与 LED、温湿度、NFC 等外设。
硬件侧同样分层清晰:核心板 + 标准接口,向上扩展出场景化设备与扩展板:
想深入了解整体架构,可查阅 README.md 中的"硬件开源框架"与"软件框架"章节。
七、常见问题快速排查:连接失败、找不到串口怎么办
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 电脑找不到串口 COM 口 | 未安装 CH340G 串口驱动 | 安装 CH341SER 驱动后重新插拔开发板 |
| 点击"下载"后无反应 | 未按复位键 | 烧录提示出现时按一次复位键 |
| 语音识别"听不懂" | 使用了预置词表以外的指令 | 改用 云之声识别词.xlsx 中的预置识别词 |
| 想恢复出厂固件 | 误烧录了异常固件 | 用 PZstudio 的"烧写固件"功能选择"专有固件"恢复 |
固件烧录的详细步骤(含 IDE 一键编译烧录方式)见 固件源码/README.md。
八、进阶路径:从图形化走向源码开发
当你能熟练拖出各种积木后,可以打开仓库中的 固件源码/ 目录,看看积木背后的 C 语言世界:
- 固件源码/README.md:OpenHarmony 环境搭建、代码获取、编译烧录完整指南;
- 固件源码/quickstart.md:Linux 环境快速入门;
- 固件源码/test/:官方示例代码,如 main.c、ssd1306_demo.c、wifi_connect_demo.c。
获取基础代码时,在"克隆/下载"菜单中选择下载 ZIP 即可:
按指南编译固件,成功后会看到如下 build success 提示:
🚀写在最后:OhCode 用积木块把源师兄的硬件能力"翻译"成孩子也能懂的语言,4 步就能让 OLED 屏亮起来。建议按"图形化入门 → Python 进阶 → 源码探索"的路径循序渐进学习,配套开源课程与教学资料详见 README.md。
【免费下载链接】源师兄L0_开源大师兄基于海思3861芯片平台的源师兄开源项目硬件资料,包括硬件原理图和PCB layout文档。项目地址: https://gitcode.com/yuanshixiong/ysx-v0
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考