SuperAPI AI Directory

@6171/physics-lab-experiment-suite

General & other

View repository

Updated 10-16 08:51

About this skill

🔬 Physics Experiment Competition Solution Kit

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

  1. User specifies experiment → unpack the corresponding assets/ from .tar.gz to the output/ directory
  2. After unpacking, check the directory structure Ensure completeness (one each of firmware/documentation/drawings/PPT/teaching manuscript/simulator)
  3. Deliver as needed:
    • Firmware → read/write the .ino file, 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 .html to experience
  4. If it is a packaging request → tar.gz the entire output/ directory and then use sessions_spawn to 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_file or sessions_spawn to 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 experiments
  • scripts/ — auxiliary scripts (batch unpacking, flashing guidance, etc.)
  • references/ — reference documents (competition standards, scoring rules, etc.)