面向中小学的掌控板仿真教学平台

没有实体板，
也能学掌控板编程

mPython VirtualBoard 在电脑上完整复刻掌控板：OLED、RGB 灯、按键、触摸与全套传感器。打开即写、运行即见，让每一节编程课都不再受硬件限制。

立即开始在线体验虚拟板

12+: 硬件组件仿真
2: 编程模式
8: 界面语言
100%: 开源免费

为课堂拆掉硬件的门槛

器材不够、损耗心疼、课前发放课后回收——这些都不该成为编程课的阻碍。

零器材开课

一人一台电脑即可拥有完整的掌控板体验，学校无需集中采购与维护硬件。

代码所见即所得

运行的每一行代码都实时反映在虚拟板的屏幕、灯光与传感器上，调试直观。

无缝衔接真实硬件

同一套 mPython / PinPong API，课堂上在虚拟板验证，课后可直接烧录到实体板。

一套工具，覆盖教学全链路

从图形化启蒙到代码进阶，从虚拟仿真到真实传感器，一个平台全部搞定。

完整硬件仿真

OLED 屏、三路 RGB、双按键、六路触摸、蜂鸣器，以及加速度、陀螺仪、磁力、光线、声音传感器，一应俱全。

双编程模式

mPython 与 PinPong 两条教学路径自由切换，贴合不同教材与课程体系。

Mind+ 图形化转译

粘贴 Mind+ 上传模式自动生成的代码，内置转译器一键转为 Python 并直接运行，平滑完成图形化到代码的过渡。

本地 AI 辅助改写

PinPong 模式接入本地 Ollama + DeepSeek 模型，把自然语言课堂要求改写成规范教学代码，数据不出本机。

真实传感器接入

通过 USB 串口连接实体掌控板，实时读取真实加速度、陀螺仪、磁力、光线与声音数据，虚实验证两不误。

Thonny 联动与悬浮窗

桌面版可与 Thonny / IDLE 无缝配合，虚拟板窗口始终置顶悬浮，边写代码边看效果。

两个版本，各取所需

同一颗仿真内核，两种产品形态，覆盖不同教学习惯。

mPython VM Studio

PyWebView + Vue3 打造的现代化教学工作台，内置编辑器，打开即用。

Monaco 编辑器，F5 运行 / F6 停止
Mind+ 上传模式代码转译与运行
PinPong 模式本地 AI 改写
真实传感器串口接入
传感器手动控制面板与快捷预设

PyWebView · Vue 3 · Monaco

桌面 · IDE 联动

mPython Virtual Machine

Tkinter + Socket 架构的桌面仿真器，专为 Thonny / IDLE 课堂联动设计。

一键启动整条虚拟板链路
始终置顶的悬浮显示窗口
Thonny / IDLE 远程控制
8 种界面语言自由切换
虚拟 USB 与客户端库支持

Tkinter · Socket · 虚拟 USB

先玩一分钟，再决定

下面就是一块活的虚拟掌控板。按下按键、晃动它，看看会发生什么。

Ready.

mPython

OLED 显示文字

提示：也可以直接点板子上的 A / B 按键。

from mpython import *

oled.DispChar('Hello!', 0, 0)
oled.show()
rgb[0] = (255, 0, 0)
rgb.write()

熟悉的硬件，熟悉的 API

虚拟板与实体掌控板保持一致的编程接口，学过的知识零成本迁移。

组件	mPython API	PinPong API
OLED 显示屏	`mp.oled`	`get_oled()`
RGB LED ×3	`mp.rgb`	`get_rgb()`
按键 A / B	`mp.button_a`	`Pin(Pin.P0, Pin.IN)`
触摸按键 ×6	`mp.touch`	`Pin(Pin.P1, Pin.IN)`
光线传感器	`mp.light`	`Sensor(Pin.P2)`
声音传感器	`mp.sound`	`Sensor(Pin.P3)`
加速度计	`mp.accelerometer`	`get_accel()`
陀螺仪	`mp.gyroscope`	`get_gyro()`
地磁传感器	`mp.magnetic`	`get_mag()`

为真实课堂而设计

图形化 → 代码过渡课

学生先用 Mind+ 图形化编程，再观察转译后的 Python 代码，自然理解抽象概念。

传感器认知课

连接实体板或使用手动控制面板，直观理解加速度、光线、声音的数值变化。

AI 代码改写课

学生先写原始代码，再用本地 AI 改写为规范版本，对比中学习编程规范。

无硬件演示课

机房没有实体板时，虚拟板提供与真实硬件完全一致的教学体验。

三分钟跑起来

Python 3.10+，Windows / macOS / Linux 全平台支持。

# 1. 克隆项目
git clone https://github.com/lmxylyc/mPython-VirtualBoard.git
cd mPython-VirtualBoard/mpython-vm-web

# 2. 安装依赖并启动
pip install -r requirements.txt
python main.py

# 1. 克隆项目
git clone https://github.com/lmxylyc/mPython-VirtualBoard.git
cd mPython-VirtualBoard/mpython-virtual-machine

# 2. 一键启动（也可以双击 run.bat）
python start_vm.py

前往 GitHub 获取源码

没有实体板，也能学掌控板编程