:py:mod:`phoenix6.controls.torque_current_foc` ============================================== .. py:module:: phoenix6.controls.torque_current_foc Module Contents --------------- .. py:class:: TorqueCurrentFOC(output: phoenix6.units.ampere, max_abs_duty_cycle: float = 1.0, deadband: phoenix6.units.ampere = 0.0, override_coast_dur_neutral: bool = False, limit_forward_motion: bool = False, limit_reverse_motion: bool = False, ignore_hardware_limits: bool = False, ignore_software_limits: bool = False, use_timesync: bool = False) Requires Phoenix Pro; Request a specified motor current (field oriented control). This control request will drive the motor to the requested motor (stator) current value. This leverages field oriented control (FOC), which means greater peak power than what is documented. This scales to torque based on Motor's kT constant. :param output: Amount of motor current in Amperes :type output: ampere :param max_abs_duty_cycle: The maximum absolute motor output that can be applied, which effectively limits the velocity. For example, 0.50 means no more than 50% output in either direction. This is useful for preventing the motor from spinning to its terminal velocity when there is no external torque applied unto the rotor. Note this is absolute maximum, so the value should be between zero and one. :type max_abs_duty_cycle: float :param deadband: Deadband in Amperes. If torque request is within deadband, the bridge output is neutral. If deadband is set to zero then there is effectively no deadband. Note if deadband is zero, a free spinning motor will spin for quite a while as the firmware attempts to hold the motor's bemf. If user expects motor to cease spinning quickly with a demand of zero, we recommend a deadband of one Ampere. This value will be converted to an integral value of amps. :type deadband: ampere :param override_coast_dur_neutral: Set to true to coast the rotor when output is zero (or within deadband). Set to false to use the NeutralMode configuration setting (default). This flag exists to provide the fundamental behavior of this control when output is zero, which is to provide 0A (zero torque). :type override_coast_dur_neutral: bool :param limit_forward_motion: Set to true to force forward limiting. This allows users to use other limit switch sensors connected to robot controller. This also allows use of active sensors that require external power. :type limit_forward_motion: bool :param limit_reverse_motion: Set to true to force reverse limiting. This allows users to use other limit switch sensors connected to robot controller. This also allows use of active sensors that require external power. :type limit_reverse_motion: bool :param ignore_hardware_limits: Set to true to ignore hardware limit switches and the LimitForwardMotion and LimitReverseMotion parameters, instead allowing motion. This can be useful on mechanisms such as an intake/feeder, where a limit switch stops motion while intaking but should be ignored when feeding to a shooter. The hardware limit faults and Forward/ReverseLimit signals will still report the values of the limit switches regardless of this parameter. :type ignore_hardware_limits: bool :param ignore_software_limits: Set to true to ignore software limits, instead allowing motion. This can be useful when calibrating the zero point of a mechanism such as an elevator. The software limit faults will still report the values of the software limits regardless of this parameter. :type ignore_software_limits: bool :param use_timesync: Set to true to delay applying this control request until a timesync boundary (requires Phoenix Pro and CANivore). This eliminates the impact of nondeterministic network delays in exchange for a larger but deterministic control latency. This requires setting the ControlTimesyncFreqHz config in MotorOutputConfigs. Additionally, when this is enabled, the UpdateFreqHz of this request should be set to 0 Hz. :type use_timesync: bool .. py:property:: name :type: str Gets the name of this control request. :returns: Name of the control request :rtype: str .. py:property:: control_info :type: dict Gets information about this control request. :returns: Dictonary of control parameter names and corresponding applied values :rtype: dict .. py:attribute:: update_freq_hz :type: phoenix6.units.hertz :value: 100 The frequency at which this control will update. This is designated in Hertz, with a minimum of 20 Hz (every 50 ms) and a maximum of 1000 Hz (every 1 ms). Some update frequencies are not supported and will be promoted up to the next highest supported frequency. If this field is set to 0 Hz, the control request will be sent immediately as a one-shot frame. This may be useful for advanced applications that require outputs to be synchronized with data acquisition. In this case, we recommend not exceeding 50 ms between control calls. .. py:attribute:: output Amount of motor current in Amperes - Units: A .. py:attribute:: max_abs_duty_cycle The maximum absolute motor output that can be applied, which effectively limits the velocity. For example, 0.50 means no more than 50% output in either direction. This is useful for preventing the motor from spinning to its terminal velocity when there is no external torque applied unto the rotor. Note this is absolute maximum, so the value should be between zero and one. - Units: fractional .. py:attribute:: deadband Deadband in Amperes. If torque request is within deadband, the bridge output is neutral. If deadband is set to zero then there is effectively no deadband. Note if deadband is zero, a free spinning motor will spin for quite a while as the firmware attempts to hold the motor's bemf. If user expects motor to cease spinning quickly with a demand of zero, we recommend a deadband of one Ampere. This value will be converted to an integral value of amps. - Units: A .. py:attribute:: override_coast_dur_neutral Set to true to coast the rotor when output is zero (or within deadband). Set to false to use the NeutralMode configuration setting (default). This flag exists to provide the fundamental behavior of this control when output is zero, which is to provide 0A (zero torque). .. py:attribute:: limit_forward_motion Set to true to force forward limiting. This allows users to use other limit switch sensors connected to robot controller. This also allows use of active sensors that require external power. .. py:attribute:: limit_reverse_motion Set to true to force reverse limiting. This allows users to use other limit switch sensors connected to robot controller. This also allows use of active sensors that require external power. .. py:attribute:: ignore_hardware_limits Set to true to ignore hardware limit switches and the LimitForwardMotion and LimitReverseMotion parameters, instead allowing motion. This can be useful on mechanisms such as an intake/feeder, where a limit switch stops motion while intaking but should be ignored when feeding to a shooter. The hardware limit faults and Forward/ReverseLimit signals will still report the values of the limit switches regardless of this parameter. .. py:attribute:: ignore_software_limits Set to true to ignore software limits, instead allowing motion. This can be useful when calibrating the zero point of a mechanism such as an elevator. The software limit faults will still report the values of the software limits regardless of this parameter. .. py:attribute:: use_timesync Set to true to delay applying this control request until a timesync boundary (requires Phoenix Pro and CANivore). This eliminates the impact of nondeterministic network delays in exchange for a larger but deterministic control latency. This requires setting the ControlTimesyncFreqHz config in MotorOutputConfigs. Additionally, when this is enabled, the UpdateFreqHz of this request should be set to 0 Hz. .. py:method:: with_output(new_output: phoenix6.units.ampere) -> TorqueCurrentFOC Modifies this Control Request's output parameter and returns itself for method-chaining and easier to use request API. Amount of motor current in Amperes - Units: A :param new_output: Parameter to modify :type new_output: ampere :returns: Itself :rtype: TorqueCurrentFOC .. py:method:: with_max_abs_duty_cycle(new_max_abs_duty_cycle: float) -> TorqueCurrentFOC Modifies this Control Request's max_abs_duty_cycle parameter and returns itself for method-chaining and easier to use request API. The maximum absolute motor output that can be applied, which effectively limits the velocity. For example, 0.50 means no more than 50% output in either direction. This is useful for preventing the motor from spinning to its terminal velocity when there is no external torque applied unto the rotor. Note this is absolute maximum, so the value should be between zero and one. - Units: fractional :param new_max_abs_duty_cycle: Parameter to modify :type new_max_abs_duty_cycle: float :returns: Itself :rtype: TorqueCurrentFOC .. py:method:: with_deadband(new_deadband: phoenix6.units.ampere) -> TorqueCurrentFOC Modifies this Control Request's deadband parameter and returns itself for method-chaining and easier to use request API. Deadband in Amperes. If torque request is within deadband, the bridge output is neutral. If deadband is set to zero then there is effectively no deadband. Note if deadband is zero, a free spinning motor will spin for quite a while as the firmware attempts to hold the motor's bemf. If user expects motor to cease spinning quickly with a demand of zero, we recommend a deadband of one Ampere. This value will be converted to an integral value of amps. - Units: A :param new_deadband: Parameter to modify :type new_deadband: ampere :returns: Itself :rtype: TorqueCurrentFOC .. py:method:: with_override_coast_dur_neutral(new_override_coast_dur_neutral: bool) -> TorqueCurrentFOC Modifies this Control Request's override_coast_dur_neutral parameter and returns itself for method-chaining and easier to use request API. Set to true to coast the rotor when output is zero (or within deadband). Set to false to use the NeutralMode configuration setting (default). This flag exists to provide the fundamental behavior of this control when output is zero, which is to provide 0A (zero torque). :param new_override_coast_dur_neutral: Parameter to modify :type new_override_coast_dur_neutral: bool :returns: Itself :rtype: TorqueCurrentFOC .. py:method:: with_limit_forward_motion(new_limit_forward_motion: bool) -> TorqueCurrentFOC Modifies this Control Request's limit_forward_motion parameter and returns itself for method-chaining and easier to use request API. Set to true to force forward limiting. This allows users to use other limit switch sensors connected to robot controller. This also allows use of active sensors that require external power. :param new_limit_forward_motion: Parameter to modify :type new_limit_forward_motion: bool :returns: Itself :rtype: TorqueCurrentFOC .. py:method:: with_limit_reverse_motion(new_limit_reverse_motion: bool) -> TorqueCurrentFOC Modifies this Control Request's limit_reverse_motion parameter and returns itself for method-chaining and easier to use request API. Set to true to force reverse limiting. This allows users to use other limit switch sensors connected to robot controller. This also allows use of active sensors that require external power. :param new_limit_reverse_motion: Parameter to modify :type new_limit_reverse_motion: bool :returns: Itself :rtype: TorqueCurrentFOC .. py:method:: with_ignore_hardware_limits(new_ignore_hardware_limits: bool) -> TorqueCurrentFOC Modifies this Control Request's ignore_hardware_limits parameter and returns itself for method-chaining and easier to use request API. Set to true to ignore hardware limit switches and the LimitForwardMotion and LimitReverseMotion parameters, instead allowing motion. This can be useful on mechanisms such as an intake/feeder, where a limit switch stops motion while intaking but should be ignored when feeding to a shooter. The hardware limit faults and Forward/ReverseLimit signals will still report the values of the limit switches regardless of this parameter. :param new_ignore_hardware_limits: Parameter to modify :type new_ignore_hardware_limits: bool :returns: Itself :rtype: TorqueCurrentFOC .. py:method:: with_ignore_software_limits(new_ignore_software_limits: bool) -> TorqueCurrentFOC Modifies this Control Request's ignore_software_limits parameter and returns itself for method-chaining and easier to use request API. Set to true to ignore software limits, instead allowing motion. This can be useful when calibrating the zero point of a mechanism such as an elevator. The software limit faults will still report the values of the software limits regardless of this parameter. :param new_ignore_software_limits: Parameter to modify :type new_ignore_software_limits: bool :returns: Itself :rtype: TorqueCurrentFOC .. py:method:: with_use_timesync(new_use_timesync: bool) -> TorqueCurrentFOC Modifies this Control Request's use_timesync parameter and returns itself for method-chaining and easier to use request API. Set to true to delay applying this control request until a timesync boundary (requires Phoenix Pro and CANivore). This eliminates the impact of nondeterministic network delays in exchange for a larger but deterministic control latency. This requires setting the ControlTimesyncFreqHz config in MotorOutputConfigs. Additionally, when this is enabled, the UpdateFreqHz of this request should be set to 0 Hz. :param new_use_timesync: Parameter to modify :type new_use_timesync: bool :returns: Itself :rtype: TorqueCurrentFOC .. py:method:: with_update_freq_hz(new_update_freq_hz: phoenix6.units.hertz) -> TorqueCurrentFOC Sets the frequency at which this control will update. This is designated in Hertz, with a minimum of 20 Hz (every 50 ms) and a maximum of 1000 Hz (every 1 ms). Some update frequencies are not supported and will be promoted up to the next highest supported frequency. If this field is set to 0 Hz, the control request will be sent immediately as a one-shot frame. This may be useful for advanced applications that require outputs to be synchronized with data acquisition. In this case, we recommend not exceeding 50 ms between control calls. :param new_update_freq_hz: Parameter to modify :type new_update_freq_hz: hertz :returns: Itself :rtype: TorqueCurrentFOC