mirror of
https://git.vladimir.cc/vladimir/ewsdr.git
synced 2026-08-25 20:37:33 +00:00
chore: refine project documentation
This commit is contained in:
+15
-18
@@ -4,8 +4,8 @@
|
||||
Дата последнего обновления: 2026-06-26.
|
||||
|
||||
Документ описывает поддержку аппаратной передней панели Apache Labs
|
||||
**Andromeda / ANAN-G2** (поворотные энкодеры, кнопки, LED-индикаторы, LCD).
|
||||
За эталон протокола взят Thetis (`Andromeda/Andromeda.cs`, `CAT/CATCommands.cs`).
|
||||
**Andromeda / ANAN-G2** (поворотные энкодеры, кнопки, LED-индикаторы, LCD)
|
||||
через команды CAT, используемые панелью.
|
||||
|
||||
См. также [CAT_STATUS.md](CAT_STATUS.md) — общий статус CAT-подсистемы.
|
||||
|
||||
@@ -84,9 +84,8 @@ Andromeda — это **не отдельный набор команд**, а д
|
||||
|
||||
## 3. Раскладка по умолчанию (AndromedaMap.pas)
|
||||
|
||||
Раскладка **зашита в коде** и зеркалит дефолтную таблицу Thetis
|
||||
(`MakeNewAndromedaDataset`): наш 0-based индекс = «Pushbutton/Encoder Number»
|
||||
Thetis − 1. Номера **проверены на реальной панели** (см.
|
||||
Раскладка **зашита в коде**: внутренний 0-based индекс на единицу меньше номера
|
||||
кнопки или энкодера, передаваемого панелью. Номера **проверены на реальной панели** (см.
|
||||
`andromeda_test/AndDecode.pas`). Правится в `AndromedaMap.pas`.
|
||||
|
||||
### Кнопки (`ZZZP`, индекс 0-based после разбора)
|
||||
@@ -105,12 +104,12 @@ Thetis − 1. Номера **проверены на реальной панел
|
||||
| | | 47 | TUN |
|
||||
|
||||
Не назначены (нет тракта в ewsdr): 2 (RX2 Mute), 40 (band GEN), 41 (RIT/XIT).
|
||||
NB/NR/ANF/SNB/CTCSS/Squelch у реальной панели на кнопках не выведены
|
||||
(в Thetis — на тачскрине), действия в enum сохранены для кастомной раскладки.
|
||||
NB/NR/ANF/SNB/CTCSS/Squelch у реальной панели на кнопках не выведены;
|
||||
действия в enum сохранены для пользовательской раскладки.
|
||||
|
||||
### Shift / band-keypad
|
||||
|
||||
Кнопка #28 — модификатор-защёлка (как `eBBShift` в Thetis). Пока активен
|
||||
Кнопка #28 — модификатор-защёлка. Пока он активен
|
||||
(LED `aiShift` #6), кнопки band-группы #29..39 выбирают диапазон напрямую
|
||||
(`SetBand` 0..10: 160m…6m); #40 = GEN — в ewsdr отсутствует. Снимается
|
||||
повторным Shift либо автоматически после выбора диапазона (non-sticky).
|
||||
@@ -120,7 +119,7 @@ NB/NR/ANF/SNB/CTCSS/Squelch у реальной панели на кнопках
|
||||
| # | Параметр | Шаг |
|
||||
|---|---|---|
|
||||
| 0 | AF Gain (громкость) | ±1 |
|
||||
| 1 | AGC-T (в Thetis — слайдер «RF») | ±1 dB |
|
||||
| 1 | AGC-T | ±1 dB |
|
||||
| 4 | Filter High → ширина фильтра | ±50 Гц (`AND_BW_STEP_HZ`) |
|
||||
| 11 | Drive (мощность) | ±1 % |
|
||||
| VFO | энкодер VFO (`ZZZU/ZZZD`) | ±10 Гц/шаг (`AND_VFO_STEP_HZ`) |
|
||||
@@ -129,7 +128,7 @@ NB/NR/ANF/SNB/CTCSS/Squelch у реальной панели на кнопках
|
||||
> симметричный (`SetFilterBW`), поэтому #4 крутит ширину, #5 пока не задействован.
|
||||
> Энкодеры RX2 AF/AGC (#2/#3), diversity (#6/#7), RIT/XIT (#8/#9) — нет тракта.
|
||||
|
||||
### Индикаторы (`ZZZI`, номера зеркалят дефолт Thetis)
|
||||
### Индикаторы (`ZZZI`, номера соответствуют протоколу панели)
|
||||
| LED # | Индикатор | LED # | Индикатор |
|
||||
|---|---|---|---|
|
||||
| 1 | MOX | 12 | Split |
|
||||
@@ -142,7 +141,7 @@ NB/NR/ANF/SNB/CTCSS/Squelch у реальной панели на кнопках
|
||||
| 11 | VFO Lock | | |
|
||||
|
||||
Драйвятся реально: **MOX, Tune, CTUN, VFO A/B, VFO Lock, Shift, Split, NB, NR,
|
||||
SNB, ANF, Squelch**. Остальные слоты дефолтной таблицы Thetis (ATU/RIT/XIT)
|
||||
SNB, ANF, Squelch**. Остальные слоты таблицы панели (ATU/RIT/XIT)
|
||||
в ewsdr функций не имеют и не зажигаются.
|
||||
|
||||
---
|
||||
@@ -169,7 +168,7 @@ SNB, ANF, Squelch**. Остальные слоты дефолтной табли
|
||||
- Транспорт: **serial** (USB CAT).
|
||||
- Вход: `ZZZD/ZZZU` (VFO), `ZZZE` (энкодеры), `ZZZP` (кнопки), `ZZZS` (рукопожатие).
|
||||
- Выход: **`ZZZI`** — LED-индикаторы (push от `OnStateChanged`, дедуп повторов).
|
||||
- Раскладка — зашитый дефолт, выверена по Thetis и реальной панели.
|
||||
- Раскладка по умолчанию проверена с реальной панелью.
|
||||
- **Shift / band-keypad** — прямой выбор диапазона (#29..39 → `SetBand`), LED `aiShift`.
|
||||
- **VFO Lock** — блокировка перестройки (`SetVfoLock`, гейт в `TuneActiveBy`), LED `aiVFOLock`.
|
||||
- A>B / B>A / Toggle A/B, SDR ON (start/stop) — на штатных кнопках панели.
|
||||
@@ -178,11 +177,11 @@ SNB, ANF, Squelch**. Остальные слоты дефолтной табли
|
||||
### Осталось / возможные улучшения
|
||||
| Задача | Заметки |
|
||||
|---|---|
|
||||
| **Filter High/Low (`ZZZE` #4/#5)** | независимые края фильтра; сейчас #4 = ширина, #5 не задействован. Нужны `FFilterLow/High` + переработка `ApplyModeFilter` и passband дисплея (sideband-aware, как в Thetis) |
|
||||
| **Sticky shift** | сейчас shift всегда non-sticky (снимается band-нажатием); в Thetis есть `AndromedaStickyShift` |
|
||||
| **Filter High/Low (`ZZZE` #4/#5)** | независимые края фильтра; сейчас #4 = ширина, #5 не задействован. Нужны `FFilterLow/High` + переработка `ApplyModeFilter` и sideband-aware passband дисплея |
|
||||
| **Sticky shift** | сейчас shift всегда non-sticky и снимается нажатием кнопки диапазона; можно добавить сохраняемую настройку |
|
||||
| **`ZZMF`** — текст на LCD мультифункц. энкодера | кодировка: 15 ASCII-символов парами цифр (код−32) |
|
||||
| **TCP-транспорт (G2 V2 panel)** | сейчас только serial; нужен режим в `CATTcp` |
|
||||
| **Настраиваемая раскладка** | сейчас зашита; вынести в конфиг/UI (как `AndromedaEditForm` в Thetis) |
|
||||
| **Настраиваемая раскладка** | сейчас зашита; вынести в конфиг и пользовательский интерфейс |
|
||||
| **Long-press кнопок** | принимается (`ZZZP` state=2), но действий пока нет — обрабатывается только нажатие (state=1) |
|
||||
| **Индикаторы RIT/XIT/PureSignal/Diversity/ATU** | нет соответствующих функций в `TRadioController` |
|
||||
| **Мультифункц. энкодер (`aeMulti`)** | назначение не задано |
|
||||
@@ -197,6 +196,4 @@ SNB, ANF, Squelch**. Остальные слоты дефолтной табли
|
||||
- **Добавить индикатор:** элемент `TAndIndicator` + номер в `AND_INDICATOR_NUM` +
|
||||
push в `SyncAllIndicators` и в `OnControllerState` (по нужному `rf*`-полю).
|
||||
- **Изменить раскладку:** только `AndromedaMap.pas` (таблицы-константы).
|
||||
- Сверяться с форматами Thetis: `Andromeda/Andromeda.cs` (логика панели,
|
||||
`EIndicatorActions`/`EButtonBarActions`/`EEncoderActions`) и
|
||||
`CAT/CATCommands.cs` (`ZZZ*`).
|
||||
- Форматы команд `ZZZ*` и нумерацию элементов проверять по протоколу панели.
|
||||
|
||||
Reference in New Issue
Block a user