How orcahand/orca_core works
Orca Core is the ORCA Hand control package: users configure a hand, connect through hardware abstraction, then command joint-space motion or run maintenance workflows such as tensioning and calibration. The graph also preserves encoder feedback, tactile sensing, and kinematics as distinct capabilities. Several connections rely on README statements or SOURCE INDEX references; unsampled implementation details are not assumed.
Main entry points: hardware_hand.py Hand interface · hardware_hand_sensing.py Sensing hand interface · motor_factory.py Motor client factory · hand_factory.py Hand factory
Components 22
Configuration and entry
- Hand configuration
orca_core/hand_config.py - Hand factory
orca_core/hand_factory.py - Python API
orca_core/api/api.py
Hand control
- Hand interface
orca_core/hardware_hand.py - Joint commands
orca_core/joint_position.py - Joint feedback loop
orca_core/control/joint_loop.py - Joint controller
orca_core/control/joint_controller.py
Hardware access
- Motor client factory
orca_core/hardware/motor_factory.py - Motor abstraction
orca_core/hardware/motor_client.py - Dynamixel driver
orca_core/hardware/dynamixel_client.py - Feetech driver
orca_core/hardware/feetech_client.py
Sensing and kinematics
- Hand serial link
orca_core/hardware/hand_serial_link.py - Joint encoder client
orca_core/hardware/joint_encoder_client.py - Encoder protocol
orca_core/hardware/sensing/encoder_protocol.py - Tactile client
orca_core/hardware/tactile_client.py - Sensing hand interface
orca_core/hardware_hand_sensing.py - Hand kinematics
orca_core/kinematics/hand_kinematics.py
Maintenance
- Calibration routine
orca_core/maintenance/calibration_routine.py - Tensioning
orca_core/maintenance/tensioning.py - Calibration data
orca_core/calibration.py - Maintenance commands
scripts/calibrate.py
Other components
- Operator
Connections 23
- Operator → Python API: uses
- Python API → Hand factory: exposes
orca_core/api/api.py - Hand factory → Hand configuration: loads
orca_core/hand_factory.py - Hand factory → Hand interface: creates
orca_core/hand_factory.py - Hand interface → Motor client factory: creates client
orca_core/hardware_hand.py - Motor client factory → Motor abstraction: implements
orca_core/hardware/motor_factory.py - Motor client factory → Dynamixel driver: selects
orca_core/hardware/motor_factory.py - Motor client factory → Feetech driver: selects
orca_core/hardware/motor_factory.py - Hand interface → Joint commands: commands
orca_core/hardware_hand.py - Hand interface → Calibration routine: runs
orca_core/hardware_hand.py - Hand interface → Tensioning: runs
orca_core/hardware_hand.py - Calibration routine → Calibration data: updates
orca_core/maintenance/calibration_routine.py - Maintenance commands → Hand interface: configures
- Operator → Maintenance commands: runs
- Sensing hand interface → Hand interface: extends
orca_core/hardware_hand_sensing.py - Sensing hand interface → Tactile client: uses
orca_core/hardware_hand_sensing.py - Sensing hand interface → Joint feedback loop: uses
orca_core/hardware_hand_sensing.py - Sensing hand interface → Joint encoder client: uses
orca_core/hardware_hand_sensing.py - Joint encoder client → Hand serial link: reads
orca_core/hardware/joint_encoder_client.py - Joint encoder client → Encoder protocol: decodes with
orca_core/hardware/joint_encoder_client.py - Tactile client → Hand serial link: reads
orca_core/hardware/tactile_client.py - Joint feedback loop → Joint controller: uses
orca_core/control/joint_loop.py - Sensing hand interface → Hand kinematics: uses
orca_core/hardware_hand_sensing.py