Class CANrangeConfiguration

java.lang.Object

com.ctre.phoenix6.configs.CANrangeConfiguration

All Implemented Interfaces:

ParentConfiguration, Cloneable

public class CANrangeConfiguration
extends Object
implements ParentConfiguration, Cloneable

All configurations for the CANrange.

Field Summary

Fields

Modifier and Type	Field	Description
CustomParamsConfigs	CustomParams	Custom Params.
FovParamsConfigs	FovParams	Configs that affect the ToF Field of View
boolean	FutureProofConfigs	True if we should factory default newer unsupported configs, false to leave newer unsupported configs alone.
ProximityParamsConfigs	ProximityParams	Configs that affect the ToF Proximity detection
ToFParamsConfigs	ToFParams	Configs that affect the ToF sensor

Constructor Summary

Constructors

Constructor	Description
CANrangeConfiguration()

Method Summary

Modifier and Type	Method	Description
CANrangeConfiguration	clone()
final StatusCode	deserialize(String to_deserialize)	Take a string and deserialize it to this configuration.
final String	serialize()	Get the serialized form of this configuration.
String	toString()
final CANrangeConfiguration	withCustomParams(CustomParamsConfigs newCustomParams)	Modifies this configuration's CustomParams parameter and returns itself for method-chaining and easier to use config API.
final CANrangeConfiguration	withFovParams(FovParamsConfigs newFovParams)	Modifies this configuration's FovParams parameter and returns itself for method-chaining and easier to use config API.
final CANrangeConfiguration	withProximityParams(ProximityParamsConfigs newProximityParams)	Modifies this configuration's ProximityParams parameter and returns itself for method-chaining and easier to use config API.
final CANrangeConfiguration	withToFParams(ToFParamsConfigs newToFParams)	Modifies this configuration's ToFParams parameter and returns itself for method-chaining and easier to use config API.

Methods inherited from class Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

FutureProofConfigs

public boolean FutureProofConfigs

True if we should factory default newer unsupported configs, false to leave newer unsupported configs alone.

This flag addresses a corner case where the device may have firmware with newer configs that didn't exist when this version of the API was built. If this occurs and this flag is true, unsupported new configs will be factory defaulted to avoid unexpected behavior.

This is also the behavior in Phoenix 5, so this flag is defaulted to true to match.

CustomParams

public CustomParamsConfigs CustomParams

Custom Params.

Custom paramaters that have no real impact on controller.

Parameter list:

• CustomParamsConfigs.CustomParam0
• CustomParamsConfigs.CustomParam1

ToFParams

public ToFParamsConfigs ToFParams

Configs that affect the ToF sensor

Includes Update mode and frequency

Parameter list:

• ToFParamsConfigs.UpdateMode
• ToFParamsConfigs.UpdateFrequency

ProximityParams

public ProximityParamsConfigs ProximityParams

Configs that affect the ToF Proximity detection

Includes proximity mode and the threshold for simple detection

Parameter list:

• ProximityParamsConfigs.ProximityThreshold
• ProximityParamsConfigs.ProximityHysteresis
• ProximityParamsConfigs.MinSignalStrengthForValidMeasurement

FovParams

public FovParamsConfigs FovParams

Configs that affect the ToF Field of View

Includes range and center configs

Parameter list:

• FovParamsConfigs.FOVCenterX
• FovParamsConfigs.FOVCenterY
• FovParamsConfigs.FOVRangeX
• FovParamsConfigs.FOVRangeY

Constructor Details

CANrangeConfiguration

public CANrangeConfiguration()

Method Details

withCustomParams

public final CANrangeConfiguration withCustomParams(CustomParamsConfigs newCustomParams)

Modifies this configuration's CustomParams parameter and returns itself for method-chaining and easier to use config API.

Custom Params.

Custom paramaters that have no real impact on controller.

Parameter list:

• CustomParamsConfigs.CustomParam0
• CustomParamsConfigs.CustomParam1

Parameters:

newCustomParams - Parameter to modify

Returns:

Itself

withToFParams

public final CANrangeConfiguration withToFParams(ToFParamsConfigs newToFParams)

Modifies this configuration's ToFParams parameter and returns itself for method-chaining and easier to use config API.

Configs that affect the ToF sensor

Includes Update mode and frequency

Parameter list:

• ToFParamsConfigs.UpdateMode
• ToFParamsConfigs.UpdateFrequency

Parameters:

newToFParams - Parameter to modify

Returns:

Itself

withProximityParams

public final CANrangeConfiguration withProximityParams(ProximityParamsConfigs newProximityParams)

Modifies this configuration's ProximityParams parameter and returns itself for method-chaining and easier to use config API.

Configs that affect the ToF Proximity detection

Includes proximity mode and the threshold for simple detection

Parameter list:

• ProximityParamsConfigs.ProximityThreshold
• ProximityParamsConfigs.ProximityHysteresis
• ProximityParamsConfigs.MinSignalStrengthForValidMeasurement

Parameters:

newProximityParams - Parameter to modify

Returns:

Itself

withFovParams

public final CANrangeConfiguration withFovParams(FovParamsConfigs newFovParams)

Modifies this configuration's FovParams parameter and returns itself for method-chaining and easier to use config API.

Configs that affect the ToF Field of View

Includes range and center configs

Parameter list:

• FovParamsConfigs.FOVCenterX
• FovParamsConfigs.FOVCenterY
• FovParamsConfigs.FOVRangeX
• FovParamsConfigs.FOVRangeY

Parameters:

newFovParams - Parameter to modify

Returns:

Itself

toString

public String toString()

Overrides:

toString in class Object

serialize

public final String serialize()

Get the serialized form of this configuration.

Specified by:

serialize in interface ParentConfiguration

Returns:

Serialized form of this config group

deserialize

public final StatusCode deserialize(String to_deserialize)

Take a string and deserialize it to this configuration.

Specified by:

deserialize in interface ParentConfiguration

Parameters:

to_deserialize - The serialized configuration

Returns:

Return code of the deserialize method

clone

public CANrangeConfiguration clone()

Overrides:

clone in class Object