An actuator that uses a PCA9685 controller to drive a servo.
Configuration is derived from the joint's motor_profile injected by
BB.Actuator.Server:
- Position limits from
motor_profile.motor_lower/motor_upper - Velocity limit from
motor_profile.motor_velocity_limit - PWM range maps linearly to the motor's position range
(
motor_lower → min_pulse,motor_upper → max_pulse)
When a position command is received, the actuator:
- Clamps the position to motor limits
- Converts to PWM pulse width
- Sends PWM command to the PCA9685 controller
- Publishes a
BB.Message.Actuator.BeginMotionviaBB.Actuator.publish_begin_motion/3(which handles the motor → joint-space conversion)
Example DSL Usage
controller :pca9685, {BB.Servo.PCA9685.Controller, bus: "i2c-1", address: 0x40}
joint :shoulder, type: :revolute do
limit lower: ~u(-45 degree), upper: ~u(45 degree), velocity: ~u(60 degree_per_second)
actuator :servo, {BB.Servo.PCA9685.Actuator, channel: 0, controller: :pca9685}
sensor :feedback, {BB.Sensor.OpenLoopPositionEstimator, actuator: :servo}
end
Summary
Functions
Disable the servo by setting pulse width to 0.
Functions
Disable the servo by setting pulse width to 0.
Called by BB.Safety.Controller when the robot is disarmed or crashes.
This function works without GenServer state - it receives the robot module,
controller name, and channel from the opts provided during registration.