Beacon Definition
=================

YAML configuration file that defines this beacon can be found at: https://github.com/oresat/oresat-configs/blob/master/oresat_configs/oresat0/beacon.yaml

AX.25 Header
------------

+------------------+-----------------------------------+-----------+-----------------------------------+-----------+---------+-----+
|                  | Dest Callsign                     | Dest SSID | Src Callsign                      | Src SSID  | Control | PID |
+==================+=====+=====+=====+=====+=====+=====+===========+=====+=====+=====+=====+=====+=====+===========+=========+=====+
| Value            | "S" | "P" | "A" | "C" | "E" | " " | 60        | "K" | "J" | "7" | "S" | "A" | "T" | 61        | 03      | F0  |
+------------------+-----+-----+-----+-----+-----+-----+-----------+-----+-----+-----+-----+-----+-----+-----------+---------+-----+
| Hex              | 53  | 50  | 41  | 43  | 45  | 20  | 60        | 4B  | 4A  | 37  | 53  | 41  | 54  | 61        | 03      | F0  |
+------------------+-----+-----+-----+-----+-----+-----+-----------+-----+-----+-----+-----+-----+-----+-----------+---------+-----+
| Hex (bitshifted) | A6  | A0  | 82  | 86  | 8A  | 40  | 60        | 96  | 94  | 6E  | A6  | 82  | A8  | 61        | 03      | F0  |
+------------------+-----+-----+-----+-----+-----+-----+-----------+-----+-----+-----+-----+-----+-----+-----------+---------+-----+
| Offset           | 0   | 1   | 2   | 3   | 4   | 5   | 6         | 7   | 8   | 9   | 10  | 11  | 12  | 13        | 14      | 15  |
+------------------+-----+-----+-----+-----+-----+-----+-----------+-----+-----+-----+-----+-----+-----+-----------+---------+-----+

Total header length: 16 octets

Packet
------

.. csv-table::
   :header: "Offset", "Card", "Name", "Unit", "Data Type", "Size", "Description"

   "0", "c3", "ax25_header", "", "octet_str", "16", "
   ax.25 packet header (see above)
   "
   "16", "c3", "beacon_start_chars", "", "str", "3", "
   the aprs start characters
   : {{z
   "
   "19", "c3", "satellite_id", "", "uint8", "1", "
   the unique oresat satellite id
   : 1
   
   
   Value Descriptions:
   
   - 1: oresat0
   
   - 2: oresat0_5
   
   - 3: oresat1
   "
   "20", "c3", "beacon_revision", "", "uint8", "1", "
   the beacon revision number
   : 0
   "
   "21", "c3", "status", "", "uint8", "1", "
   
   
   
   Value Descriptions:
   
   - 66: pre_deply
   
   - 67: deploy
   
   - 68: standby
   
   - 69: beacon
   
   - 70: edl
   "
   "22", "c3", "system_uptime", "s", "uint32", "4", "
   uptime
   "
   "26", "c3", "system_unix_time", "s", "uint32", "4", "
   unix time
   "
   "30", "c3", "system_power_cycles", "", "uint16", "2", "
   the number of power cycles
   "
   "32", "c3", "system_storage_percent", "%", "uint8", "1", "
   the current storage percent used
   "
   "33", "c3", "lband_rx_bytes", "B", "uint32", "4", "
   lband received byte count
   "
   "37", "c3", "lband_rx_packets", "", "uint32", "4", "
   lband received packet count
   "
   "41", "c3", "lband_rssi", "dB", "int8", "1", "
   lband rssi of last packet received as reported by AX5043
   "
   "42", "c3", "uhf_rx_bytes", "B", "uint32", "4", "
   uhf received byte count
   "
   "46", "c3", "uhf_rx_packets", "", "uint32", "4", "
   uhf received packet count
   "
   "50", "c3", "uhf_rssi", "dB", "int8", "1", "
   uhf rssi of last packet received after lna, filters, and digital channel filter
   "
   "51", "c3", "system_boot_select", "", "uint8", "1", "
   
   
   
   Bit Definitions:
   
   - CURRENT_BOOT: [0]
   
   - NEXT_BOOT: [1]
   "
   "52", "c3", "edl_sequence_count", "", "uint32", "4", "
   edl sequence count
   "
   "56", "c3", "edl_rejected_count", "", "uint32", "4", "
   edl sequence count
   "
   "60", "battery_1", "pack_1_vbatt", "mV", "uint16", "2", "
   pack voltage
   "
   "62", "battery_1", "pack_1_vcell", "mV", "uint16", "2", "
   lowest cell voltage
   "
   "64", "battery_1", "pack_1_vcell_max", "mV", "uint16", "2", "
   max voltage for a cell
   "
   "66", "battery_1", "pack_1_vcell_min", "mV", "uint16", "2", "
   min voltage for a cell
   "
   "68", "battery_1", "pack_1_vcell_1", "mV", "uint16", "2", "
   cell 1 voltage
   "
   "70", "battery_1", "pack_1_vcell_2", "mV", "uint16", "2", "
   cell 2 voltage
   "
   "72", "battery_1", "pack_1_vcell_avg", "mV", "uint16", "2", "
   average voltage of both cells
   "
   "74", "battery_1", "pack_1_temperature", "C", "int16", "2", "
   temperature of battery pack
   "
   "76", "battery_1", "pack_1_temperature_avg", "C", "int16", "2", "
   average temperature of battery pack
   "
   "78", "battery_1", "pack_1_temperature_max", "C", "int16", "2", "
   max temperature of battery pack
   "
   "80", "battery_1", "pack_1_temperature_min", "C", "int16", "2", "
   min temperature of battery pack
   "
   "82", "battery_1", "pack_1_current", "mA", "int16", "2", "
   pack current
   "
   "84", "battery_1", "pack_1_current_avg", "mA", "int16", "2", "
   pack average current
   "
   "86", "battery_1", "pack_1_current_max", "mA", "int16", "2", "
   pack max current
   "
   "88", "battery_1", "pack_1_current_min", "mA", "int16", "2", "
   pack min current
   "
   "90", "battery_1", "pack_1_status", "", "uint8", "1", "
   
   
   
   Bit Definitions:
   
   - HEATER_ON: [0]
   
   - DISCHARGE_DISABLE: [1]
   
   - CHARGE_DISABLE: [2]
   
   - DISCHARGE_STATUS: [3]
   
   - CHARGE_STATUS: [4]
   "
   "91", "battery_1", "pack_1_reported_state_of_charge", "%", "uint8", "1", "
   reported charge percent
   "
   "92", "battery_1", "pack_1_full_capacity", "mAh", "uint16", "2", "
   capacity of battery pack
   "
   "94", "battery_1", "pack_1_reported_capacity", "mAh", "uint16", "2", "
   reported capacity of battery pack
   "
   "96", "battery_1", "pack_2_vbatt", "mV", "uint16", "2", "
   pack voltage
   "
   "98", "battery_1", "pack_2_vcell", "mV", "uint16", "2", "
   lowest cell voltage
   "
   "100", "battery_1", "pack_2_vcell_max", "mV", "uint16", "2", "
   max voltage for a cell
   "
   "102", "battery_1", "pack_2_vcell_min", "mV", "uint16", "2", "
   min voltage for a cell
   "
   "104", "battery_1", "pack_2_vcell_1", "mV", "uint16", "2", "
   cell 1 voltage
   "
   "106", "battery_1", "pack_2_vcell_2", "mV", "uint16", "2", "
   cell 2 voltage
   "
   "108", "battery_1", "pack_2_vcell_avg", "mV", "uint16", "2", "
   average voltage of both cells
   "
   "110", "battery_1", "pack_2_temperature", "C", "int16", "2", "
   temperature of battery pack
   "
   "112", "battery_1", "pack_2_temperature_avg", "C", "int16", "2", "
   average temperature of battery pack
   "
   "114", "battery_1", "pack_2_temperature_max", "C", "int16", "2", "
   max temperature of battery pack
   "
   "116", "battery_1", "pack_2_temperature_min", "C", "int16", "2", "
   min temperature of battery pack
   "
   "118", "battery_1", "pack_2_current", "mA", "int16", "2", "
   pack current
   "
   "120", "battery_1", "pack_2_current_avg", "mA", "int16", "2", "
   pack average current
   "
   "122", "battery_1", "pack_2_current_max", "mA", "int16", "2", "
   pack max current
   "
   "124", "battery_1", "pack_2_current_min", "mA", "int16", "2", "
   pack min current
   "
   "126", "battery_1", "pack_2_status", "", "uint8", "1", "
   
   
   
   Bit Definitions:
   
   - HEATER_ON: [0]
   
   - DISCHARGE_DISABLE: [1]
   
   - CHARGE_DISABLE: [2]
   
   - DISCHARGE_STATUS: [3]
   
   - CHARGE_STATUS: [4]
   "
   "127", "battery_1", "pack_2_reported_state_of_charge", "%", "uint8", "1", "
   reported charge percent
   "
   "128", "battery_1", "pack_2_full_capacity", "mAh", "uint16", "2", "
   capacity of battery pack
   "
   "130", "battery_1", "pack_2_reported_capacity", "mAh", "uint16", "2", "
   reported capacity of battery pack
   "
   "132", "solar_1", "output_voltage_avg", "mV", "uint16", "2", "
   average voltage
   "
   "134", "solar_1", "output_current_avg", "mA", "int16", "2", "
   average current
   "
   "136", "solar_1", "output_power_avg", "mW", "uint16", "2", "
   average power
   "
   "138", "solar_1", "output_voltage_max", "mV", "uint16", "2", "
   max voltage
   "
   "140", "solar_1", "output_current_max", "mA", "int16", "2", "
   max current
   "
   "142", "solar_1", "output_power_max", "mW", "uint16", "2", "
   max power
   "
   "144", "solar_1", "output_energy", "mJ", "uint16", "2", "
   storing energy
   "
   "146", "solar_2", "output_voltage_avg", "mV", "uint16", "2", "
   average voltage
   "
   "148", "solar_2", "output_current_avg", "mA", "int16", "2", "
   average current
   "
   "150", "solar_2", "output_power_avg", "mW", "uint16", "2", "
   average power
   "
   "152", "solar_2", "output_voltage_max", "mV", "uint16", "2", "
   max voltage
   "
   "154", "solar_2", "output_current_max", "mA", "int16", "2", "
   max current
   "
   "156", "solar_2", "output_power_max", "mW", "uint16", "2", "
   max power
   "
   "158", "solar_2", "output_energy", "mJ", "uint16", "2", "
   storing energy
   "
   "160", "solar_3", "output_voltage_avg", "mV", "uint16", "2", "
   average voltage
   "
   "162", "solar_3", "output_current_avg", "mA", "int16", "2", "
   average current
   "
   "164", "solar_3", "output_power_avg", "mW", "uint16", "2", "
   average power
   "
   "166", "solar_3", "output_voltage_max", "mV", "uint16", "2", "
   max voltage
   "
   "168", "solar_3", "output_current_max", "mA", "int16", "2", "
   max current
   "
   "170", "solar_3", "output_power_max", "mW", "uint16", "2", "
   max power
   "
   "172", "solar_3", "output_energy", "mJ", "uint16", "2", "
   storing energy
   "
   "174", "solar_4", "output_voltage_avg", "mV", "uint16", "2", "
   average voltage
   "
   "176", "solar_4", "output_current_avg", "mA", "int16", "2", "
   average current
   "
   "178", "solar_4", "output_power_avg", "mW", "uint16", "2", "
   average power
   "
   "180", "solar_4", "output_voltage_max", "mV", "uint16", "2", "
   max voltage
   "
   "182", "solar_4", "output_current_max", "mA", "int16", "2", "
   max current
   "
   "184", "solar_4", "output_power_max", "mW", "uint16", "2", "
   max power
   "
   "186", "solar_4", "output_energy", "mJ", "uint16", "2", "
   storing energy
   "
   "188", "star_tracker_1", "system_storage_percent", "%", "uint8", "1", "
   the current storage percent used
   "
   "189", "star_tracker_1", "fread_cache_length", "", "uint8", "1", "
   number of files in fread cache
   "
   "190", "star_tracker_1", "updater_status", "", "uint8", "1", "
   status of the updater
   
   
   Value Descriptions:
   
   - 0: successful
   
   - 1: pre_process_error
   
   - 2: run_error
   
   - 255: in_progress
   "
   "191", "star_tracker_1", "updater_cache_length", "", "uint8", "1", "
   number of updates cached
   "
   "192", "star_tracker_1", "orientation_right_ascension", "deg", "int16", "2", "
   the right ascension of the satellite
   "
   "194", "star_tracker_1", "orientation_declination", "deg", "int16", "2", "
   the delination of the satellite
   "
   "196", "star_tracker_1", "orientation_roll", "deg", "int16", "2", "
   the roll of the satellite
   "
   "198", "star_tracker_1", "orientation_time_since_midnight", "ms", "uint32", "4", "
   time since midnight when the image was captured
   "
   "202", "gps", "system_storage_percent", "%", "uint8", "1", "
   the current storage percent used
   "
   "203", "gps", "fread_cache_length", "", "uint8", "1", "
   number of files in fread cache
   "
   "204", "gps", "updater_status", "", "uint8", "1", "
   status of the updater
   
   
   Value Descriptions:
   
   - 0: successful
   
   - 1: pre_process_error
   
   - 2: run_error
   
   - 255: in_progress
   "
   "205", "gps", "updater_cache_length", "", "uint8", "1", "
   number of updates cached
   "
   "206", "gps", "status", "", "uint8", "1", "
   
   
   
   Value Descriptions:
   
   - 0: off
   
   - 1: searching
   
   - 2: locked
   
   - 255: error
   "
   "207", "gps", "skytraq_number_of_sv", "", "uint8", "1", "
   number of gps satellites locked onto
   "
   "208", "gps", "skytraq_ecef_x", "km", "int32", "4", "
   ecef x coordinate
   "
   "212", "gps", "skytraq_ecef_y", "km", "int32", "4", "
   ecef y coordinate
   "
   "216", "gps", "skytraq_ecef_z", "km", "int32", "4", "
   ecef z coordinate
   "
   "220", "gps", "skytraq_ecef_vx", "km/s", "int32", "4", "
   ecef x velocity
   "
   "224", "gps", "skytraq_ecef_vy", "km/s", "int32", "4", "
   ecef y velocity
   "
   "228", "gps", "skytraq_ecef_vz", "km/s", "int32", "4", "
   ecef z velocity
   "
   "232", "gps", "skytraq_time_since_midnight", "ms", "uint32", "4", "
   time since midnight when the gps data was received
   "
   "236", "adcs", "gyroscope_roll_rate", "deg/s", "int16", "2", "
   z-axis rate
   "
   "238", "adcs", "gyroscope_pitch_rate", "deg/s", "int16", "2", "
   x-axis rate
   "
   "240", "adcs", "gyroscope_yaw_rate", "deg/s", "int16", "2", "
   y-axis rate
   "
   "242", "adcs", "temperature", "C", "int8", "1", "
   imu sensor temperature
   "
   "243", "dxwifi", "system_storage_percent", "%", "uint8", "1", "
   the current storage percent used
   "
   "244", "dxwifi", "fread_cache_length", "", "uint8", "1", "
   number of files in fread cache
   "
   "245", "dxwifi", "updater_status", "", "uint8", "1", "
   status of the updater
   
   
   Value Descriptions:
   
   - 0: successful
   
   - 1: pre_process_error
   
   - 2: run_error
   
   - 255: in_progress
   "
   "246", "dxwifi", "updater_cache_length", "", "uint8", "1", "
   number of updates cached
   "
   "247", "dxwifi", "status", "", "uint8", "1", "
   the dxwifi status
   
   
   Value Descriptions:
   
   - 0: off
   
   - 1: boot
   
   - 2: standby
   
   - 3: film
   
   - 4: transmit
   
   - 5: purge
   
   - 255: error
   "
   "248", "c3", "crc32", "", "uint32", "4", "packet checksum"

Total packet length: 252 octets