Four complete primary and secondary school experiment teaching solutions, each set is a deliverable competition material package. The user only needs to say "I need a physics experiment solution" or specify the experiment name, and you can unpack and deliver the full set of materials.
Included experiments
| Experiment | Asset package | Size | Core hardware |
|---|---|---|---|
| Pendulum g measurement | pendulum-g.tar.gz |
454K | ESP8266 + reed switch |
| Acoustic levitation sound speed measurement | acoustic-levitation.tar.gz |
1.3M | ESP8266 + ultrasonic transducer |
| Centripetal force quantitative demonstrator | centripetal-force.tar.gz |
3.3M | ESP32 + force sensor |
| Electromagnetic damping quantitative research | electromagnetic-damping.tar.gz |
235K | (principle analysis type) |
Delivery process
- User specifies experiment → from
assets/unpack the corresponding.tar.gztooutput/directory - After unpacking, check the directory structure Ensure completeness (one each of firmware/documentation/drawings/PPT/teaching manuscript/simulator)
- Deliver as needed:
- Firmware → read/write
.inofile, guide the user to flash with arduino-cli - 3D drawings → STL/SCAD files, explain printing parameters
- Teaching manuscript + PPT → can be directly used for competition submission
- Run simulator → open
.htmlto experience
- Firmware → read/write
- If it is a packaging request → tar.gz the entire
output/directory and then usesessions_spawnto push to the user's hard drive
Common questions
- User says "three major experiments" → refers to pendulum + acoustic levitation + centripetal force (electromagnetic damping is option B, usually counted as additional)
- User says "package" → must use
write_local_fileorsessions_spawnto push to the user's local machine, cannot just say "packaged" - Firmware selection → pendulum/acoustic levitation use ESP8266 (Wemos D1 Mini), centripetal force uses ESP32 (ESP32-DevKitC)
- Flashing port → on macOS
/dev/cu.usbserial-*, the port number may change after boot, the user needs to confirm - Competition material standard → each solution must include: device diagram ×4, circuit diagram, firmware, 3D drawings, teaching PPT, teaching manuscript, material list, procurement list, debugging manual, video script
Unpacking command
# 解包到 output/ 目录
tar xzf skills/physics-lab-experiment-suite/assets/<实验名>.tar.gz -C output/<实验名>/
Directory structure of each experiment
pendulum-g/ # 单摆测g
├── 固件/ # pendulum_g_esp8266.ino (有OLED版)
│ # pendulum_g_esp8266_nooled.ino (无OLED版)
├── 图纸/ # 装置总图 / 电路原理图 / 原理示意图 / 测量方法 (SVG+PNG)
├── 文档/ # 材料清单 / 采购清单 / 工艺步骤 / 调试手册 / 视频脚本
├── 教学文稿/ # PPT / 文稿
├── 工具/ # gen_buymenu.py, 模拟器HTML
├── PPT/
└── webapp/
acoustic-levitation/ # 声悬浮测声速
├── 固件/ # acoustic_levitation.ino
├── 图纸/ # 装置/电路/驻波原理/测量方法
├── 文档/ # 材料清单 / 采购清单 / 工艺步骤 / 调试手册 / 视频脚本
├── PPT/
├── 工具/
└── 教学文稿/
centripetal-force/ # 向心力定量演示仪
├── esp32_firmware/ # centrifugal_force.ino
├── stl/ # 旋转臂 / 滑块 3D打印模型
├── webapp/ # 网页仪表盘
├── tools/ # Python工具
├── 接线图/ 工艺图/
├── PPT/ 教学文稿/
└── 文档/ # 材料清单 / 视频脚本 / 分镜
Resources
assets/— tar.gz archives of the four experimentsscripts/— auxiliary scripts (batch unpacking, flashing guidance, etc.)references/— reference documents (competition standards, scoring rules, etc.)