Four complete primary and secondary school experiment teaching solutions, each 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 |
|---|---|---|---|
| Simple 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 Study | electromagnetic-damping.tar.gz |
235K | (Principle-analysis type) |
Delivery Workflow
- User specifies experiment → unpack the corresponding
assets/from.tar.gzto theoutput/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 the
.inofile, guide the user to flash it with arduino-cli - 3D drawings → STL/SCAD files, explain printing parameters
- Teaching manuscript + PPT → can be used directly for competition submission
- Run simulator → open
.htmlto experience
- Firmware → read/write the
- If it is a packaging request → tar.gz the entire
output/directory and then usesessions_spawnto push to the user's disk
FAQ
- User says "three major experiments" → refers to simple 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 → simple 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 and needs user confirmation - Competition material standard → each solution must include: apparatus diagrams ×4, circuit diagram, firmware, 3D drawings, teaching PPT, teaching manuscript, materials list, procurement list, debugging manual, video script
Unpack 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.)