SuperAPI AI Directory

@6171/physics-lab-experiment-suite

Writing & research

View repository

Updated 10-16 08:49

About this skill

🔬 Physics experiment competition solution kit

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

  1. User specifies experiment → from assets/ unpack the corresponding .tar.gz to 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 .ino file, 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 .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 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_file or sessions_spawn to 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 experiments
  • scripts/ — auxiliary scripts (batch unpacking, flashing guidance, etc.)
  • references/ — reference documents (competition standards, scoring rules, etc.)