CTRE Phoenix 6 C++ 26.0.0-beta-1
Loading...
Searching...
No Matches
ctre::phoenix6::controls::ModulateVBatOut Class Referencefinal

Modulates the CANdle VBat output to the specified duty cycle. More...

#include <ctre/phoenix6/controls/ModulateVBatOut.hpp>

Inheritance diagram for ctre::phoenix6::controls::ModulateVBatOut:
ctre::phoenix6::controls::ControlRequest

Public Member Functions

constexpr ModulateVBatOut (units::dimensionless::scalar_t Output)
 Modulates the CANdle VBat output to the specified duty cycle.
 
constexpr ~ModulateVBatOut () override
 
constexpr std::string_view GetName () const override
 Gets the name of this control request.
 
constexpr ModulateVBatOutWithOutput (units::dimensionless::scalar_t newOutput)
 Modifies this Control Request's Output parameter and returns itself for method-chaining and easier to use request API.
 
constexpr ModulateVBatOutWithUpdateFreqHz (units::frequency::hertz_t newUpdateFreqHz)
 Sets the frequency at which this control will update.
 
std::string ToString () const override
 Returns a string representation of the object.
 
std::map< std::string, std::string > GetControlInfo () const override
 Gets information about this control request.
 
- Public Member Functions inherited from ctre::phoenix6::controls::ControlRequest
constexpr ControlRequest ()=default
 Constructs a new Control Request.
 
virtual constexpr ~ControlRequest ()
 

Public Attributes

units::dimensionless::scalar_t Output
 Proportion of VBat to output in fractional units between 0.0 and 1.0.
 
units::frequency::hertz_t UpdateFreqHz {50_Hz}
 The frequency at which this control will update.
 

Additional Inherited Members

- Protected Member Functions inherited from ctre::phoenix6::controls::ControlRequest
constexpr ControlRequest (ControlRequest const &)=default
 
constexpr ControlRequest (ControlRequest &&)=default
 
constexpr ControlRequestoperator= (ControlRequest const &)=default
 
constexpr ControlRequestoperator= (ControlRequest &&)=default
 

Detailed Description

Modulates the CANdle VBat output to the specified duty cycle.

This can be used to control a single-color LED strip.

Note that configs::CANdleFeaturesConfigs::VBatOutputMode must be set to signals::VBatOutputModeValue::Modulated.

Constructor & Destructor Documentation

◆ ModulateVBatOut()

ctre::phoenix6::controls::ModulateVBatOut::ModulateVBatOut ( units::dimensionless::scalar_t Output)
inlineconstexpr

Modulates the CANdle VBat output to the specified duty cycle.

This can be used to control a single-color LED strip.

Note that configs::CANdleFeaturesConfigs::VBatOutputMode must be set to signals::VBatOutputModeValue::Modulated.

Parameters
OutputProportion of VBat to output in fractional units between 0.0 and 1.0.

◆ ~ModulateVBatOut()

ctre::phoenix6::controls::ModulateVBatOut::~ModulateVBatOut ( )
inlineconstexproverride

Member Function Documentation

◆ GetControlInfo()

std::map< std::string, std::string > ctre::phoenix6::controls::ModulateVBatOut::GetControlInfo ( ) const
overridevirtual

Gets information about this control request.

Returns
Map of control parameter names and corresponding applied values

Implements ctre::phoenix6::controls::ControlRequest.

◆ GetName()

std::string_view ctre::phoenix6::controls::ModulateVBatOut::GetName ( ) const
inlineconstexproverridevirtual

Gets the name of this control request.

Returns
Name of the control request

Implements ctre::phoenix6::controls::ControlRequest.

◆ ToString()

std::string ctre::phoenix6::controls::ModulateVBatOut::ToString ( ) const
overridevirtual

Returns a string representation of the object.

Returns
a string representation of the object.

Implements ctre::phoenix6::controls::ControlRequest.

◆ WithOutput()

ModulateVBatOut & ctre::phoenix6::controls::ModulateVBatOut::WithOutput ( units::dimensionless::scalar_t newOutput)
inlineconstexpr

Modifies this Control Request's Output parameter and returns itself for method-chaining and easier to use request API.

Proportion of VBat to output in fractional units between 0.0 and 1.0.

  • Units: fractional
Parameters
newOutputParameter to modify
Returns
Itself

◆ WithUpdateFreqHz()

ModulateVBatOut & ctre::phoenix6::controls::ModulateVBatOut::WithUpdateFreqHz ( units::frequency::hertz_t newUpdateFreqHz)
inlineconstexpr

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.

Parameters
newUpdateFreqHzParameter to modify
Returns
Itself

Member Data Documentation

◆ Output

units::dimensionless::scalar_t ctre::phoenix6::controls::ModulateVBatOut::Output

Proportion of VBat to output in fractional units between 0.0 and 1.0.

  • Units: fractional

◆ UpdateFreqHz

units::frequency::hertz_t ctre::phoenix6::controls::ModulateVBatOut::UpdateFreqHz {50_Hz}

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.


The documentation for this class was generated from the following file: