System Entity¶
API Documentation: [cpp] [python] [.NET] [CCA] [REST]
Every BrainStem module includes a single system entity. The system entity allows the retrieval and manipulation of configuration settings like the module address and input voltage, control over the user LED, as well as other functionality.
Serial Number¶
Every USBExt3c is assigned a unique serial number at the factory. This facilitates an arbitrary number of USBExt3c devices attached to a host computer. The following method call can retrieve the unique serial number for each device.
Saved Settings¶
Some entities can be configured and saved to non-volatile memory. This allows a user to modify the startup and operational behavior for the USBExt3c away from the factory default settings. Saving system settings preserves the settings as the new default. Most changes to system settings require a save and reboot before taking effect. Use the following command to save changes to system settings before reboot:
System Power¶
The USBExt3c is designed to accept power from either a Type-C PD port or over PoE.
This value represents the maximum amount of power the USBExt3c can budget for all of its sinking devices. This value can be acquired through:
It is possible that the limit of your PD source may not match that of what is being advertised by the function above. The contributing factors can be determined by checking the state of the power limit.
Power Budgeting and Behavior¶
As we alluded to in the System power section the USBExt3c has to be a bit clever about accounting for all input and output power. The method by which an input power source is selected and used is referred to as Input Power Behavior. It can be configured through
Some behaviors require additional configuration. In most cases this is a list of port numbers that define which ports should be prioritized for input power.