Rail Class

class Acroname::BrainStem2CLI::RailClass

RailClass. Provides power rail functionality on certain modules. This entity is only available on certain modules. The RailClass can be used to control power to downstream devices, I has the ability to take current and voltage measurements, and depending on hardware, may have additional modes and capabilities.

Public Functions

RailClass(Acroname::BrainStem::RailClass &pointer)

Constructor.

~RailClass()

Destructor.

!RailClass ()

Finalizer.

aErr getCurrent(int %microamps)

Get the rail current.

Return

Returns common entity return values

Parameters
  • microamps: The current in micro-amps (1 == 1e-6A).

aErr setCurrentSetpoint(const int microamps)

Set the rail setpoint current. Rail current control capabilities vary between modules. Refer to the module datasheet for definition of the rail current capabilities.

Return

Returns common entity return values

Parameters
  • microamps: The current in micro-amps (1 == 1e-6A) to be supply by the rail.

aErr getCurrentSetpoint(int %microamps)

Get the rail setpoint current. Rail current control capabilities vary between modules. Refer to the module datasheet for definition of the rail current capabilities.

Return

Returns common entity return values

Parameters
  • microamps: The current in micro-amps (1 == 1e-6A) the rail is trying to achieve. On some modules this is a measured value so it may not exactly match what was previously set via the setCurrent interface. Refer to the module datasheet to to determine if this is a measured or stored value.

aErr setCurrentLimit(const int microamps)

Set the rail current limit setting. (Check product datasheet to see if this feature is available)

Return

Returns common entity return values

Parameters
  • microamps: The current in micro-amps (1 == 1e-6A).

aErr getCurrentLimit(int %microamps)

Get the rail current limit setting. (Check product datasheet to see if this feature is available)

Return

Returns common entity return values

Parameters
  • microamps: The current in micro-amps (1 == 1e-6A).

aErr getTemperature(int %microcelsius)

Get the rail temperature.

Return

Returns common entity return values

Parameters
  • microcelsius: The measured temperature associated with the rail in micro-Celsius (1 == 1e-6?C). The temperature may be associated with the module’s internal rail circuitry or an externally connected temperature sensors. Refer to the module datasheet for definition of the temperature measurement location and specific capabilities.

aErr getEnable(unsigned char %bEnable)

Get the state of the external rail switch. Not all rails can be switched on and off. Refer to the module datasheet for capability specification of the rails.

Return

Returns common entity return values

Parameters
  • bEnable: true: enabled: connected to the supply rail voltage; false: disabled: disconnected from the supply rail voltage

aErr setEnable(const unsigned char bEnable)

Set the state of the external rail switch. Not all rails can be switched on and off. Refer to the module datasheet for capability specification of the rails.

Return

Returns common entity return values

Parameters
  • bEnable: true: enable and connect to the supply rail voltage; false: disable and disconnect from the supply rail voltage

DEPRECATED aErr setVoltage (const int microvolts)

Set the rail supply voltage. Rail voltage control capabilities vary between modules. Refer to the module datasheet for definition of the rail voltage capabilities.

Return

Returns common entity return values

Parameters
  • microvolts: The voltage in micro-volts (1 == 1e-6V) to be supply by the rail.

aErr getVoltage(int %microvolts)

Get the rail supply voltage. Rail voltage control capabilities vary between modules. Refer to the module datasheet for definition of the rail voltage capabilities.

Return

Returns common entity return values

Parameters
  • microvolts: The voltage in micro-volts (1 == 1e-6V) currently supplied by the rail. On some modules this is a measured value so it may not exactly match what was previously set via the setVoltage interface. Refer to the module datasheet to to determine if this is a measured or stored value.

aErr setVoltageSetpoint(const int microvolts)

Set the rail setpoint voltage. Rail voltage control capabilities vary between modules. Refer to the module datasheet for definition of the rail voltage capabilities.

Return

Returns common entity return values

Parameters
  • microvolts: The voltage in micro-volts (1 == 1e-6V) to be supply by the rail.

aErr getVoltageSetpoint(int %microvolts)

Get the rail setpoint voltage. Rail voltage control capabilities vary between modules. Refer to the module datasheet for definition of the rail voltage capabilities.

Return

Returns common entity return values

Parameters
  • microvolts: The voltage in micro-volts (1 == 1e-6V) the rail is trying to achieve. On some modules this is a measured value so it may not exactly match what was previously set via the setVoltage interface. Refer to the module datasheet to to determine if this is a measured or stored value.

aErr setVoltageMinLimit(const int microvolts)

Set the rail voltage minimum limit setting. (Check product datasheet to see if this feature is available)

Return

Returns common entity return values

Parameters
  • microvolts: The voltage in micro-volts (1 == 1e-6V).

aErr getVoltageMinLimit(int %microvolts)

Get the rail voltage minimum limit setting. (Check product datasheet to see if this feature is available)

Return

Returns common entity return values

Parameters
  • microvolts: The voltage in micro-volts (1 == 1e-6V).

aErr setVoltageMaxLimit(const int microvolts)

Set the rail voltage maximum limit setting. (Check product datasheet to see if this feature is available)

Return

Returns common entity return values

Parameters
  • microvolts: The voltage in micro-volts (1 == 1e-6V).

aErr getVoltageMaxLimit(int %microvolts)

Get the rail voltage maximum limit setting. (Check product datasheet to see if this feature is available)

Return

Returns common entity return values

Parameters
  • microvolts: The voltage in micro-volts (1 == 1e-6V).

aErr getPower(int %milliwatts)

Get the rail supply power. Rail power control capabilities vary between modules. Refer to the module datasheet for definition of the rail power capabilities.

Return

Returns common entity return values

Parameters
  • milliwatts: The power in milli-watts (1 == 1e-3W) currently supplied by the rail. On some modules this is a measured value so it may not exactly match what was previously set via the setPower interface. Refer to the module datasheet to to determine if this is a measured or stored value.

aErr setPowerSetpoint(const int milliwatts)

Set the rail setpoint power. Rail power control capabilities vary between modules. Refer to the module datasheet for definition of the rail power capabilities.

Return

Returns common entity return values

Parameters
  • milliwatts: The power in milli-watts (1 == 1e-3W) to be supplied by the rail.

aErr getPowerSetpoint(int %milliwatts)

Get the rail setpoint power. Rail power control capabilities vary between modules. Refer to the module datasheet for definition of the rail power capabilities.

Return

Returns common entity return values

Parameters
  • milliwatts: The power in milli-watts (1 == 1e-3W) the rail is trying to achieve. On some modules this is a measured value so it may not exactly match what was previously set via the setPower interface. Refer to the module datasheet to to determine if this is a measured or stored value.

aErr setPowerLimit(const int milliwatts)

Set the rail power maximum limit setting. (Check product datasheet to see if this feature is available)

Return

Returns common entity return values

Parameters
  • milliwatts: The power in milli-watts (1 == 1e-3W).

aErr getPowerLimit(int %milliwatts)

Get the rail power maximum limit setting. (Check product datasheet to see if this feature is available)

Return

Returns common entity return values

Parameters
  • milliwatts: The power in milli-watts (1 == 1e-3W).

aErr getResistance(int %milliohms)

Get the rail load resistance. Rail resistance control capabilities vary between modules. Refer to the module datasheet for definition of the rail resistance capabilities.

Return

Returns common entity return values

Parameters
  • milliohms: The resistance in milli-ohms (1 == 1e-3Ohms) currently drawn by the rail. On some modules this is a measured value so it may not exactly match what was previously set via the setResistance interface. Refer to the module datasheet to to determine if this is a measured or stored value.

aErr setResistanceSetpoint(const int milliohms)

Set the rail setpoint resistance. Rail resistance control capabilities vary between modules. Refer to the module datasheet for definition of the rail resistance capabilities.

Return

Returns common entity return values

Parameters
  • milliohms: The power in milli-ohms (1 == 1e-3Ohms) to be drawn by the rail.

aErr getResistanceSetpoint(int %milliohms)

Get the rail setpoint resistance. Rail resistance control capabilities vary between modules. Refer to the module datasheet for definition of the rail resistance capabilities.

Return

Returns common entity return values

Parameters
  • milliohms: The resistance in milli-ohms (1 == 1e-3Ohms) the rail is trying to achieve. On some modules this is a measured value so it may not exactly match what was previously set via the setResistance interface. Refer to the module datasheet to to determine if this is a measured or stored value.

aErr setKelvinSensingEnable(const unsigned char bEnable)

Enable or Disable kelvin sensing on the module. Refer to the module datasheet for definition of the rail kelvin sensing capabilities.

Return

Returns common entity return values

Parameters
  • bEnable: enable or disable kelvin sensing.

aErr getKelvinSensingEnable(unsigned char %bEnable)

Determine whether kelvin sensing is enabled or disabled. Refer to the module datasheet for definition of the rail kelvin sensing capabilities.

Return

Returns common entity return values

Parameters
  • bEnable: Kelvin sensing is enabled or disabled.

aErr getKelvinSensingState(unsigned char %state)

Determine whether kelvin sensing has been disabled by the system. Refer to the module datasheet for definition of the rail kelvin sensing capabilities.

Return

Returns common entity return values

Parameters
  • state: Kelvin sensing is enabled or disabled.

aErr setOperationalMode(const unsigned char mode)

Set the operational mode of the rail. Refer to the module datasheet for definition of the rail operational capabilities.

Return

Returns common entity return values

Parameters
  • mode: The operational mode to employ.

aErr getOperationalMode(unsigned char %mode)

Determine the current operational mode of the system. Refer to the module datasheet for definition of the rail operational mode capabilities.

Return

Returns common entity return values

Parameters
  • mode: The current operational mode setting.

aErr getOperationalState(unsigned int %state)

Determine the current operational state of the system. Refer to the module datasheet for definition of the rail operational states.

Return

Returns common entity return values

Parameters
  • state: The current operational state.

aErr clearFaults(void)

Clears the current fault state of the rail. Refer to the module datasheet for definition of the rail faults.

Return

Returns common entity return values