Digital¶
- class brainstem.entity.Digital(module, index)[source]¶
DigitalClass: Interface to digital entities on BrainStem modules. Digital entities have the following 5 possibilities: Digital Input, Digital Output, RCServo Input, RCServo Output, and HighZ. Other capabilities may be available and not all pins support all configurations. Please see the product datasheet.
- getConfiguration()[source]¶
Get the digital configuration. - Current configuration of the digital entity.
- Returns:
Result object containing the requested value when the results error is set to NO_ERROR(0)
- Return type:
- getState()[source]¶
Get the state. The current state of the digital entity. 0 is logic low, 1 is logic high. Note: If in high Z state an error will be returned.
- Returns:
Result object containing the requested value when the results error is set to NO_ERROR(0)
- Return type:
- getStateAll()[source]¶
Gets the logical state of all available digitals in a bit mapped representation. Number of digitals varies across BrainStem modules. Refer to the datasheet for the capabilities of your module. The state of all digitals where bit 0 = digital 0, bit 1 = digital 1 etc. 0 is logic low, 1 is logic high.
- Returns:
Result object containing the requested value when the results error is set to NO_ERROR(0)
- Return type:
- setConfiguration(configuration)[source]¶
Set the digital configuration to one of the available 5 states. Note: Some configurations are only supported on specific pins. aErrConfiguration Entity does not support this configuration.
- Parameters:
configuration (const unsigned char) – The configuration to be applied - Digital Input: digitalConfigurationInput = 0 - Digital Output: digitalConfigurationOutput = 1 - RCServo Input: digitalConfigurationRCServoInput = 2 - RCServo Output: digitalConfigurationRCServoOutput = 3 - High Z State: digitalConfigurationHiZ = 4 - Digital Input: digitalConfigurationInputPullUp = 0 - Digital Input: digitalConfigurationInputNoPull = 4 - Digital Input: digitalConfigurationInputPullDown = 5
- Returns:
An error result from the list of defined error codes in brainstem.result
- Return type:
unsigned byte
- setState(state)[source]¶
Set the logical state.
- Parameters:
state (const unsigned char) – The state to be set. 0 is logic low, 1 is logic high.
- Returns:
An error result from the list of defined error codes in brainstem.result
- Return type:
unsigned byte
- setStateAll(state)[source]¶
Sets the logical state of all available digitals based on the bit mapping. Number of digitals varies across BrainStem modules. Refer to the datasheet for the capabilities of your module.
- Parameters:
state (const unsigned int) – The state to be set for all digitals in a bit mapped representation. 0 is logic low, 1 is logic high. Where bit 0 = digital 0, bit 1 = digital 1 etc.
- Returns:
An error result from the list of defined error codes in brainstem.result
- Return type:
unsigned byte