English:
Software ·
Hardware ·
Assembly
中文：
软件 ·
硬件 ·
装配
OpenNeck is an open-source 2-DoF robotic neck gimbal. The repository provides 3D-printable mechanical parts, a physical-angle-based software driver, and standalone URDF and MuJoCo simulation models.
- Mechanical hardware: editable STEP models, print-ready STL models, a sourcing list, and assembly instructions.
- Software driver: a Python API, command-line tools, servo maintenance tools, and procedures for center and mechanical-limit calibration.
- Simulation models: standalone URDF and MuJoCo XML models with their supporting meshes.
| Topic | Document |
|---|---|
| Software installation, calibration, configuration, CLI, and API | Software Driver |
| Hardware sourcing and 3D printing | Hardware Preparation |
| Mechanical installation | Mechanical Assembly |
| URDF model | openneck.urdf |
| MuJoCo model | openneck.xml |
When building OpenNeck for the first time, follow these documents in order:
- Use Hardware Preparation to source the components and print the structural parts.
- Follow Mechanical Assembly to assemble the gimbal.
- Follow Software Driver to install the driver, assign servo IDs, and complete calibration.
This project is licensed under the Apache License 2.0.