This is the simplest possible way of controlling the ODrive. It is also the most primitive and fragile one. So don’t use it unless you must interoperate with other hardware that you don’t control.
ISO_VDD and ISO_GND must be provided by the microcontroller to use these Isolated IO pins.
Set the STEP GPIO (S) mode
Set the DIR GPIO (D) mode
Enable the interface by setting
Enable circular setpoints
After this, step and direction will be enabled when you put the axis into closed loop control.
Note that to change out of step/dir, you need to set
<axis>.config.enable_step_dir to False, go to
AxisState.IDLE, and then back into closed loop control.
Circular setpoints are used to keep floating point error at a manageable error for systems where the motor can rotate large amounts.
If the motor is commanded out of the circular range, the position setpoint automatically wraps around to stay in the range.
Two parameters are used to control this behavior:
The circular setpoint range sets the operating range of input_pos, starting at 0.0. The
steps per circular range setting controls how many steps are needed to traverse the entire range.
For example, to use 1024 steps per 1 motor turn, in a space that wraps every 128 turns:
<axis>.controller.config.circular_setpoint_rangeto 128.0 (turns)
<axis>.pos_vel_mapper.config.circular_setpoint_rangeto 128.0 (turns)
<axis>.controller.config.steps_per_circular_rangeto 1024*128 (steps)
The circular range is a floating point value and the steps per circular range parameter is an integer. For best results, set both parameters to powers of 2.
The maximum advisable step rate is 50kHz.
Please be aware that there is no enable line right now, and the step/direction interface is enabled by default, and remains active as long as the ODrive is in position control mode. To get the ODrive to go into position control mode at boot, see how to configure the startup procedure.