feat: add Nano MCU temperature telemetry

Author: Anton778

.github/workflows/altair-v5-ui-check.yml

@@ -48,10 +48,13 @@ jobs:
           const app = fs.readFileSync('js/app.js', 'utf8');
           if (!app.includes('version: "0.8.0"')) throw new Error('app.js must identify v0.8.0');
           if (app.includes('applyV6BrandingAndRadioProfile')) throw new Error('Legacy v6 runtime override is still present');
+          if (!app.includes('"VOLT", "TEMP", "MODE"')) throw new Error('MCU temperature must follow battery voltage in UI telemetry order');
 
           const index = fs.readFileSync('index.html', 'utf8');
           if (!index.includes('<script src="js/v8.js"></script>')) throw new Error('v8.js is not connected in index.html');
           if (!index.includes('<script src="js/v8-final.js"></script>')) throw new Error('v8-final.js is not connected in index.html');
+          if (!index.includes('Температура бортового компьютера')) throw new Error('MCU temperature card is missing');
+          if (!index.includes('Команды, передаваемые на спутник')) throw new Error('Uplink panel purpose is unclear');
 
           const v8Runtime = fs.readFileSync('js/v8.js', 'utf8');
           if (!v8Runtime.includes('control.disabled = !connected')) throw new Error('Visible command controls are not synchronized with serial state');
@@ -63,6 +66,7 @@ jobs:
           const charts = fs.readFileSync('js/charts.js', 'utf8');
           if (!charts.includes('datasetFor(chart, id)')) throw new Error('Multi-ID chart datasets are missing');
           if (!charts.includes('pointRadius: 2.7')) throw new Error('Visible chart points are missing');
+          if (!charts.includes('TEMP: { title: "Температура бортового компьютера"')) throw new Error('MCU temperature chart is not connected');
 
           const finalRuntime = fs.readFileSync('js/v8-final.js', 'utf8');
           if (!finalRuntime.includes('bandwidth: "203"')) throw new Error('v8 UI must enforce RX BW 203 kHz');
@@ -80,12 +84,13 @@ jobs:
           grep -Fq 'APPLICATION_XOR_CHECK=DISABLED' "$ground_esp32"
           grep -Fq '$CMD,RF,' "$ground_esp32"
           grep -Fq '$CMD,RADIO_STATUS' "$ground_esp32"
-          grep -Fq 'FW_VERSION[] = "8.3.0"' "$ground_esp32"
+          grep -Fq 'FW_VERSION[] = "8.3.1"' "$ground_esp32"
           grep -Fq 'radio.setPacketReceivedAction(onRfPacketReceived);' "$ground_esp32"
           grep -Fq 'const int state = radio.readData(packet);' "$ground_esp32"
           grep -Fq '$CMD,RADIO,SET,' "$ground_esp32"
           grep -Fq '$CMD,RADIO,RESET' "$ground_esp32"
           grep -Fq 'RADIO_CONFIG_APPLIED' "$ground_esp32"
+          grep -Fq 'Serial.print(",MCU_TEMP=");' "$ground_esp32"
           if grep -Fq 'const int state = radio.receive(packet);' "$ground_esp32"; then
             echo 'Blocking CC1101 receive must not be used in the ESP32 gateway'
             exit 1
@@ -96,6 +101,10 @@ jobs:
           test -f firmware/ground_station/arduino_nano/Altair_Ground_Arduino_Nano/Altair_Ground_Arduino_Nano.ino
           test -f firmware/satellite/stm32/Altair_Satellite_STM32/Altair_Satellite_STM32.ino
           test -f firmware/satellite/arduino_nano/Altair_Satellite_Arduino_Nano/Altair_Satellite_Arduino_Nano.ino
+          static_nano='firmware/satellite/arduino_nano_static_tx/Altair_Satellite_Arduino_Nano_Static_TX/Altair_Satellite_Arduino_Nano_Static_TX.ino'
+          grep -Fq '1.00,4.20,' "$static_nano"
+          grep -Fq 'readMcuTemperatureC()' "$static_nano"
+          grep -Fq 'calculateXorChecksum' "$static_nano"
 
           grep -Fq '435.000' js/v8.js
           grep -Fq 'rawSerialConsole' js/v8.js

README.md

@@ -65,21 +65,21 @@
 | Модуляция | 2-FSK |
 | Скорость в эфире | 4.8 kbps |
 | Девиация | 5 кГц |
-| Полоса RX | **203 кГц** |
+| Полоса приёмника ЦУПа | **203 кГц** |
 | Мощность TX | **5 дБм** |
 | Sync word | `0x12AD` |
 | Encoding | NRZ |
 | Длина пакета | variable |
 | CRC CC1101 | включён |
 | USB | 115200 бод |
 
-Широкая полоса **203 кГц** выбрана намеренно: на стенде некоторые модули имели заметный частотный уход относительно 435.000 МГц. Этот набор значений используется как исходный профиль при включении ESP32. В панели команд можно изменить частоту, мощность TX и полосу RX, а кнопка **«Сбросить к исходным»** возвращает `435.000 МГц`, `5 дБм` и `203 кГц`.
+Широкая полоса приёмника ЦУПа **203 кГц** выбрана намеренно: на стенде некоторые модули имели заметный частотный уход относительно 435.000 МГц. Этот набор значений используется как исходный профиль при включении ESP32. В панели команд можно изменить частоту, мощность TX и полосу приёмника ЦУПа, а кнопка **«Сбросить к исходным»** возвращает `435.000 МГц`, `5 дБм` и `203 кГц`.
 
 Доступные настройки CC1101:
 
 - частота наземного модуля: от `387.000` до `464.000 МГц`;
 - мощность TX: `−30`, `−20`, `−15`, `−10`, `0`, `5`, `7` или `10 дБм`;
-- полоса RX: `58`, `68`, `81`, `102`, `116`, `135`, `162`, `203`, `232`, `270`, `325`, `406`, `464`, `541`, `650` или `812 кГц`.
+- полоса приёмника ЦУПа: `58`, `68`, `81`, `102`, `116`, `135`, `162`, `203`, `232`, `270`, `325`, `406`, `464`, `541`, `650` или `812 кГц`.
 
 Настройки действуют до перезапуска ESP32. После перезапуска автоматически восстанавливается исходный профиль. При изменении частоты бортовой передатчик необходимо настроить на ту же частоту.
 
@@ -150,32 +150,36 @@
 
 ## Телеметрия
 
-Базовый пакет:
+Базовый пакет с температурой бортового компьютера:
 
 ```text
-02,00001,00015,3.00,4.20,1,33
+02,00001,00015,1.00,4.20,31.6,1,07
 ```
 
 Поля:
 
 ```text
-ID,PACKET,UPTIME,PANEL_POWER,VOLT,MODE,CHECKSUM
+ID,PACKET,UPTIME,PANEL_POWER,VOLT,MCU_TEMP,MODE,CHECKSUM
 ```
 
+`MCU_TEMP` — ориентировочная температура кристалла бортового микроконтроллера в градусах Цельсия. Поле располагается непосредственно после напряжения аккумулятора. Для точных абсолютных измерений внутренний датчик конкретной платы необходимо откалибровать.
+
 Поддерживается и расширенный вариант с состоянием раскрытия антенны:
 
 ```text
-02,00001,00015,3.00,4.20,1,1,33
+02,00001,00015,1.00,4.20,31.6,1,1,1A
 ```
 
 Поля:
 
 ```text
-ID,PACKET,UPTIME,PANEL_POWER,VOLT,MODE,ANTENNA,CHECKSUM
+ID,PACKET,UPTIME,PANEL_POWER,VOLT,MCU_TEMP,MODE,ANTENNA,CHECKSUM
 ```
 
 где `ANTENNA=1` — раскрыта, `ANTENNA=0` — сложена. Если поля `ANTENNA` нет, интерфейс показывает **Н/Д**.
 
+Для совместимости ЦУП продолжает принимать прежние семипольные пакеты без температуры.
+
 ### Важно про контрольную сумму
 
 В v8 **прикладная XOR-проверка намеренно отключена**. Поле `CHECKSUM` сохраняется и отображается, но не является причиной отбрасывания пакета.

css/v8.css

@@ -142,6 +142,17 @@
 #rawSerialConsole .err { color: #ff8e9a; }
 #rawSerialConsole .info { color: #8cf0b4; }
 
+.v8CommandScope {
+    margin: 0 0 14px;
+    padding: 10px 12px;
+    border-left: 3px solid rgba(0,217,255,.72);
+    border-radius: 7px;
+    color: #b5c9dc;
+    background: rgba(0,217,255,.055);
+    font-size: .79rem;
+    line-height: 1.45;
+}
+
 .v8CommandTarget {
     display: grid;
     grid-template-columns: minmax(100px, 180px) 1fr;

firmware/README.md

@@ -12,9 +12,9 @@
 
 Наземный скетч принимает телеметрию, передаёт её программе по USB со скоростью 115200 бод и отправляет команды спутнику через тот же CC1101.
 
-В прошивке ESP32 версии **8.3.0** приём CC1101 работает неблокирующим способом по прерыванию `GDO0`. Поэтому USB-команды обрабатываются постоянно и передача начинается сразу после нажатия кнопки в ЦУПе, без ожидания тайм-аута приёмника. В строку подтверждения `$ACK,RF_TX` добавлено поле `TX_MS` с фактической длительностью радиопередачи.
+В прошивке ESP32 версии **8.3.1** приём CC1101 работает неблокирующим способом по прерыванию `GDO0`. Поэтому USB-команды обрабатываются постоянно и передача начинается сразу после нажатия кнопки в ЦУПе, без ожидания тайм-аута приёмника. В строку подтверждения `$ACK,RF_TX` добавлено поле `TX_MS` с фактической длительностью радиопередачи.
 
-Частоту, мощность TX и полосу RX можно изменять из панели команд ЦУПа. Команда `$CMD,RADIO,RESET` возвращает исходные значения `435.000 МГц`, `5 дБм` и `203 кГц`. Настройки хранятся до перезапуска ESP32; после включения питания используется исходный профиль.
+Частоту, мощность TX и полосу приёмника ЦУПа можно изменять из панели команд. Команда `$CMD,RADIO,RESET` возвращает исходные значения `435.000 МГц`, `5 дБм` и `203 кГц`. Настройки хранятся до перезапуска ESP32; после включения питания используется исходный профиль.
 
 ## Спутник
 
@@ -26,7 +26,7 @@
 
 Бортовые скетчи передают телеметрию, принимают адресованные команды и поддерживают `PING`, `INFO`, `TM_START`, `TM_STOP`, `TM_PERIOD` и `USER`.
 
-Упрощённый вариант `Static_TX` не включает приёмник и обработку команд. Он передаёт один статичный пакет `02,00001,00015,3.00,4.20,1,33` раз в секунду и предназначен для первичной проверки радиолинии.
+Упрощённый вариант `Static_TX` не включает приёмник и обработку команд. Поля ID, номер пакета, uptime, мощность панелей `1.00 Вт`, напряжение аккумулятора `4.20 В` и режим заданы заранее. Поле `MCU_TEMP` измеряется внутренним температурным каналом ATmega328P, располагается сразу после напряжения аккумулятора и передаётся раз в секунду. XOR-контрольная сумма пересчитывается автоматически для каждого значения температуры.
 
 ## Общий радиопрофиль
 

firmware/ground_station/esp32/Altair_Ground_ESP32/Altair_Ground_ESP32.ino

@@ -27,7 +27,7 @@
 #define CC_GDO0  4
 #define CC_GDO2  27
 
-static constexpr char FW_VERSION[] = "8.3.0";
+static constexpr char FW_VERSION[] = "8.3.1";
 static constexpr float RF_FREQ_MHZ = 435.000f;
 static constexpr float RF_BITRATE_KBPS = 4.8f;
 static constexpr float RF_DEVIATION_KHZ = 5.0f;
@@ -365,18 +365,28 @@ void pollUsb() {
 void emitTelemetry(String packet) {
   packet.trim();
 
-  String fields[8];
+  String fields[9];
   int count = 0;
-  if (!splitCsv(packet, fields, 8, count) || (count != 7 && count != 8)) {
+  if (!splitCsv(packet, fields, 9, count) || (count != 7 && count != 8 && count != 9)) {
     Serial.print("$RAW,");
     Serial.println(packet);
     return;
   }
 
-  // Семь полей: ID,PACKET,UPTIME,PANEL_POWER,VOLT,MODE,CHECKSUM.
-  // Восьмое необязательное поле ANTENNA располагается перед CHECKSUM.
-  const bool hasAntenna = (count == 8);
-  const int checksumIndex = hasAntenna ? 7 : 6;
+  // Поддерживаются три варианта пакета:
+  // 7 полей — старый пакет без температуры и без ANTENNA;
+  // 8 полей — новый пакет с MCU_TEMP либо старый пакет с ANTENNA;
+  // 9 полей — новый пакет одновременно с MCU_TEMP и ANTENNA.
+  // В новом восьмипольном формате температура всегда передаётся с десятичной
+  // точкой, поэтому её можно отличить от бинарного MODE старого формата.
+  const bool eighthFieldContainsTemperature =
+    count == 8 && fields[5] != "0" && fields[5] != "1";
+  const bool hasTemperature = count == 9 || eighthFieldContainsTemperature;
+  const bool hasAntenna = count == 9 || (count == 8 && !eighthFieldContainsTemperature);
+  const int temperatureIndex = hasTemperature ? 5 : -1;
+  const int modeIndex = hasTemperature ? 6 : 5;
+  const int antennaIndex = count == 9 ? 7 : (hasAntenna ? 6 : -1);
+  const int checksumIndex = count - 1;
 
   const float rssi = radio.getRSSI();
   const uint8_t lqi = radio.getLQI();
@@ -392,11 +402,17 @@ void emitTelemetry(String packet) {
   Serial.print(",UPTIME="); Serial.print(fields[2]);
   Serial.print(",PANEL_POWER="); Serial.print(fields[3]);
   Serial.print(",VOLT="); Serial.print(fields[4]);
-  Serial.print(",MODE="); Serial.print(fields[5]);
+
+  if (hasTemperature) {
+    Serial.print(",MCU_TEMP=");
+    Serial.print(fields[temperatureIndex]);
+  }
+
+  Serial.print(",MODE="); Serial.print(fields[modeIndex]);
 
   if (hasAntenna) {
     Serial.print(",ANTENNA=");
-    Serial.print(fields[6]);
+    Serial.print(fields[antennaIndex]);
   }
 
   // Поле выводится для совместимости, но шлюз его не проверяет.