Simulated Failures - alanbjohnston/CubeSatSim GitHub Wiki

In addition to simulating telemetry, the CubeSatSim software can also simulate failures which are shown in the telemetry. For more information about Simulated Telemetry, see https://github.com/alanbjohnston/CubeSatSim/wiki/Simulated-Telemetry

To turn on simulated failures, type the CubeSatSim/config -M command in the Pi Zero 2. One failure at a time can be simulated. To turn off simulated failures, type CubeSatSim/config -M 0 Note that failure modes 1-10 are sensor values while failure mode 11 is a FM transmitter failure, so no transmission will be seen in APRS, CW, and SSTV modes.

You can see if simulated failures are active, and which failure, using the CubeSatSim/config command on the Pi Zero 2. In addition, if a failure is being simulated, simulated telemetry will be indicated in the CW ID and telemetry (e.g Simulated Telemetry ON in FoxTelem or the letter S in other modes).

Here is the list of simulated failures and the number used to activate them with the CubeSatSim/config -M command

   0  No Failure (turned OFF)
   1  +Y Solar Panel Unplugged
   2  +X Solar Panel Failure
   3  -X Solar Panel Degradation
   4  -Y Solar Panel Short Circuit
   5  Failed I2C Bus 1
   6  Failed I2C Bus 3
   7  Failed Camera
   8  Failed Payload
   9  Failed BME Sensor
  10  Failed MPU Sensor
  11  Failed FM Audio

For example, to simulate a complete payload failure, type: CubeSatSim/config -M 8 To turn off all simulated failures, type CubeSatSim/config -M 0

Different telemetry modes allow different failures to be seen. Failure modes 1-10 can be seen in FoxTelem, while failure modes 5 and 8-11 can be seen in APRS, failure modes 1-6 and 11 can be seen in CW, and only failure modes 5 and 11 can be see in SSTV.

Here is where to see the simulated failures in FoxTelem for FSK and BPSK modes:

The different simulated failures are labeled by the failure number in different colors. For failure mode 1, +Y Solar Panel Unplugged (red), the voltage and current will read as if the solar panel is unplugged (e.g. voltage in the range 0.8 - 1 V and the current zero). For failure mode 2, +X Solar Panel Failure (green), the voltage and current will both read zero. For failure mode 3, -X Solar Panel Degradation (yellow), the voltage and current will read approximately 1/2 of their normal values. For failure mode 4, -Y Solar Panel Short Circuit (orange), the voltage will read zero but the current will be normal. For failure mode 5, Failed I2C Bus 1 (aqua), it will read FAIL and the Battery, +X, and +Y voltages and currents will all read zero. For failure mode 6, Failed I2C Bus 3 (blue), it will read FAIL and the -X, -Y, +Z, and -Z voltages and currents will all read zero. For failure mode 7, Failed Camera (pink), the Camera will show FAIL. For failure mode 8, Failed Payload (purple), STEM Payload Status will show FAIL and the BME (brown) and MPU (black) sensors will all read zero. For failure mode 9, Failed BME Sensor (brown), the four BME sensors will all read zero. For failure mode 10, Failed MPU Sensor (black), the six MPU sensors will all read zero in the +X, +Y, and +Z panels.

You can also enable random simulated failure mode by the CubeSatSim/config -U command. This will cause the software to randomly switch between the modes 1-10 at a time interval. The default interval is 30 seconds, but you can change it. You will be prompted for the number of seconds that a failure is simulated before moving on to the next random failure. Note that when in random simulated failure mode, the command CubeSatSim/config -M 0 does not turn off the random failure mode. To turn off the random failure mode, you must type CubeSatSim/config -U again.

Failures can be simulated with either real or simulated telemetry, depending on which mode the CubeSatSim is. If the CubeSatSim is not in the simulated telemetry mode, but a failure is simulated, the simulated telemetry indication will be set (e.g Simulated Telemetry ON in FoxTelem or the letter S in other modes) but only the failure is simulated - the rest of the values are actual sensor data.

If simulated telemetry mode is turned off with the CubeSatSim/config -t command, any simulated failure will also be turned off.

For more information about Simulated Telemetry, see https://github.com/alanbjohnston/CubeSatSim/wiki/Simulated-Telemetry