From efefd21d0ee68ada3775e624629bf8d7e111991f Mon Sep 17 00:00:00 2001
From: Elvin Chen <20195216+ElvinC@users.noreply.github.com>
Date: Thu, 17 Aug 2023 03:37:02 +0200
Subject: [PATCH] Clean code a bit
---
Firmware/.settings/language.settings.xml | 4 +-
Firmware/Core/Src/main.c | 482 +-
Firmware/Debug/Core/Src/main.o | Bin 926880 -> 928880 bytes
Firmware/Debug/Core/Src/main.su | 56 +-
Firmware/Debug/rocketbeacon.elf | Bin 1132368 -> 1132420 bytes
Firmware/Debug/rocketbeacon.list | 13739 ++++++++++-----------
Firmware/Debug/rocketbeacon.map | 1129 +-
7 files changed, 7586 insertions(+), 7824 deletions(-)
diff --git a/Firmware/.settings/language.settings.xml b/Firmware/.settings/language.settings.xml
index 6499965..d511d5b 100644
--- a/Firmware/.settings/language.settings.xml
+++ b/Firmware/.settings/language.settings.xml
@@ -5,7 +5,7 @@
-
+
@@ -16,7 +16,7 @@
-
+
diff --git a/Firmware/Core/Src/main.c b/Firmware/Core/Src/main.c
index bd2cf12..c7b36f5 100644
--- a/Firmware/Core/Src/main.c
+++ b/Firmware/Core/Src/main.c
@@ -60,216 +60,157 @@ static void MX_USART2_UART_Init(void);
static void MX_CRC_Init(void);
/* USER CODE BEGIN PFP */
+void SetStandbyXOSC();
+void SetPacketTypeLora();
+void SetPacketTypeFSK();
+uint32_t ComputeRfFreq(double frequencyMhz);
+void SetRfFreq(uint32_t rfFreq);
+void SetPaLowPower();
+void SetPa22dB();
+void SetTxPower(int8_t powerdBm);
+void SetContinuousWave();
+void SetTxInfinitePreamble();
+void SetTx(uint32_t timeout);
+void SetRx(uint32_t timeout);
+void SetModulationParamsLora(const uint8_t params[4]);
+void SetModulationParamsFSK(uint32_t bitrate, uint8_t pulseshape, uint8_t bandwidth, uint32_t freq_dev);
+void SetPacketParamsLora(uint16_t preamble_length, bool header_fixed, uint8_t payload_length, bool crc_enabled, bool invert_iq);
+void FSKBeep(int8_t powerdBm, uint32_t toneHz, uint32_t lengthMs);
+void CWBeep(int8_t powerdBm, uint32_t lengthMs);
+
/* USER CODE END PFP */
/* Private user code ---------------------------------------------------------*/
/* USER CODE BEGIN 0 */
-void SetStandbyXOSC() {
- uint8_t txbuf[2] = {0x80, 0x01};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetPacketTypeLora() {
- uint8_t txbuf[2] = {0x8A, 0x01};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetPacketTypeFSK() {
- uint8_t txbuf[2] = {0x8A, 0x00};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-uint32_t ComputeRfFreq(double frequencyMhz) {
- return (uint32_t)(frequencyMhz * 1048576L); //2^25/(32e6)
-}
-
-void SetRfFreq(uint32_t rfFreq) {
- uint8_t txbuf[5] = {0x86, (rfFreq & 0xFF000000) >> 24, (rfFreq & 0x00FF0000) >> 16, (rfFreq & 0x0000FF00) >> 8, rfFreq & 0x000000FF};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetPaLowPower() {
- // set Pa to 14 dB.
- uint8_t txbuf[5] = {0x95, 0x02, 0x02, 0x00, 0x01};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetPa22dB() {
- // set Pa to the highest 22 dBm
- uint8_t txbuf[5] = {0x95, 0x04, 0x07, 0x00, 0x01};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetTxPower(int8_t powerdBm) {
- // Between -9 and 22
- uint8_t txbuf[3] = {0x8E, (uint8_t) powerdBm, 0x02};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetContinuousWave() {
- uint8_t txbuf[1] = {0xD1};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf, 0);
-}
-
-void SetTxInfinitePreamble() {
- uint8_t txbuf[1] = {0xD2};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf, 0);
-}
-
-void SetTx(uint32_t timeout) {
- // Timeout * 15.625 µs
- uint8_t txbuf[4] = {0x83, (timeout & 0x00FF0000) >> 16, (timeout & 0x0000FF00) >> 8, timeout & 0x000000FF};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetRx(uint32_t timeout) {
- // Timeout * 15.625 µs
- // 0x000000 No timeout. Rx Single mode
- // 0xFFFFFF Rx Continuous mode. The device remains in RX mode until the host sends a command to change the operation mode
- uint8_t txbuf[4] = {0x82, (timeout & 0x00FF0000) >> 16, (timeout & 0x0000FF00) >> 8, timeout & 0x000000FF};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetModulationParamsLora(const uint8_t params[4]) {
- uint8_t txbuf[5] = {0x8B, params[0], params[1], params[2], params[3]};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetModulationParamsFSK(uint32_t bitrate, uint8_t pulseshape, uint8_t bandwidth, uint32_t freq_dev) {
- uint32_t BR = 32 * 32e6 / bitrate;
- uint32_t fdev = (uint32_t) (freq_dev * 1.048576L); // 2^25/32e6 = 1.048576
- uint8_t txbuf[9] = {0x8B, (BR & 0x00FF0000) >> 16, (BR & 0x0000FF00) >> 8, BR & 0x000000FF, pulseshape, bandwidth, (fdev & 0x00FF0000) >> 16, (fdev & 0x0000FF00) >> 8, fdev & 0x000000FF};
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
-void SetPacketParamsLora(uint16_t preamble_length, bool header_fixed, uint8_t payload_length, bool crc_enabled, bool invert_iq) {
- uint8_t txbuf[7] = {0x8C, (uint8_t)((preamble_length >> 8) & 0xFF), (uint8_t)(preamble_length & 0xFF),
- (uint8_t) header_fixed, payload_length, (uint8_t) crc_enabled, (uint8_t) invert_iq};
-
- HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
-}
-
+// standard frequencies. Note: zero indexed.
+const double LPD433[69] = {
+ 433.075, 433.100, 433.125, 433.150, 433.175, 433.200, 433.225, 433.250, 433.275, 433.300, // 1-10
+ 433.325, 433.350, 433.375, 433.400, 433.425, 433.450, 433.475, 433.500, 433.525, 433.550, // 11-20
+ 433.575, 433.600, 433.625, 433.650, 433.675, 433.700, 433.725, 433.750, 433.775, 433.800, // 21-30
+ 433.825, 433.850, 433.875, 433.900, 433.925, 433.950, 433.975, 434.000, 434.025, 434.050, // 31-40
+ 434.075, 434.100, 434.125, 434.150, 434.175, 434.200, 434.225, 434.250, 434.275, 434.300, // 41-50
+ 434.325, 434.350, 434.375, 434.400, 434.425, 434.450, 434.475, 434.500, 434.525, 434.550, // 51-60
+ 434.575, 434.600, 434.625, 434.650, 434.675, 434.700, 434.725, 434.750, 434.775 // 61-69
+};
-void FSKBeep(int8_t powerdBm, uint32_t toneHz, uint32_t lengthMs) {
- // assume in standbyXOSC already.
- HAL_Delay(1);
- SetTxPower(powerdBm);
- SetModulationParamsFSK(toneHz*2, 0x09, 0x1E, 2500);
- HAL_Delay(5);
- SetTxInfinitePreamble();
- HAL_Delay(lengthMs);
- SetStandbyXOSC();
- HAL_Delay(5);
-}
+const double PMR446[16] = {
+ 446.00625, 446.01875, 446.03125, 446.04375, 446.05625, // 1-5
+ 446.06875, 446.08125, 446.09375, 446.10625, 446.11875, // 6-10
+ 446.13125, 446.14375, 446.15625, 446.16875, 446.18125, // 11-15
+ 446.19375 // 16
+};
-void CWBeep(int8_t powerdBm, uint32_t lengthMs) {
- HAL_Delay(1);
- SetTxPower(powerdBm);
- HAL_Delay(5);
- SetContinuousWave();
- HAL_Delay(lengthMs);
- SetStandbyXOSC();
- HAL_Delay(5);
-}
+const double FRS[22] = {
+ 462.5625, 462.5875, 462.6125, 462.6375, 462.6625, 462.6875, 462.7125, 467.5625, 467.5875, 467.6125, // 1-10
+ 467.6375, 467.6625, 467.6875, 467.7125, 462.5500, 462.5750, 462.6000, 462.6250, 462.6500, 462.6750, // 11-20
+ 462.7000, 462.7250 // 21-22
+};
// letter to morse based on ASCII characters.
// right-terminated by a "1". 1 is dah, 0 is dit.
const uint8_t morse_chars[] = {
- 0b11111111, // Special code for SPACE
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b11100000, // Minus sign (indicated by "M")
- 0b10000000, // N/A
- 0b10010100, // "/" Slash
- 0b11111100, // "0"
- 0b01111100, // "1"
- 0b00111100, // "2"
- 0b00011100, // "3"
- 0b00001100, // "4"
- 0b00000100, // "5"
- 0b10000100, // "6"
- 0b11000100, // "7"
- 0b11100100, // "8"
- 0b11110100, // "9"
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10001100, // "=" BT prosign/Equal sign
- 0b10000000, // N/A
- 0b00110010, // "?" Question mark
- 0b10000000, // N/A
- 0b01100000, // "A"
- 0b10001000, // "B"
- 0b10101000, // "C"
- 0b10010000, // "D"
- 0b01000000, // "E"
- 0b00101000, // "F"
- 0b11010000, // "G"
- 0b00001000, // "H"
- 0b00100000, // "I"
- 0b01111000, // "J"
- 0b10110000, // "K"
- 0b01001000, // "L"
- 0b11100000, // "M"
- 0b10100000, // "N"
- 0b11110000, // "O"
- 0b01101000, // "P"
- 0b11011000, // "Q"
- 0b01010000, // "R"
- 0b00010000, // "S"
- 0b11000000, // "T"
- 0b00110000, // "U"
- 0b00011000, // "V"
- 0b01110000, // "W"
- 0b10011000, // "X"
- 0b10111000, // "Y"
- 0b11001000, // "Z"
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b10000000, // N/A
- 0b01100000, // "a"
- 0b10001000, // "b"
- 0b10101000, // "c"
- 0b10010000, // "d"
- 0b01000000, // "e"
- 0b00101000, // "f"
- 0b11010000, // "g"
- 0b00001000, // "h"
- 0b00100000, // "i"
- 0b01111000, // "j"
- 0b10110000, // "k"
- 0b01001000, // "l"
- 0b11100000, // "m"
- 0b10100000, // "n"
- 0b11110000, // "o"
- 0b01101000, // "p"
- 0b11011000, // "q"
- 0b01010000, // "r"
- 0b00010000, // "s"
- 0b11000000, // "t"
- 0b00110000, // "u"
- 0b00011000, // "v"
- 0b01110000, // "w"
- 0b10011000, // "x"
- 0b10111000, // "y"
- 0b11001000 // "z"
+ 0b11111111, // Special code for SPACE
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000110, // - Hyphen sign
+ 0b10000000, // N/A
+ 0b10010100, // "/" Slash
+ 0b11111100, // "0"
+ 0b01111100, // "1"
+ 0b00111100, // "2"
+ 0b00011100, // "3"
+ 0b00001100, // "4"
+ 0b00000100, // "5"
+ 0b10000100, // "6"
+ 0b11000100, // "7"
+ 0b11100100, // "8"
+ 0b11110100, // "9"
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10001100, // "=" BT prosign/Equal sign
+ 0b10000000, // N/A
+ 0b00110010, // "?" Question mark
+ 0b10000000, // N/A
+ 0b01100000, // "A"
+ 0b10001000, // "B"
+ 0b10101000, // "C"
+ 0b10010000, // "D"
+ 0b01000000, // "E"
+ 0b00101000, // "F"
+ 0b11010000, // "G"
+ 0b00001000, // "H"
+ 0b00100000, // "I"
+ 0b01111000, // "J"
+ 0b10110000, // "K"
+ 0b01001000, // "L"
+ 0b11100000, // "M"
+ 0b10100000, // "N"
+ 0b11110000, // "O"
+ 0b01101000, // "P"
+ 0b11011000, // "Q"
+ 0b01010000, // "R"
+ 0b00010000, // "S"
+ 0b11000000, // "T"
+ 0b00110000, // "U"
+ 0b00011000, // "V"
+ 0b01110000, // "W"
+ 0b10011000, // "X"
+ 0b10111000, // "Y"
+ 0b11001000, // "Z"
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b10000000, // N/A
+ 0b01100000, // "a"
+ 0b10001000, // "b"
+ 0b10101000, // "c"
+ 0b10010000, // "d"
+ 0b01000000, // "e"
+ 0b00101000, // "f"
+ 0b11010000, // "g"
+ 0b00001000, // "h"
+ 0b00100000, // "i"
+ 0b01111000, // "j"
+ 0b10110000, // "k"
+ 0b01001000, // "l"
+ 0b11100000, // "m"
+ 0b10100000, // "n"
+ 0b11110000, // "o"
+ 0b01101000, // "p"
+ 0b11011000, // "q"
+ 0b01010000, // "r"
+ 0b00010000, // "s"
+ 0b11000000, // "t"
+ 0b00110000, // "u"
+ 0b00011000, // "v"
+ 0b01110000, // "w"
+ 0b10011000, // "x"
+ 0b10111000, // "y"
+ 0b11001000 // "z"
};
+void LED_on() {
+ HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET);
+}
+void LED_off() {
+ HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET);
+}
+
// https://en.wikipedia.org/wiki/Morse_code#/media/File:International_Morse_Code.svg
uint32_t morse_unit_ms = 100;
int8_t morse_power = 10;
@@ -341,7 +282,6 @@ void play_morse_word(uint8_t* letters, uint8_t len, bool use_cw) {
}
}
-
/* USER CODE END 0 */
/**
@@ -379,34 +319,47 @@ int main(void)
/* USER CODE BEGIN 2 */
//EE_Status ee_status = EE_OK;
-
- HAL_Delay(1000); // initial start
+ HAL_Delay(6000); // initial start
SetStandbyXOSC();
HAL_Delay(1);
SetPacketTypeLora();
HAL_Delay(1);
- //SetPaLowPower();
- SetPa22dB();
+
+ //SetPaLowPower(); // For powers up to 14 dBm
+ SetPa22dB(); // Uncomment for powers up to 22 dBm
HAL_Delay(1);
SetTxPower(-9);
HAL_Delay(1);
SetPacketTypeFSK();
- SetModulationParamsFSK(2000, 0x09, 0x1E, 3000);
+ SetModulationParamsFSK(2000, 0x09, 0x1E, 2500);
- double center_freq = 446.14375;
+ // Frequency setting in MHz
+ double center_freq = PMR446[13-1] ;//434.700;
+ //double center_freq = 223.010;
+ double freq_correction = 0.99999539941; // Try trimming caps
- SetRfFreq(ComputeRfFreq(center_freq));
+ SetRfFreq(ComputeRfFreq(center_freq * freq_correction));
/* USER CODE END 2 */
/* Infinite loop */
/* USER CODE BEGIN WHILE */
+
+ /*
+ while (1) {
+ // Emulate comspec beacon at 40 mW
+ LED_on();
+ CWBeep(16, 50);
+ LED_off();
+ HAL_Delay(1000);
+ }*/
+
while (1)
{
- HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET);
+ LED_on();
FSKBeep(-9, 500, 200);
HAL_Delay(50);
@@ -415,16 +368,17 @@ int main(void)
HAL_Delay(50);
- FSKBeep(10, 1000, 200);
+ FSKBeep(14, 1000, 200);
HAL_Delay(50);
- HAL_Delay(1000);
- uint8_t callsign[] = "CALLSIGN";
- play_morse_word(callsign, sizeof(callsign)-1, false);
+ //HAL_Delay(1000);
+ //uint8_t callsign[] = "HI";
+ //play_morse_word(callsign, sizeof(callsign)-1, false);
- HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET);
- HAL_Delay(3000);
+ LED_off();
+
+ HAL_Delay(4000);
/* USER CODE END WHILE */
@@ -669,7 +623,113 @@ static void MX_GPIO_Init(void)
}
/* USER CODE BEGIN 4 */
+void SetStandbyXOSC() {
+ uint8_t txbuf[2] = {0x80, 0x01};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+void SetPacketTypeLora() {
+ uint8_t txbuf[2] = {0x8A, 0x01};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+void SetPacketTypeFSK() {
+ uint8_t txbuf[2] = {0x8A, 0x00};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+uint32_t ComputeRfFreq(double frequencyMhz) {
+ return (uint32_t)(frequencyMhz * 1048576L); //2^25/(32e6)
+}
+
+void SetRfFreq(uint32_t rfFreq) {
+ uint8_t txbuf[5] = {0x86, (rfFreq & 0xFF000000) >> 24, (rfFreq & 0x00FF0000) >> 16, (rfFreq & 0x0000FF00) >> 8, rfFreq & 0x000000FF};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+void SetPaLowPower() {
+ // set Pa to 14 dB.
+ uint8_t txbuf[5] = {0x95, 0x02, 0x02, 0x00, 0x01};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+void SetPa22dB() {
+ // set Pa to the highest 22 dBm
+ uint8_t txbuf[5] = {0x95, 0x04, 0x07, 0x00, 0x01};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+void SetTxPower(int8_t powerdBm) {
+ // Between -9 and 22
+ uint8_t txbuf[3] = {0x8E, (uint8_t) powerdBm, 0x02};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+void SetContinuousWave() {
+ uint8_t txbuf[1] = {0xD1};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf, 0);
+}
+
+void SetTxInfinitePreamble() {
+ uint8_t txbuf[1] = {0xD2};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf, 0);
+}
+
+void SetTx(uint32_t timeout) {
+ // Timeout * 15.625 µs
+ uint8_t txbuf[4] = {0x83, (timeout & 0x00FF0000) >> 16, (timeout & 0x0000FF00) >> 8, timeout & 0x000000FF};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+void SetRx(uint32_t timeout) {
+ // Timeout * 15.625 µs
+ // 0x000000 No timeout. Rx Single mode
+ // 0xFFFFFF Rx Continuous mode. The device remains in RX mode until the host sends a command to change the operation mode
+ uint8_t txbuf[4] = {0x82, (timeout & 0x00FF0000) >> 16, (timeout & 0x0000FF00) >> 8, timeout & 0x000000FF};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+void SetModulationParamsLora(const uint8_t params[4]) {
+ uint8_t txbuf[5] = {0x8B, params[0], params[1], params[2], params[3]};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+void SetModulationParamsFSK(uint32_t bitrate, uint8_t pulseshape, uint8_t bandwidth, uint32_t freq_dev) {
+ uint32_t BR = 32 * 32e6 / bitrate;
+ uint32_t fdev = (uint32_t) (freq_dev * 1.048576L); // 2^25/32e6 = 1.048576
+ uint8_t txbuf[9] = {0x8B, (BR & 0x00FF0000) >> 16, (BR & 0x0000FF00) >> 8, BR & 0x000000FF, pulseshape, bandwidth, (fdev & 0x00FF0000) >> 16, (fdev & 0x0000FF00) >> 8, fdev & 0x000000FF};
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+void SetPacketParamsLora(uint16_t preamble_length, bool header_fixed, uint8_t payload_length, bool crc_enabled, bool invert_iq) {
+ uint8_t txbuf[7] = {0x8C, (uint8_t)((preamble_length >> 8) & 0xFF), (uint8_t)(preamble_length & 0xFF),
+ (uint8_t) header_fixed, payload_length, (uint8_t) crc_enabled, (uint8_t) invert_iq};
+
+ HAL_SUBGHZ_ExecSetCmd(&hsubghz, txbuf[0], txbuf+1, sizeof(txbuf)-1);
+}
+
+
+void FSKBeep(int8_t powerdBm, uint32_t toneHz, uint32_t lengthMs) {
+ // assume in standbyXOSC already.
+ HAL_Delay(1);
+ SetTxPower(powerdBm);
+ SetModulationParamsFSK(toneHz*2, 0x09, 0x1E, 2500);
+ HAL_Delay(5);
+ SetTxInfinitePreamble();
+ HAL_Delay(lengthMs);
+ SetStandbyXOSC();
+ HAL_Delay(5);
+}
+
+void CWBeep(int8_t powerdBm, uint32_t lengthMs) {
+ HAL_Delay(1);
+ SetTxPower(powerdBm);
+ HAL_Delay(5);
+ SetContinuousWave();
+ HAL_Delay(lengthMs);
+ SetStandbyXOSC();
+ HAL_Delay(5);
+}
/* USER CODE END 4 */
/**
diff --git a/Firmware/Debug/Core/Src/main.o b/Firmware/Debug/Core/Src/main.o
index dd08cc30aa1486dce6c740cfd9ee9c74769aed13..231a74c0d5e04cc09796f35fca7d225a5602ddfa 100644
GIT binary patch
delta 244754
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%0A4q9t7|RFPQ3ZkMi_XzvRYS
z9}2(jyg@pu^5A*Wn$(lGF$8|ScxR}v>=dH}D2e#j({clU8ERT^v;X=VVmrt4raACDPkbCU7kGMF@?GTZXarj(^S+nC
zGJ*FetuqpN?_WpXWnQ%jmPx$TOCeHut3N{&X}nXfKuhOUfCMLZ5s!Sn40yps1t6(wP+
zc;_kYQqAMiGN*=DwH+Z|=UrL@U@fmG52B8z{}X=ec~i6;Y~VfjGw_YPIRns|c!igM
zYvyV9g1d#6Mn5~#%3DX%a~toqLlEt}aH_cN;C-15M>lw7?y&6S{r3m0Kf8Dx-y(``
zo{>@qJ-k<`^z|n1%`FhUJb%ij_wjO<1K-a}*#PbV-ggQFbBlNA6NEO%`=k_>L%g~1
zARXrIONQkL?~}E#9Oa!#1LqiT37r(*<(;C1<2Wyq5>XSpln3;yDwDjg=_v9Z?+1ET
z-RJ4)@cses+9%K+@+vEUK#P=`~M72p8SP$+~>vLmV(A(e6JT_a-9EQBZBef7gHYL1pgNgXg>Ts
zi$LbfkJ}Bue*EEV^!f9X==pb&-|#nZ0sK#I!fl|P|6K{#g81jhp$7A}P;MoJztRtl
zp?qwwajWq+(RSe!|H>hVaK6LKpo!prK{wE8{*AxDc82dydw{e2SOEZ${B;x1qWDLw
z=!@o0(D_CT--i;|=lEjU)}QC6Q!*r$Z#SfXEsj6m7i^dKjvvBBJpaiq;1l?txkF3j
zFWCXp%Y46u_;x4p-}w-qRx&?}stHs0T@-dIzwJkeH2y8xrKj^#sI2Y^KZz1x8GMEg
zWSRVc6=2EY|Ir7|Z2lsgVa&_nPue$vEth|`7Wh2=F8Z;=t9&NS3HkiV`9NIbXKx2h
z0e^y0Gll%#O=v9Q$NmIBG5=RO*eKz5(%EGx-~Ti`mGOgjqOqJWr57
zkFbirh~7P_=Kq!mt%e`Ww?n!0#7AH1cC9UDU*%
z{2YL0{@zIdTKF#nqOX;|nljIA{81jXcK&n_v<`mTF=#jV`{~B(??jofUjD{t00;OrPeHrI$1w$NF8=D}Kn(G}7XvZOcl#8fjqnfY
z!F`+m3*8QP_^Jq8wY&U-PeF|Hul3*}Oz_{D1z?h|Ndo5s{!bi`J>*}ay!#ZtmE2GB
zZ(>DapEtvwJp#lmzas#x2LxlU;DbFVsG~fFli=wVICK{Lauba%f>)MGAV>g!hoJZe06YcPe}nK6M7qM{n1DG7ljDN>7om9z9=wfl
z+D{0~G?n@YmeZNIuizdXyZZ^g<-vu&U_Sk5!b!ol5Fi2s8!N#UC^%IQnjpc)bc_`&
zu+k|_h~Vf5`a%UZTEc`0KFtT`DZw)OL4md<+R{)BRrfD6w~~6)+F%N
z!$qVZi*}Pyg3M}kMhi|2qA^C`SBAly6Qt7P`@CTP8gEY@zP*T6x|al7J^>(Ju$k(u
z5(GXDuuK%Z^D%Ij1>=-6P7=IHC%(yopT?l22v#X!k}4RW;;%G8-yPu61;S6zcSVp(
ztDFo$KULRd3Z4x>W0t_3Ued@G6nX)dBPgPpj$FY$`(Bvl2|jQE%~iouKO?k!!N+uP
zbxp8kGu#&lo|nP2P_R1^CPjiL0ugVq-~=rPO9XQZ04NpQ`V68>uoP49ymCQjBRo|I
z*5Y5v&8rmPRae|9g0fCpVngq#|R%jOR-JrDydTF8DDmY4C*)~B4CHL9|TOR=4Az1bY#0|kPZI?R*
zMKry33A)q}-GWluy7UNAs2=>Lp!eu}+%dfZ86_hJ8m6_!~^_3f7eYJ}y{CwO|v1OLP$?
z1q-Q2?w(+L1w7mrjJJU0fq?!2x_#b5fh%oWrvwSx!8R@MO~cS;1XX|Gvds!Qoj|%@
z=tGl%qj1v(01pTkQjy(3VZb~9oP_n>(42)0Md))8E_fBw+5a>~%h2H0N6NYuek=F5fJ%xQ!F!d7peg<(&STG22T=>|0n0O0A
zw}ShGFyjz3AK~|D;Pw@^{DeULggdVR?k`+Si=C4~)&#Tw;Q)Ps1BKhCU=k!;^C-xI
zg>QWU5h9Ei!7|h?Oh1MZh6!W35b!DC<0~P;g^5HOAxxwc@@e7kyYbhFp9{bxq3v^U
z#tV194a)?fJ^CObO%#6Q2hz*J32&Gt2~}s|Fj?4`4$>5%APJ_a!b%^AG-3L;5b45?
z8UVN=R33&&hA>+KK&CK(P71PwJ86fSE$pNDEk}r7HN=f0JX?if7YpR41-Cj
z@E&{n!inDZDMRtuZM0jv?`P+jSD;iL2=uN8)D
zgJqp?E3N43h5Z>|X%H670M{t|lHPA<5X_BJ$-=(h4p3N9uf+7fOA+lL3jFyaCb2*M}=Rk0d7qA$rUu-7XEe|{|Is39pN*y
z+`lW_Na2qQ!&-4kCWMEE;b~I%gD<%634f(k@O@$2LI58K|N9V@4}}K0tEPlEXzraB
zR@{S_5&lKHlv!cI9>DjD?wUZZ
zm>v>c{|6V!RaB-$z=uUGH^6p8G`SPpM@5S$<>4keycd1$qQon}d5C`TM)aPdCoZGU
zOLQ|EfMcRy5m-)$7Jr98eMC`uH2R9Xeg})6D2|TL{6&4GXtbXcJu(k80itzhK@%t{
z{TQ(Yi6TCL2o~*L1y3QOwaRHCl8KU3fV3H|v+y}Q=B0Ha|>9a*^T+x~%N}!uMR}?|}#ynBt
zYjAi~bmmo<ekWQ7m2?m{%fdrlW#V5qmvw
zWg=e&M7ijZe*mu%`PBnZEvhR-gf*fzJJnHK7jZ&CS}Sr+fL143mIOq-$VRKP2GM7a
zBA7-|DCHBHM2Dx**DNX)qOnEv?UyiV6*YZ>!L*5Hn&6^cbR!Wg9ip2n0JtHlss^A_
z^aABwxc~$2JpM0(l%I*
zi+=e49wtQpJdX$`MGxcX{<|m2$$@%bw74Fo4@7k>pm`|Dp>N=n=nO4^rbPqi;de%~
zt^(Y%qL1lmx?g;?48l=7_7J!O;w^!=h6lxi>1cEjSJOWEkhqB|CS1k8&Iij;an4l)
z>L!*^F4tYWAc|Iu9^&X~n0ks&#-i0r-0Tk8Z>_5
zcUB_`e{p*c90rPwO)v=(_iTcvVDbO|Y)Odt$zQ-3D*ot6h%j+FAJ-y6e6=4er^OaZ
zET0ie`ryGHB^LC9CR#i{7OgSj=#O!Q;>8~?hiQVCPs2_WFUm&aW$~*LG$x5Vx$u-M
zJ{O0^6tS}gCaK~No3w)mUd
z7-x=Md@2~7xnkD>h&=I~zag%Qm+ym3zPOfBG}px9x6oK1es=@#h2noHaaklzN(8=G
ze3FhBO2qUJ9p{yb^P8ZRiI>nD80BK!Apk1G3+aWiO7W80V5t&Md({ID_%g!f;#c!AVj^mY8Z$HaSfGSHj00s(w`>r*45x{7JqXDxEApSn%P>#
z?sV|hCcZoZPwnDAF96;l9;L&98{(i?06N9%f&u6fhtYDqTm1T)XzUU5?DTE9DHeAC
z-z$ER(vf}Q-SnDmzj!H?mJEm$bRXOjCw&i-L2)=;y&-Wh)rSs?$NZp;h&443qvESX
zHYR?WPCIXlb8U13h}Cooaaa6FJQ~NvA(ikjA%1fa$R@=fIMa^po|ye5TJMY7G9ey_
zvngfxP`vmE5L03%ZFZ)`Yj?rLjCeauAG6}eLm~D{SjR!*C^@+lnv=wG9&l$#J?$G^
zBr+-jJ0#g(3KmyM6CE)emRzOUw<8ie?Wm7Rn*OGjjNK&LXs_iiNu?ij^^myjfaWRT
zoP&**Wbp#{Jtn#51>kYXTn$3=mMG2edqUDnv$T)o7;U5;rM2Pf4O_l@=~3
zNQV|7@t{-b(~|Y{iJXyKPXgeq$e5icov7a=A{<`w{$B-!u*8j~fW
zS%?(L20ABAm3Yt^Bu(-?)l;NPdh(%Nk>LMo;#QMveHJE}lK&{jm?imh2xQrkf9PB{
zM=}S0^KvC7TA$=e4$vz0s$H_3*0%W)w|KB!lUP3kzCiK}<)8~C(oN8cBqu7M6-)l6
zkGVurK(lSBq}mCMWs;-cL6l3rYDN?ll6}K4sg#^o!F`qFJK8x_O9JTlqDC_J0LFV=
zGW`w$t(7=ZTD(qTFIf&*FG-i7vq2Jc7WhU6Se89|qAQxqk>IHzn7d(bp?U
zp%1N3Qf{ZEb-!d2<(md1A5tCDElD_?4Gv14{uWUTNycdrFf93;@*pFU-5cS4RFX#f
zi!sUa1&Hakq>i#FcO<)Me|}dYSqIB;$%2nSHX&Jf8rr19k_F3qk~clkcwf?04fhWu
zoK|)zKc2Hq(;ts5CJHnwxYDJ!9OZf6x=!Lpp7yjESc-
zH4d#_($L!w$E2O~4+@VbIvAe9
zrQ$9CBc$o?KszlhT!d?RM%ud=jc27Uv~P`+K1O#=lynUp5k^a^Xb~PGou%WCb5dtI
zY&tLXr*Gf|>2<2nxG4Q)Apo(`-NYFuO?e5yT#|m>0WDs7jj}NI1nEkuQ%jUKQKI&;
z^raZEB}oG(5OA_oBu2m~()(|MG*x>3JWSH0uYCd1bg2gyjaQ_T&%iQ6`ur@oGo?{a
z0-hx;k3wU%bS>Q~Inv5k(3dNHQ2|_@^hx>%uSz%2$nx#dmne03P1ws5D)h38)
zY1H!o)JO%iPPi_uql|y8bn7fcoizCWUrv$QzodDxN$T+$2HGrDP(?+HRQ)uxR_Ork
zuG*xIw03Hjnkfa|A)WXafE&_vRHWA_-7pHROB&@57v0h&Lg0F&e^W;6ru0D?qUe=w
z^8ibq^b##$`lWx?K@3PQ%>s8zs<7{b9F(fIBGMu0e7au4Qq3iBk4V+d5TnwR4e&cA
zeUwUaZcD$VN}@YbcbaYQO6U9p?r|xXHo6m1<|_0}N(+_1-IIPwr}+1!+o)*bf%Gj(
zfjyLFbD>R1Q~!h8Y3cuR=m|0-ZCik#W~IABq3xHs+(DDjXrIeJrOtlLp99WymVHR?
zU)qyo`Ds8T%l3Q@?iAUw8FZ$~-ZQ{qnye!Sr0FtmS2SkIxKxsmC9|H#n6hPUbD`zP
zHqpi}SJq*G$dlDmdHGctkBXi0Wo6UwdrelPgNFjylnGj)>_un9R3zij_N3S@J9rI#
zOJsjN3AR$1%WeS6WFPGUqFl!Ff>t4u{f53uS&0jPRk9s)oLwzj?*&gavQKChxGvjF
z#S68v_#F^+vH%+Z^)ekLFdAe#;^3)K_VWKQq$Zhi1f0#XsZZdxMP^@0IjL6J?g^-E
zvQ4Exw9D2BpmoT?HQ>G>%cY-f?UZFuBE3tt@*+&SW%ni!VUKJFO~^N8IyxWfm5rZ4
zXnnFuN~HJ8{+LEE1G2TRgY1?poz~fdvTPfo7?Q1g3EHsi9XlOAj>yX1g&37xISTxk
zES&NYw`FBD2)pl&zrS$9uAKK5%$nw($lcd?1tG
zhu?>?i5PHB$$oztjnlG?^sfGltjr8;R`$&w=-V&9;%A5ID1V98J_qFgqb12f`Mo2E
z!b!gFFf?cR*C`0bMZU`i4iCv=>2*w3`BExqIxK&aDu0j2*Bl4@sQkT^uym8B(0kMF
z^8Y9b4|&pk;5_9o(t*2|++GjrV{#XIxEz=NR6r-@-tzT@@N`1%sm2I>nqpO
zI^Rzo{}@dD!6Zoj$UEo@mjC`E9EQpF(LhhhBSv8v
zF8882EJALg{oiT1hUV-u@&=kF&&sWsy7A_h{DU|+jFSJb3ixQbh}K6j@{gYf@SJ>h
z3kG^#?)N23F38u@Y5Ya`J`Y^=SotP;D8|W8(c$(bc{>Z2G+wTxH;=*yFL(8}VfeEo~)%a@PF19wgS%d_xQAdjVj
zib8pn6x2oXN9lyISbpYhjI+cpA9?{arSj0%(OM>d2k=G+1q38BZ
z`2b}~d*vlMnDoj2GGe^_aupri4aj%iMQFF=h28)R%A4Ot-;n&tF2pn}fA~G%Bl6AP
zqiGS&dc~#dA-?(;>xYuc6OXF&GHa!;0T&cXULtn@X6DDrUl9
z;-;wUgz!}SdIrKvQBJ$pV~Xx=AUm$er<{Se;`c~|c0zIFQ;fw&(Q*pHSMgK{9Qi4n
zf2Q*Xf5ng)E>0>Qr^H-tA{EOu@DQc=m0n?rR($XVz4;uY
zxKs)JImLRq|IRBur6tq_MeBKJ7Zu+u0Wena6&(o2DL(rc+9k!CMd*uHxY5ybg5uIL
zuq7&{DCK`y(M5N9lAXWVbn}fz2#Y1}0Ay*+>h4JPoUi%DJ_NwBM6$mt6F+2d$Yl`+q
zU|FPijuH{Y3ic4R62&fmkd-Q$Xtz+NSV0-Ua)p@!tx(u$Ca$zAwhcj6DZX+CqFV9!
z8X#&E-kad!y5c!HcBxe~Y=c&(_*;!A>J>k(f{O;lt>@6!sQADK7r04rpOys83WrNz
zX;JVfz0j(-F9CI%;>U29v@5#)gx?OuOWBC`h9dn-m~<-aTSgF6mqI=P7u|}>9cb-Q
z6y$;Xrs4wq@0(slC7qx5DGDgT+^>k51Ykh%Q4_>1#YOti1{JHQgm6f)mwpLmSmBuq
zzaxtI40sw<-en+>y#ZDZdt_EcOCh
zv@*;J5u;>nL1^ccA5co`yz+MoEH5bkco~)#mHQenv{+>)RTRZ3kF-O(r0jnK)bYxd
z|AS?Maub!fBq~FF0l2J;J4X4JB<16;z%*I;KQ2sDlrPY=OjU{&fhJ8kYlKKwK6n&;
zSCkbdXchR9YfrTHdDsc?X&T%~&;Sn`zY95}qHWY8>~uT0N@
zNug5FkG>-1pA4|riO~-D38$_xs^)aUlC}P
z(%lJt)ygb-zqdx|O{s(H%73VApjP?H%do6dJ~M{CdSyE$mK&7e??7u*%J-qKN%?a<
z2GOiEbfd4uu6%@wep{6v5~58h_zI$3neL5%JCt|$FukGtvJJpaWe3$MbSW=U_P
zZU~k=%GW{=(@o_)`j~r_!fKH9DU<1W(69Vs6o3KcGFqA6QqG~J$e=RpHpqsQmHlWO
zR@yI7c4I_&*dLvv%9}nAW6B@-7|d5WDKUG6Igum(y`lZ;DszVjHPywpAZfJq3d$bP=QgwHuF<4bZtCbMdqjWoks&>0PizsX`wG
zO|;7RGic7Mex(J<1(k9mTwGMeeFU0V)xa?DajKs;z{Mri$8G?`tG;r8mY|Z;F2tcx``z%;eR9{dcFje(JC)}s0K9bX$&*`dCs+PZ^;{F1M8LCoB
zS!SwwcO!}{74u)X$W~qb8NeLXFT3C=SLJsECV8r7sovnKDm5A=`KldHqVbx_)(5RX
zB`82&q3Q(zSc+5zdf*nTVrVH}qN;X*R;v2rbpY&Ts)kq~%2juDh@wK}xEGz3sy)xb
zVU?(Ljv~Ja-M%eVIS}93+
zQ}q(_mVF%9uh<#H0ZDODYPEvHoyIzydNEq@=LW>tG>F}z>B$ODaz>J=2s0d)}_
z10Gc8Q6avQdTt6dXZ1_=XMlH6uRV{}L+S+D)4Hn5A^|+Cj?YHp5%ud8FgdE0o`GLC
zHIMd6?&<~p5MJtm=h1jf{nSR_j;r4b$5r!I$CGwKeVo=HKI)%nU*fAiMTanc>gPMq
z=dZqb3hqy;os#JO3s7%(3;_qKFHjOINWI_;+y|=%W`GD$tCztfRDH4p!Gx(3g|IxO
z-jV?K;p!>cenzOhX}UVCzTF1g8TBKb=sT<4{uo50`qV?1M5(8L2X(YMi<0{>Y8N_E
zIj8>Flk%VE)vwZi?1FmVQ!u@#Ruw>tRrk{`{=}(E7Gs2$)VFBTj#s}yN$&);awkNh
z`soIcURE2a)GJAS`3;CVQ)YFQXALaF+*MG$4`KaZlXTwQn-eHChX3OFm(5+3@h)TyJ0*Iun&
zLuvgQwFeib*VQiTU|Oqwy%MH%>N#iNqF!A|g}Dvt5=tgDs;B8`+NAz$C$wg@@=LI_
zs5jF?qE&ryIihb<-+TY#4`>{n0GZg4=Y7=XB?zFiHPLAB>Qa51Ewq7=`tdci?N
zF``~Z=YON>@7y59)IZXK=B~PSJ;b=$-~il&nn9V}N%hh?hd=$lc$Pg#{&HD8Yi_iN&q@aw4IDA0I7bB`YM2Q{xR1;9z;
zD8Z1NHFx`Q)m$`7--kG)>AVD-t0t9FtA{mSROog@!?0&T9@V_|0Xp3@wT|%QuIZvX
z&O_6&AB~t@$n!+6m2uW{~=5e*6k>U(JPg5xt-0
z4jl^mYuYFia8k1*41EEbo>*vsnu$69f;1bJQ!P=j<`^B1g=oI-#$ZAJ$eUE@9Q?vX9G-he8
zje|Q|<4OsI98D`7JmhL_(t#o94hh`TKCiWYeyN`mjThmL=qaIByC9!U5jI=H4)l|`o@qL;zRQ=ko
zSxX6p0nOSBG~Uug=fiSP<3y)EBbwi_n4WiA6Rkkw9Zet|{!C~NN)Xz8%~&X?A87Va
z=J26rn&yNljsG9OP1`kY^xU1%)FuJwsQsR{83(j6Kf>mq_P-Yqg_Bmg5{=Hj%L$vi0G=^&b
zN&qfQ8#@BPDeb1~FbUVXtwUdg_Bnd*@2qwMox??I8TE)aMjQMCEYE3Uze6zRwaX|M
zd_fy)Ux=Yy)Q(e*CRTfHE<~Kx>1%Lb(*EuVEne$?2qHnd!3L3}eQ_&9vi7wWcuLW}
zOt@67p$}|n+E?io&(JsX>}_2&DO@;g-MQfhKdMswMQwnnx~!Q+hKZD
zn@`WUeC;qzLf5pdnJ_KTW{qLIh1$kF7)6mb*#%mu_9v?9tk7<_2$M?fgCO)(Y0b}o
zty-&p4e%Om(VOVIu6^-10JYlP0*D4}4rQO3wJ%eayG48LQGA_SwecU)Ke=er&TU2K
z4ec?yvfWxs4-h@t#UAiAjFh*167_(YoGAI=x4OPbS~_uTl^Z`e@?osEueAMZ3suJ
zi*AOd!b3VQH3oA;_dlv4aMvBB8{R`#LyI0y-CVlWj_VjyF6*QFl&brEbv_Fbg`X}p
z5-k3@`H#XfP`7CYB1HGeI>1A9|51rdm@bH_N>1s%q>Q8ew5}roK}G7)ieMV0`)(Q7
zqIKQ0%!$!Gq_U6;I^`s|lXQGag(d4csm3!!H%R{nJypkg1-LZb%f~>Pt}8czG(%VF
zipES`!0%wm(mmyXcyn}HilF7{24g^$r)$^`vV6NPlpeU(bPOs7EzmtIgjS?;KM&Jl
zofj2pmgqWZzA4i^q6e^CXQb_Ng|3g-Ds^eJm#)%fn;~j+MO379U6)Std99A$fan`^
zYuw?fQ8#)EeNDPo{zYSp?nn(-T6Oj*%EPqjKJ>s9YS*235)M0bpE4nC=$=l7O_y%8
z23oi7-BUK5*H>5jL0h3{!X(M$<_Xn+w$93EPe{ZR)O-ARW&aDNc_jSJyg6)BB
zZX>uK>X!9_ZCW=^4cv^5cNr$Ly0>3Pqockz3ML2iD|RE$gL((r9Xad6S3|hy_vXXo
zklyDAG*|uWd%$^E|68*irbqO9=%3iT>An8Nhv%-}R02{Dy?Z3YG5to$h91|msE*TH
zub}#h6MCm|^!ex)6=Q_H`lo+^iJx9cRe%2aTFUvI)W1#{qCowhl*|dzZ~qzYgY`dA
zCM`t&S{HDk`mem{{2@$V>H#%eKQ#;yq3@&*{j`3nACX4tlPJ#|rH^)ni)g(EJ-1`@
z3n=$?P9INiPo39`MX3^cV@Fo2SW$EJe^|aYf)DP@}
zxU9FnN%_wt{VFx~mm#?3mi@t06i%)>8Kp#eL1r_NN-@uTH^&ZRNzC^#AHif17kYCYQra!U?
zaC^C4b{YX!>baC3sM2qx6VhsZ2`yu<>wQweR;&Mh1rT+5{x%>Q^iLm#Nu&PDb~HBW
z|3^9Z7X5yjeOmR^^u}wOehodE+x1835C&4qPq2q7ooAouIIiA
zc~hS)!kBvX{Oj=Br+24A-vRv_M<8zLKOBS@)bDr?en<3Eo}d}k?+Jj5F?|NTa&TL}
zV==@X{i^?g?5_SlSA;#T*HPi;gx)y@fJy!80Em0~J@LTZ*Za|a^MT&}6jkF)=`+({
zI<0@y4w@OgrWpAB22mjz9Sx`HA#uQvWyjE*4ZM{waWUMdA8|iqaH877!-nZWjOmEs
z6FsBwK#|;~3U*c_e$373h6NZ!f(CTC8rzEAX
zVcUGT@H1HHQR#088b#kp!}|&Z6JRI`fe19bKn1};hWBXy7i_3b0wBcDOxGgRuwyj<
zVTR2-^qn$rUPOf92EGf(A`IV6Ks#+H5CVS2ApV!ed)5$6m0yvDsVcNa8Eo`ei8fq&
z5;QS}`DrjYXGpsMw)2KY`XXL1y!HVGbJ1YTLol(14Hh)U8S?1h?vmkhFI>bMA}KAH
zVAysM@I*r??Y=X%(L&SV&1%?fjR4FvP
z`xT-uGMsw{EX9W9bR<(^xbPO8zn2=mrBzm$;RGd&$_;sOxKI@aCGA}*4O7jasWOOZ
z6xD|6-H5Qp@aT5*T{namL)01sx4>Ozc!!Q5>J4u+LTfO*YXM86p^f&*O@>bT2%8Om
zDxtL)*ss8()xe;C2w`tC9QKF%c0<1g+#QC(`vBfBtn-3tr=gcprCkQEVQ_aFax5_E
zF`U>9{7u7WPebc9Ts5Gt&v1-(^!*0bivSE5tS{pl-ZD7943}5&)(Qn<+0aZFp-XJk1!`l$f41yhL}*e&c1@RXG~{X#;h@Xt{^RgT@i^
z;AFHLcY(&)$Zm(~Vw^)|q=$_64#URPc%9Bd4;$B02JwhdOq=hc#w4owa5KKY8vu9X
zddj1C7@I#tpQrJWd+75rHqqYlm~q*cU^#9)Fbzv@<4ZIno-pn{0Wu$>a4sVBHJ-IU
z0UJN#cn&=I8~-yvJ84un0v}-9j{Ly9K;yG?!v`5t=~otljX!W<5@KY%i@s3fVmeR`
zGhWGp$tfd$54cYohxWtrjIopsjm{b!2QlnO;|uhFk1_`S4P3Nw;wRu@jK5x>`|q4l
zPziC~c%Eu&E*LM?0eI0UI0Twlqv#y^;*54GU%g~}pUT$bjm`8lO)&mKDT_qo*NqUD
zjde9}pJdcfUOm|u@;S5=qZ=J-4Haj&aQj_{}xW{Re${#>I4sdDWOn%kF$*8%;vjjJjVDc7gFG6;~G;
zSJP6W$hheX#8hm&TaV~Vj72E5%kPNjey#_$EuZWwnw26(4&H7$GXUB)T;3UwQGl-B4m`b?tprg72#
zryPxjXW^pHSV=p#eq%l@cn6FUdVA!S(VdDN2aWN^;C{%sfnGouHnw{~j2L&*S9a9c
zBuC$v@hkd5+%|sJ4wgH{YZ~-T82_W|J83tT(%1T)v6L1z_l8gT@hqlvW*;(&>}AAp0VHadcGGF|%_E}Tts
zC~@LqV$Oi`kg2#FjjpEo>tT7=WS_Gg>Jd|d9Gyo^u{8U*nV4m8=x(}BX#x+ExC@%6
zY5x)Qd6~{pV(gg7^fgG2o92YV#M_ik*V)(f_+N;^&$NUR82+X>0jL8_yJ!;}WD5Ng
zjlm|+X&A?e5V0m5l~Ko;*3(im!F1wvgqCRf^#Uv}o8I(>
zmTCHpPRFuL>xS(h%{IMDA8d~4B`@G}P1S24@=Sj30CCl{;vmM9Z?ehwtRhh=R5mU8^9fbkb
zn0DW$^S|pR&pg=Fntq|TPU=kAWK(Yvy$ZGl(<@XI+GzUrAGl~TeNXA17Lx~U3R_JT
zild`3(WkX*%&C8oNy8Zm{e&eNIOzJ*Kyg!oy9|+|Bg-
z>ouA5FzqwNdV#y&)VUOh0n?3mm=2mATLUp+#&N2tyGVg
zT?f&3)LcOS&&kc~WPpjMIiVIVyv%7-VROvvNO#%^^K;z*_?S<-0q$!z_h!H*z??&c
z27%^9_%+OVLFTK=VH0e|zdOWaZ+@5ZW2ekBw9ySW|4NCM2=mXBqdaZSqc>X4m>(2C
zM49two{Kgwrh~f}^8{6+oij&KO6k0La};8_V3u~lVD1|q?H
zCmb#k&7R+&^RoF~J`hP}3GJ6t&Hp?G%QUkWm42j~KRk)6e#Kl%>*WmdTmt}^=7INd
zxpK_UE{933xq}W2^UQCc%y8Z{bBYyOf!XnEuoRjds06sgJpBLl*QI8q2mF?qSJGa(
z(mb*U+*RhHW6-M2wVxx3T65!>`M|ZCBdGSN!~AXr+}|)~n4xu=pZE?@beX%yX=#1a+(-|ZUh}vNG<{}Yx&ivl
z#gi}{Fh5T9^@HZLENDY!Zz^IKHpfZ<7%`7=AV$qM>7;SY+!FxHJLcL}!0(y^l?Z0s
zd}RcH3G)Q)L?+E5D)P8z4*m$@zBzR(oj*J<7t)U6p*emCV#>UF1AsH;;QzoqYYwAq
z`F>0Ac?d^K8XXEAu#ES@@}Q;WB50f}Us96L*^*87fs1A97l`7JtFrRFMJoUw$6fH-S;pR#q4mYS{5qAcGn0e7@zHEl>@EMMk<
z?VRPxHVFJLII0=GVA(_8?u(WWd5AaGG9dsw&hjJuO2Q?}v3y*FcuRN$M1sXR8;%k!
zzkLIdY;ku*yeW3ekI6u!TG-#iQ<^22wwURby+^@)#nMiDj||I}&%m8&`RX)Cvn;LW
zV3}=^e+zt$<)cvqlWW;Y>C8M!W)@7YT5`Mr$hYw6v3XXU}>Y3L80Z&U+62c
z++Pc=*kbQL44M+l+Gzw;YVoIuxy{?5f5sh`0*Qr9T-ZDf_mj=rhR1MQ;`IrH}O_tanK-O&8DFvX#@=7T
zS@MEFddsp+0G2_^>4y+QmJ)ZkAGTzCjhIF(_Hk&V7PS=Gn5Bi5y|*nHll1(%V|ke-
z*1MLk>GmJDyuA&L6PDF4fcw6MMY+lcmj1_}J+u^Mf@aDR_dW2_7VAZb8H<4uMYEO#
z&IoP4b
z4sh>l^*(|@oV5PbfxZCixAYcbpmkR)`hu(}bmARsZ8=Nt|Akm%E+ME;>uX$uA7=eJ
z0i>s_Pg0qFxHW~2k|M18MBqMcZJ}ku8EYv$ThCe_qhq2-t6&JEQP$T|0FSmNIl^y@
zwbmD$=d868@O0k#JuT8MSl4_7?V{C-&KqN`U($=<_Bbp4g*fgG>x;(#OtfyLIpwld
z+X^konwbZ`$yUQhK%`iAl)y68`szXWO|$wNfls&Ir5i8PdT2XbWLaaMg=Mxig#&nw
zHH=bsxz>+q&d#&el>%_ps-l}Y-@3&G;+ow$yag@_tcINc7FxOFu*kZQPV-;fj<<>pN0jRK^rJO;vb?2XOQDc4T7c^eC?)?bd_11-9h^fK4
zJqRX^)|_NCHd%{lUDIs!CCe78{r47-wp!=Wy0^`GluokRt&_CO>9C%94#C{8GS4E4
zPV3K~0nuYk34wOg`uE$w^;+*fgh`(@pUPnRt!gT59k6D4K-{w4UJv(!)+Myl9I~Eq
z0rjvo?LSzKSYtOMicxE%eJ^P4SbvtI^R6}OFNksLW0W+XuwINoOp{jiTX1pDIwuHz
z?^{1-K|HXIT>ttKR
zLNLy@)3gI}v334x2jY#%~n-3*E!)#u=;pvo(
zN#E|%wm@&Now4nu4f0u=QwYc+Z5bzF8D-;bhWlt+dLH^>Y`f^3<(w@t9gXL0vnOf&
z8EY$`3{{+M6>T0a*)pC3X}qn_4x0qq8rnT4+Ww^T`^&Zu7T|77vTdRN0-0?4k#55j
z+agM=rP^x#06fjMIRWr=+fK?kT(OPP4Ul1L%7SI4E!G((S+<~iXw0^~rh{hBvrYIy
zy=uF27r=bm3{4n?HfJw17TE%=(28xt&WO9j_AEV&OKn>pKr6Eqm*XOo+q^!7`wCk&
zRRmVruKWbQRkkngp|9HZ3{^7K*q*2SXPvD|2$OnSga&{HTMkvFG}>*Ww7+Pwz3&5H
zvrXRyn-&|NR)wv$6O^26vx%Kx+HTuRE4U7u^)yIt*xH|lWw-7BIJ)wHn({BMp44l5
zd5vL)*^On!%<%SoUt=)F3}Z0HY<_0U7_*P%sb~{vUujWENsA=yn}j5Z5)s;yQV~i0
zK4<=Mobx@~_r80--}61^+*`_FSZZIC;SSKTsGIJR&P54!09}i&%fQmTXdZ=gJ&RUR
zCcJl1Efta2x@Jxaj-2P};vJ<`M)47L`%H_|YOSTEqqyz1#%dLyKlp
zVtRN{2X&Y~Uc?K5hffy`F(B}4k<~hY(M7*eXZrI+qYV%rTjWdu?~6qTmO*ZOQJ6Kn
zm{|0WGvs!2`nxga&Iz_`fC&%ImY*@`$zkdM_Hgc1gJ&mn
zONXPr93R?@{WuF=g57~~?&tjV1I7+;$|*q=z{#kAvV)ur9C#7PnGph(
zAdZPzD1tdRR#N{<2!|(!?oiGbl!1@nFlhgaVK)6`3FHw<5W|c?l`Bd97@wUY;=d&oZuwZLQMwewfCSVlM|{2XBMZQ-h<8N
z{B{d7Jjwaa2Urd#omy2+bEZ*QI*&6e0b^%4@~O~S$XQ4ym?F-4w(Z#RjL_Y<%%$d3xoOPTM6}-5@5q<)L^_-unZqdMb_!R`Mar#m~v|Q(e
z<$$M=<3dg~aq_Go*vv6g4*Mo&3-vDE;)GDXw}rEFF$~`3T)PMPR?g@$V0SrI5{Td9
z#L}y4_c_Isf@|Zr&xaQsoN5t3C+C~5psb5CMCbEvjt50KJ)94J0rtSc8Tl`N!+HNz
zP#Z{oKtCqOF6-Lg`S_?+!OSb1b42byBL%4;O^l8-OGJM
zOOqFu{Q)GrxeMsn>%%?u3Y7YCYd(gcA6GITWBa%sm6)$TcP=%)?B_ObgTVlLziqqqmA
z!0%{o<6ID9xE89aAL70`0%9zecN|z8*QF0wJXb#xY7)4IDNsJbttx>tN!;&01D4EP
z9tW1A+%gW#ALBOnVl0*0X9JMNed8FsNat#2TflmP>-;)A&EQ(M0L$V&pMYRC_d6rZ
zpXBzvjjJe%5c>#ab0FWX)QPMRS++8*>q&8<4WoAt>?~I1aOu6)&z(R
zT=@hzuW@?=0IqY@H2X&G#eI|T{55euqBGMCZuUHwXy(@9+-!4`JC~xYTU?C?EVXcr
z;SjvdwNHSyJKP~E)wObaCqkk^d)#z-9PV=uQ{J_Wt9TP*?cAlC06Mt)lc1%O
ztE0qA7k9iAQ|ji9wt&;p!)>RXwwK#X=b8uHUumJ~=f<`I3~)bKf{Xu%d;SE#AUBJu
zO+(y=sZcu1eSaBP9&_t=LFourM(4Mu-18T~@{F5F2@p@-U=MV9@vLG&^yX#L`sl+8
z`W2J#<>{_rf_@g>x%*(<$NRV$RDWK)7+^ooc0IrW9+#>p0lc{!upH!-y$=w``-tAm
z3gWr@0}JNOdL1kwylk3UDDUEOSPJ8@Il#hscWR*}f|uNbD;mk$Yl1)&Z`NY4MDyzE
zAQ!{47~g}7hj{lXh(FAGoiYKjyn(4;jpJ>iv_w2FpIRpqczb^b=Mi4}nU}Ze_A_$c8wx)yg0`C+hb1w4cE{EM3UH}!zF7Y-;(D|>H
zx1k=amw9P>AYaFu5dsrec&c-_7WKUM&cXaup8Em_Ht-U<+K&3O#?VyjCi4
z+~w(KLH-^ujM6FhdEb8ypW1lV-$TBgmnR44;5ksx)X7`;3$QMpoE+`uB~baJhvz{J
zYrQ-_3T7YhBI)t%<87lG;vp}D$_V|uH^)F6;8lJJ&PTlM|JvdC8{~B#1@$qHN!7I{
zy#BRd9pQyG06gV=(FOTuyt91oD;ks
zoiVnXZ`4D;oqvnMIS+pFd=NePwu7W@=G{Kj8_
z`SPc{56q9hl(x}*{4eNK=FeY25$Aq>4<+dj@I#hhEP$_W2RO*zHX8zg{0CZC3gW-;
z2Qip$^E$i;;dfE%M<_pQCd9+|uhL5#;rwN^)<;62>%Y9a+3KOR8=_2|H~6t3f~2pEt_Nf
z`YkY+%8#VDCXMgk0@cU)A5-!;ou5fHwiA5IMk%Nn{D05ja%b|tqQ^LkKcDIs+5Fjb
z_BhGc|APya!*BTsoTvD2QkpE6|LruGIL&`TAdeqFNw+in-*Ui`&)-PfX92&OI#dh!
z32882#J8sxON#lv^fQ(4ms7^Flpk){477|tK*xo0{-(Q-sNk~-0V?@-OE7kpzl<6U
zs`)8zL+N>b=!XCo_%lvp>>@vx4h=PYTN8+v_$ic)spG#(W!@|Nfy*m*d3t|u7^E1l7^zw(UgY^Obz3<^vAAiLlv_0ep_2Z}L=U;CGae$w+7|uN6
z@9P5RAfGb?yyD8o-|MU#)}NqkOAe
z5TEluSO_r2UxlaGV)KGOO9S2GeAx}Cnc%-cJubTiued{vyTGLjn1{fcR%=gzJ7r<_
z2;Mr6vAu$Y(NO9oP>#c2Z$WxGSbPMWN$|o~;7hxbpP&;*Oq+dzB0Aan3mk7lV83A0
z3~)eTo(3(J072_E*gYtyS_W#MV4*#n2@<^Z1&G0dA|*hGU;&-~LIq#E1rR2i4e3=sw7gNs)cxzV9N&>ixvp!CDj7uJ}PMY7+8wnF>S`j1P_>)Z>r$y
zzo0EmP#XjD#|42@8%!4@QC==naIOYgvIKTiF~}BNrSRyK;IP5jM
zs>##{9#SLMWkEQVPwE88^fk3Bf@*3EtQUC9go&$ye|XT{Ah@#&ERBNC{(@^w0=M%3
zHw0UPFxD)HT?24au*x1YyCtZgy{$zs*az|30&jnSJAz-owLrdAuxdB1*ImKdDflVw
z36ki9d|%Mj3vF!zLo3v@3)b(#SchQRBnWg0w)9}EOHledK(}B^JH&egyd1Ff3fw3-
zd>|N#0cW2;MbXYfL97!D_6t6)#pN0hWWNr9M}m*vqW+gbffL2sLxPz1AwMkm=u=C{}Iq1E@uOCqVnU_#e4R5@K+Vhb25!%zsP`<)%$R|JH
z%>@|SC;Ww)GyR1fR8QM4yyFQI2ZYmmKnxI0bq6>oRNFy3P`LbcSPBv@rM~=N;qp!3
z3=zH)fw53w0rd%m35C?P7cNX+4!124!tVL76e+ZN3{Rtk`{{cD(ZWxH0AhrVuR-@A
zVH1@KJmMB0<(T~1hpRJ{X68=aP-CSWjg-)l16C|D|kz4?$^_@W+o~_ndIr
zE0C`iMrXnO^TO3d5WgVIr(@Mc;mb^b8ev`)lwA^@*a=W8bfDGtvhWw$z3YS*sfKe!
z_$_@Gwq6)zIR)xfp;sF~gD`_)r)$EqjqvTdaQlZKHVTDwoNE%kN$&{V5IQdcOS5nq
z?KL-rKT;#fEg|n+C~Xn8QP_Q3_;)<8JHkLOh_?!Z-+=dbg%#J}#XaHGKfrQd*mnb<
zP3V$MXODK_)_eGUJB04BkmwYyqNTJ;m`|OEy~0PYVeEl$T@OH?@N_aR13H!jCA)@Ko4pN6+6g
z;dUvgW5UN2cE1o7(Y`${bo2q35MH8ZWw(gG1G8`!O?wqn^ANS41kqE}M(=s;5e;O)
znZ2T4s2$8p^Z{*E-lD{H(CH&OeGgiEMN@?k@Du&74&wVn>kXKMzvvZYEG;(sMMLwz
zb3hdB2M{3gpiizG6z#Br-+>|pMc+Z9*Xi~M7FANL7a~fcglVXVa~F2QMAq>z7%qDG
zPhb(E+Hr73ijLD$5hWU?0(P`$1)VlxMAs+7r$ZtW_0=C1@veZy5-U1Q2jw_XH(m93
zQEm=QB#17{zL^E9AOsD9?ZE*I8
zR#OnrD=OTCALfDRJL===6RqBEf&4?!_A*SnU-Ubjg$G1GQ3uH*QJ4?p2Svvzr8Oj4
z(+=~)BGs1=cr4mR8~qbevJ0>gQL7uS#Z%D$^;JC+@!h~VDmtG9gU?0#4uUu)+WR_K
zUWitn12!&NIsgyd#phTQe|m`5C?Me}{)@t^J>q1#_4bNgb^&;a6}0bqi(jmQHXrdF
z+WmdSwm)IaPdu4=TK9=-rbD;Cc$+uG_ltwJgLpvPLRf&HWS0Hgn+*}Bj!{RM}KrmMP
z%oWo*ZXDtAhC%#ArNEIMB)?&yVys>~eI~H0VpqzkHi&I0TYXLZs~%XBcn7@-c0+7gIStfi
z@z+{_n__RO9p4gvLGgBr_+M)6xh?*YV$3_@XRkt{Rm`Kl;JaeM?;ze2r_#E7UmQ}3
zNwkTV(SfmDyq*n~4skw}$~(pNgHYBb_M!wxxA^YM@To_9gLai(ajE4ns1L;B)?Fci>vct;;~rg2<(aYJ?beK
z5x=($TAqpv{|51yxUwArqvF4*^W?dB_(y;-@sUzkcp?7sZ_0m;i^o0&bwYfFqB{?X
z)g2H$CCkh(zeh4K71&n+KkgN2X8Nc)hlq>Kr>ev&ytu+)KeWTKvGeIv4fI#=|mkUshdXoUywu;0{LJ`Ob})mBC#Q*p^^j_
zfG|ni9SDX?wo-Fhgv9;^h>?=)U!XKfVn?@Ev?N^ur7@DLw6YzNq*BOsSn_@jbjC`q
z?u5=b$pEEM;w24qOh}Lv%mQ{q;=!f(Gf{Gy{7#bWsR2lqJWs(-c}%i+0YIu`pdIGZ
zB$1RDJ0bC617t{cQkPVwWcI57Cne$3D3BxJQ=7yo$w)NJ=Sikgs^pC1F;$uKC9Q{{
zx=7L~gm|&!3#tK?NPbI!oTXG!`(I92a+WS|xn%vD;Hi+rHpBf&iS7)rvy%VWLwA+r
z-MwHrCke@eV6~)!R;Kfk!>Mref@FlY*o%@P${^H8I;hBfNn#LTtX8sydY3LsW+LBf
zQzvma3G9mGMKZ?fEs`A~xOi1k_yS5BBoeBsUz6;k8pCx-6r~OuB^T%gpeD)Q6pY=F
z2r?nqEZOoYh&Lsp)OK)7a)Y{VTO^aBfVE04F97FVNpl~(zb9$71M$8j{vCieNfwK`gRNEa!|^q28BRrXCXWcl8WC2F<9F38J+(^
zq*rOx43%!&1;H?B2({aWOUJ3E5+Pk%gRw}d@+bHmB^^HvrP0zgv@pg@X_o!Sj8aZ(j!f#RhnX2Saf>E{&a9+9rw1Y)8zj+Tw1(ik1Rf0QC!7y;@r
z=@(RKOqH5w8%>jHCd0&W=~k-9rb|yyIpBo!yMKXSNCK%LqVvW;6I9x0nkHN_~|Z7Kyt%a(b-
zLX7N1OWB2pPgais_gme7`rZG#=~x-tQto(n2uqy
zvc-2{@2+gLmqLhpvYa6dw#%4Qo9mF>rCYUAHX{|D_Q?Dxsn{#aq|M=h>;a`C`ekN1
z;|$1*4d8qvtD+xrSay`sa*t(4_+WV=`+EV*Ka=Sn0*uP0Q=`js*$+)%8JC?4h1`V9
z_6&vayX9A9Kt1KVD8;!)K7#@Iy>j^lIO8K{{Dc|$%6&}m!cYD&9cA~+jns>JKrS1A
zK!AK3HJk*=`{^5*!SZWlK16=!B3Q!Z3Tpa^kpJcl@kqJjYK+Cm)s)~lB>xHp8MN@p
zKWv0xyj)oio&>oYnLi>grvy`)JmY&fd|d7u2bOfX{aQ@>g#5T4bZ5w8t-+EhKi3a%
zQoisdfE>9l7(ShnZ>P@TT=~2gz)s73C@#p8fA}-7Gx8=1Qu5_9X{WIi$XjVoEtI$3
zgry?+3|febpO+t{67>c7R%;M1$(^Yas8-&{hWX1Dd7=$qoqQH;@K@w>y`ZLE
zu0IBYSLGX25Nwd^{9xjmd;`@Puglj_#MLNYPiKZE`O~j~wa9&E0o;~XQ}XqWypLAb
zHhI!0%(u%`6t;HATZF)R8)MJqZIqfBldI1`{Du7MMsSYHe+h#Z6LQsN5O*t5e}GPR
zh1>&{JQTmvL+PzpO8F8W#XhP=`zlsi+5itIW>C5|K%t=a&4Y@WRC5Yd_yv;w&Z7Dim9J5U5f(QU2nbV$VhBu2xjYpzOS28vWg`3yNd^m7Elb
zB5>9yzRAPbB}KfF{)9%YB4Zc4xU9%4fP9@|qa3=gD1M^13+*c$zL%dBf8UfeZ6@|Mn)}v@~2iB`7`4nRh6a%!(^(!V(BgKH?
zH99puQuLvqgA%GDD;g$-6xpA`?y$mY733c)a+nZ&qNt-H)rjI~0R%@CX;;AcT=4n#GD`!ceB|`c39DqpWC90N0S(IOV
z2*GG&GBp{;D95=FJfwWI7!rq-SqU%^tK@IMWa5+_6m-NZ|D>8xg7Ok2?vE&)y)l-k
zOpbzhlCqc*!^z5MIzJs%vNiBGMY&-N*fC`i