GunnsElectUserLoadSwitch2 - nasa/gunns GitHub Wiki

This is a variant of GunnsElectUserLoadSwitch with a slightly different set of features:

• This adds built-in sensor models for the switch input & output voltages and through-current. These sensors have their own malfunctions that can be used to force or block various trips in the switch model.
• In addition to the positive- and negative-direction over-current trips in GunnsElectUserLoadSwitch, this adds input under-voltage and over-voltage trips. Unlike the over-current trips, which require a command to reset, these voltage trips automatically reset when the voltage recovers past a reset value.
• The trip malfunctions and setpoint malfunctions are removed, since this control can be achieved through the sensors’ malfunctions.
• The resistance malfunction is removed, since the link’s blockage malfunction achieves the same thing.
• The power supply model is removed, relegating this to an external model (signal aspect, etc.)

This link is connected and used the same way as GunnsElectUserLoadSwitch.

Same as GunnsElectUserLoadSwitch.

Same as GunnsElectUserLoadSwitch.

Note that this contains the most commonly used, but not all, of the sensor’s configuration data. The rest of the sensor’s configuration data, if needed, can be set via the input file, described below.

• switchResistance (default = 0 (ohm), must be >= FLT_EPSILON): This is the electrical resistance of the switch when it is closed.
• switchTripPriority: same as GunnsElectUserLoadSwitch.
• currentSensorMinRange (default = 0 (amp)): This is the low end of the internal current sensor’s range.
• currentSensorMaxRange (default = 0 (amp), must > currentSensorMinRange): This is the high end of the internal current sensor’s range.
• mInputVoltageSensorMinRange (default = 0 (V)): This is the low end of the internal input voltage sensor’s range.
• mInputVoltageSensorMaxRange (default = 0 (amp), must > mInputVoltageSensorMinRange): This is the high end of the internal input voltage sensor’s range.
• mOutputVoltageSensorMinRange (default = 0 (V)): This is the low end of the internal output voltage sensor’s range.
• mOutputVoltageSensorMaxRange (default = 0 (amp), must > mOutputVoltageSensorMinRange): This is the high end of the internal output voltage sensor’s range.

• malfBlockageFlag: same as GunnsElectUserLoadSwitch.
• malfBlockageValue: same as GunnsElectUserLoadSwitch.
• switchIsClosed: same as GunnsElectUserLoadSwitch. This also initializes the position command to the same value.
• inputUnderVoltageTripLimit (default = 0 (V)): This is the initial setpoint of the input under-voltage trip limit. The switch will trip open if the input voltage drops below this value.
• inputUnderVoltageTripReset (default = 0 (V), must be >= inputUnderVoltageTripLimit): This is the initial setpoint of the input under-voltage trip reset. If the switch is tripped open due to input under-voltage, doesn’t also have an over-current trip, and is still commanded closed, then it will automatically re-close when the input voltage rises above this value.
• inputOverVoltageTripLimit (default = 0 (V)): This is the initial setpoint of the input over-voltage trip limit. The switch will trip open if the input voltage rises above this value.
• inputOverVoltageTripReset (default = 0 (V), must be <= inputOverVoltageTripLimit): This is the initial setpoint of the input over-voltage trip reset. If the switch is tripped open due to input over-voltage, doesn’t also have an over-current trip, and is still commanded closed, then it will automatically re-close when the input voltage drops below this value.
• switchPosTripLimit: same as GunnsElectUserLoadSwitch.
• switchNegTripLimit: same as GunnsElectUserLoadSwitch.
• loadsOverrideActive (default = false): This is the initial state of the loads voltage override mode. When active, it supplies the loads override voltage to the user loads, regardless of actual input voltage or switch position.
• loadsOverrideVoltage (default = 0 (V)): This is the initial value of voltage supplied to the user loads when the loads voltage override is active.

The remainder of the internal sensors’ configuration and input data can be set from the input file. The link’s configuration and input data objects have these objects for fully defining the sensor:

• mCurrentSensor: The config and input data objects for the switch through-current sensor.
• mInputVoltageSensor: The config and input data objects for the switch input voltage sensor.
• mInputVoltageSensor: The config and input data objects for the switch output voltage sensor.

• TBD.

• N/A

• N/A