Wiki SDR SA PRO

Таблиця частот і тривоги

PRO Таблиця частот — другий список вкладки Сканер: ділянки частот із назвами, які ви знаєте наперед. Сигнал зі списку, що лежить у ділянці, дістає її назву й тип; ділянку можна поділити на канали однієї ширини; з таблиці ж беруться правила тривог. На сторінці — редактор таблиці й обмін CSV, клас під рядком сигналу, «ширина не та», зайнятість ділянки й каналів, тривоги, звук, журнал подій і запис IQ за тривогою. Сам пошук сигналів описано на сторінці «Сканер»: пошук сигналів.

Таблиця частот

Перемикач угорі вкладки — Таблиця частот: N. Над списком ділянок — група Таблиця частот з кнопками, налаштуваннями тривог і рядками повідомлень; кружок «?» перед її заголовком коротко пояснює все це.

Згорнутий рядок таблиці показує:

значок виду: сірий квадрат — підпис, жовте коло — нагляд, червоне коло — охорона;
назву;
ділянку в мегагерцах, наприклад 87.5–108;
зайнятість у відсотках або риску, доки її не лічили; сірим — коли ділянки зараз не видно в огляді.

Клік по рядку розгортає його поля; клік ще раз — згортає. Розгорнутим буває один рядок.

Поля рядка

Текст у полі застосовується клавішею Enter або виходом із поля; Esc повертає, як було. Виняток — два поля Ділянка, МГц: їх застосовує лише Enter, а вихід із поля без Enter повертає чинне значення. Значення, з яким рядок перестав би бути рядком таблиці, не приймається: поле повертається до чинного, а в групі над списком червоним сказано Не прийнято — … з причиною.

Назва: Не може бути порожньою.
Тип: Довільне слово на ваш розсуд: «мовлення», «LTE», «дрон». За ним працює тривога на типи.
Ділянка, МГц: Два поля: нижня й верхня межа. Обидві більші за нуль, нижня менша за верхню. Зміна меж починає лічбу зайнятості цієї ділянки наново.
Ширина, кГц: Яким завширшки очікується сигнал у ділянці: від і до. Порожнє поле — межу не сказано; можна сказати лише одну. Нижня не більша за верхню. Від цих чисел залежить позначка «ширина не та».
Крок каналів, кГц: Порожньо — ділянка на канали не ділиться (поруч написано без каналів). Із кроком ділянка ділиться на канали однієї ширини, і поруч сказано, скільки їх вийшло: каналів: N. Крок не більший за саму ділянку й не дрібніший, ніж на 4096 каналів. Див. Канали.
Вид: підпис (типово) — лише назва; нагляд — тривога на будь-який сигнал у ділянці; охорона — тривога на сигнал у ділянці, якого не пояснює вужчий рядок-підпис усередині неї. Див. Тривоги.
Пріоритет: Ціле число від −999 до 999, типово 0. Де ділянки перекриваються, назву дає рядок із вищим пріоритетом.
Коментар: Довільний текст.

Унизу розгорнутого рядка — зайнятість словами (див. нижче) і кнопка Вилучити, що вилучає цей рядок одразу.

Кнопки

Додати: Новий рядок у кінець таблиці з назвою новий і ділянкою, яку ви виділили на спектрі (як виділяти — на сторінці Вікно програми й керування). Якщо придатного виділення немає, ділянка — 100–200 МГц, і її треба виправити полями. Новий рядок одразу розгорнуто.
З діапазонів: По рядку на кожен іменований діапазон програми — з тими самими назвою й межами, якими вони є тієї миті (див. групу «Діапазони»). Рядок із тією самою назвою й межами вдруге не додається; у групі сказано Додано рядків: N; уже були в таблиці: N.
З файлу CSV…: Додає рядки з файлу CSV (див. нижче). Ті самі назва й межі вдруге не беруться. Файл, у якому є хоч одна помилка, не дає жодного рядка, а повідомлення каже, який рядок і чим поганий.
У файл CSV…: Записує всю таблицю у файл CSV. Активна, коли таблиця не порожня.
Вилучити всі: Перше натискання лише питає: напис стає Справді вилучити всі N? на чотири секунди. Друге натискання за цей час вилучає всі рядки, а перед тим кладе копію того, що було у файлі, поруч із ним — і каже, де вона.

Таблиця вміщає до 2000 рядків.

Формат CSV

Перший рядок файлу — заголовок зі стовпцями в будь-якому порядку. Обов’язкові — name, f0_hz і f1_hz, решта — за потреби. Невідомий або повторений стовпець — помилка. Частоти й ширини — у герцах.

Стовпець	Поле рядка
`name`	Назва
`kind`	Тип
`f0_hz`, `f1_hz`	Ділянка: нижня й верхня межа, Гц
`width_min_hz`, `width_max_hz`	Очікувана ширина: від і до, Гц; порожньо — не сказано
`channel_step_hz`	Крок каналів, Гц; порожньо — без каналів
`role`	Вид: `label` (підпис), `watch` (нагляд) або `guard` (охорона); порожньо — `label`
`priority`	Пріоритет, ціле від −999 до 999
`comment`	Коментар

Роздільник — кома, крапка з комою або табуляція: програма бере той, якого найбільше в заголовку. Якщо роздільник не кома, у числах можна писати десяткову кому.
Файл має бути в кодуванні UTF-8. Таблицю, збережену як звичайний «CSV» у кодуванні Windows, програма не вгадує й просить зберегти її як «CSV UTF-8».
Записаний програмою файл — UTF-8 із позначкою порядку байтів, тож таблична програма відкриває його без питань.

Де лежить таблиця

Таблиця зберігається після кожної правки у файл scanner\table.json теки даних SDR SA PRO (для програми, встановленої з пакета, — Документи\SDR SA PRO\scanner). Доки в таблиці нічого не змінено, ні файлу, ні теки немає.

Файл, якого не вдалося прочитати, не перезаписується. Вкладка каже, який рядок чим поганий, таблиця замикається (кнопки правки неактивні), і з’являються дві кнопки: Перечитати файл — після того, як ви виправили файл руками; Почати нову таблицю — тоді зіпсований файл перейменовується в table.broken-N.json, а не стирається.
Вилучити всі лишає копію table.before-clear-N.json поруч.
Файл, записаний новішою версією програми, не читається й не перезаписується.

Клас під рядком сигналу

Рядок списку сигналів, що лежить у ділянці таблиці, дістає під собою другий рядок. Він складається з частин, розділених крапкою «·»:

причина тривоги, якщо вона була: тривога: охорона, тривога: нагляд або тривога: тип;
назва ділянки;
канал N — коли рядок є каналом ділянки з кроком;
тип ділянки, якщо його задано;
вужчий за очікувані … або ширший за очікувані … — див. нижче.

Червоний цей рядок — коли тривогу ще не прийнято; жовтий — коли ширина не та; інакше сірий. Рядка немає, коли сигнал не лежить у жодній ділянці.

Де ділянки перекриваються, назву й тип дає одна: з вищим пріоритетом, далі вужча, далі та, що в таблиці вище. Види ж (нагляд, охорона) збираються з усіх ділянок, що накривають частоту.
Правка таблиці підписує те, що вже стоїть у списку, одразу — не чекаючи наступного огляду.
Це мітка частоти, а не виду сигналу: розпізнавання типу сигналу й нейромережі в цій версії немає. Так каже й рядок Клас у згортці «Наскільки списку вірити» вкладки «Сканер».
Частота для класу — та, яку показує сам приймач: похибки його опорного генератора таблиця не знає.

Ширина не та

Якщо ділянка каже очікувану ширину, а рядок сигналу з неї виходить, під рядком стоїть вужчий за очікувані … чи ширший за очікувані … з названою межею.

Допуск — 10 % очікуваної ширини і два біни: точніше ширину список не міряє.
Позначка з’являється не раніше шістнадцяти влучань: доти обвідна рядка ще не заповнена.
«Вужчий» кажуть лише сталому сигналові, жоден край якого не лежить на стику настройок свіпу чи на краю огляду: там обривається вимір, а не сигнал.
Рядкам-каналам і ділянкам активності цієї позначки немає.

Зайнятість ділянки

Відсоток у згорнутому рядку таблиці — у якій частці оглядів у ділянці було хоч одне виявлення, підтверджене чи ні. Так видно й рідкі пакети, яких список сигналів за побудовою не тримає. Розгорнутий рядок каже те саме словами:

Зайнятість N %: виявлення в N оглядах із N; сам шум дав би N % — останнє число каже, скільки дав би шум сам: у широкій ділянці хибне виявлення трапляється й без сигналу;
із дописом — зараз поза оглядом у кінці, коли ділянки зараз не видно;
Зайнятість ще не рахувалась або Зайнятість: огляд цю ділянку не накриває.

Ділянка вважається в огляді, коли виміряно хоча б половину її. Лічба починається наново з Очистити, з новим увімкненням пошуку, а для окремого рядка — зі зміною його меж.

Канали

Ділянку з кроком каналів «Сканер» судить не по бінах, а за потужністю кожного каналу. Канали йдуть від нижньої межі ділянки, кожен завширшки з крок, і лічаться від одного; шматок біля верхньої межі, вужчий за крок, каналом не є.

Канал зайнятий, коли його потужність над полицею вища за поріг каналу або коли хоч один його бін сам стоїть над порогом біна — так не губиться вузька несуча в широкому каналі. Поріг каналу каже рядок Канали у згортці «Наскільки списку вірити» вкладки «Сканер».
Зайнятий канал — окремий рядок списку з межами каналу; під ним — назва ділянки й канал N. Сусідні зайняті канали — окремі рядки, хоч би сигнали в них стояли впритул; зайнятий канал і широкий сигнал поверх нього — теж окремі рядки.
Рівень у рядку каналу — потужність каналу над полицею, а не пік сигналу в ньому.
Тривога й рядок журналу подій за таким рядком несуть номер каналу.
Де ділянки з каналами перекриваються, канали дає та, що виграє клас.
Після зміни кроку номер каналу рядкові кажуть лише тоді, коли він справді стоїть на каналі нової розкладки.

Під полем кроку розгорнутого рядка — зайнятість на канал: зайнято N каналів із N оглянутих; найлюдніший — канал N (N % оглядів) або оглянуто N каналів, зайнятих не було. Вона з’являється, коли огляд уже бачив канали цієї ділянки, і лічиться лише для тих меж і кроку, за яких огляди йшли.

Коли канали не судяться

Тоді в каналах шукають як звичайно, по бінах, а рядок Канали каже, скільки таких:

канали ділянки вужчі за 4 біни виміру;
у каналі виміряно менше половини бінів;
каналів у вимірі понад 4096;
канал ширший, ніж полиця цього виміру відрізняє від шуму (у настроєному режимі й у свіпі, вужчому за шість настройок).

У свіпі шум для каналів беруть з решти бінів тієї ж настройки, а коли канали зайняли настройку майже всю, — від сусідніх настройок. Тоді сигнал, що зайняв таку настройку цілком, видно лише від рівня, який каже рядок Канали. У настроєному режимі й вузькому свіпі такого запасного шуму немає: суцільна смуга зайнятих каналів, ширша, ніж бачить полиця, може читатись вільною — рядок Канали каже, скільки каналів стоїть у таких смугах.

Активність у ділянці

Стрибаюча частота й рідкі пакети рядком сигналу зазвичай не стають. Їх видно двома способами: окремим рядком активності в списку сигналів (див. Ділянки активності) і зайнятістю ділянки таблиці. Рядок активності дістає клас за таблицею й здіймає тривоги так само, як рядок сигналу.

Тривоги

Правила тривог задає таблиця частот — окремого переліку правил немає.

Нагляд: Тривога на будь-який сигнал, що є, у ділянці рядка з видом нагляд.
Охорона: Тривога на сигнал у ділянці рядка з видом охорона, якого не пояснює рядок-підпис: клас сигналу дає не підпис. Відомий передавач усередині зони записують рядком-підписом, вужчим за зону, — тоді клас дає він, і тривоги немає.
Тривога на типи: Поле Тривога на типи над списком ділянок: типи через кому (крапка з комою теж годиться). Тривога — на сигнал, чий клас має тип із переліку, хоч де він з’явився. Великі й малі літери не розрізняються, повтори відкидаються. Порожнє поле — таких тривог немає.

Причина в тривоги одна — перша за старшинством: охорона, нагляд, тип.
Про один рядок списку тривога одна. Рядок, що зник і повернувся, вийшов з огляду й знову в ньому чи гойдається довкола порога, — той самий рядок, і другої тривоги не буде. Нова тривога — лише для нового рядка, після Очистити або нового ввімкнення пошуку.
Ділянка активності, що згодом стала рядком сигналу на тому самому місці, другої тривоги не здіймає. Новий сигнал, що лише лежить усередині широкої ділянки активності, — здіймає свою.
Рядок судиться щоогляду, доки про нього не було тривоги: зона нагляду, поставлена над сигналом, що вже є, скаже про нього з наступного огляду.
Для запису з файлу й демонстраційного сигналу тривог немає.

Як видно тривогу

Кружок рядка й рядок під ним — червоні; під рядком — причина.
Над списком сигналів — Тривог: N і кнопка Прийнято. Вона знімає підсвітку й обнуляє лічильник; причина в рядку лишається.
У рядку стану внизу вікна — червоний лічильник ТРИВОГ: N, видний з будь-якої вкладки. Без неприйнятих тривог він місця не займає.
Позначка сигналу на спектрі — червона.
Рядок Тривоги у згортці «Наскільки списку вірити» вкладки «Сканер» каже, скільки ділянок нагляду й охорони і які типи в переліку, або правил немає: у таблиці частот жодної ділянки нагляду чи охорони й жодного типу в переліку.

Звук, журнал подій і запис IQ

Під полем типів — три окремі вимикачі. Усі вони типово вимкнені й зберігаються між запусками. Під ними — рядок повідомлень: куди пишеться журнал, чого не вдалося прочитати, записати чи прибрати.

Звук тривоги: Системний звук Windows — один на огляд, у якому були тривоги, хоч би скільки їх було.
Журнал подій: Рядок у файлі CSV на кожну тривогу. Див. нижче.
Запис IQ за тривогою: Запис потоку приймача, коли сталась тривога. Поряд — поле секунд (активне, коли вимикач увімкнено) і напис с від останньої тривоги; лише в настроєному режимі. Див. нижче.

Журнал подій

Журнал пишеться, лише поки ввімкнено Журнал подій. Файли лежать у теці scanner теки даних SDR SA PRO (для програми з пакета — Документи\SDR SA PRO\scanner). Точний шлях каже рядок під вимикачами: Журнал подій: … — файл на добу (за UTC), рядок на тривогу; не більше 1000 рядків на добу, зберігаються останні 30 діб.

Файл на добу за UTC: events-РРРР-ММ-ДД.csv, кодування UTF-8 з позначкою порядку байтів, перший рядок — заголовок.
Не більше 1000 рядків на добу. Далі в файл іде один рядок із причиною limit, а решта тривог лише лічиться: Стелю доби досягнуто: не записано тривог — N.
Зберігаються останні 30 файлів доби: коли починається новий, найстаріші понад це програма прибирає сама — лише ті, що названі рівно як файл доби. Копію чи архів поруч вона не чіпає.
Що рядка не записано чи старого файлу не вдалося прибрати, вкладка каже: Останньої тривоги в журнал не записано: …, Старих файлів журналу, яких не вдалося прибрати: N.

Стовпець	Що в ньому
`time_utc`	Час виміру, у якому рядок уперше підпав під правило, UTC до мілісекунди: `2026-10-10T12:34:56.789Z`
`frequency_hz`	Центр рядка, Гц
`width_hz`	Ширина рядка, Гц
`level_db`	Рівень у дБ над місцевою полицею, один знак після крапки; порожньо — рівня немає
`reason`	Причина: `guard` (охорона), `watch` (нагляд) або `kind` (тип)
`name`, `kind`	Клас сигналу за таблицею: назва й тип ділянки
`what`	`signal` — рядок сигналу, `activity` — ділянка активності
`number`	Порядковий номер тривоги від початку списку, з одиниці
`channel`	Номер каналу; порожньо — рядок не канал

Запис IQ за тривогою

Лише в настроєному режимі. У свіпі приймач на сигналі не стоїть: тривога в свіпі запису не дає, і рядок Запис IQ у згортці «Наскільки списку вірити» каже лише в настроєному режимі — зараз свіп, приймач на сигналі не стоїть.
Пише звичайний записувач програми — у ту саму теку, що й ручні записи (див. Запис IQ), увесь потік приймача. Ім’я запису починається з scan-, частоти тривоги в мегагерцах і часу UTC, наприклад scan-433.920MHz-20261020-101500.
Тривалість — у полі секунд: від 1 до 600, типово 10. Значення поза межами не приймається. Час лічиться від останньої тривоги: друга тривога під час запису продовжує його, а не починає новий.
Передтригера немає. Тривога приходить після того, як рядок підтвердився, і те, що було до неї, не записується.
Запис, який почали ви самі, «Сканер» не чіпає: тривога тоді лишається без запису, і рядок Запис IQ про це каже.
Якщо програма в записі відмовила (наприклад, диск повний або прилад передає), рядок Запис IQ каже, що запис не почався, і «Сканер» не просить знову, доки ви не вимкнете й не ввімкнете вимикач.
Запис, який спинили ви, диск чи помилка, «Сканер» не відновлює: наступна тривога попросить новий.
Що відбувається із записом, каже рядок Запис IQ: за тривогою, N с від останньої — лише в настроєному режимі, без передтригера, далі — яке ім’я попрошено й що пишеться зараз.

Межі

Клас — мітка частоти з таблиці, не розпізнаний вид сигналу.
Тривоги — лише за правилами таблиці. Тривоги за рівнем у dBm немає: рівні «Сканера» — дБ над полицею.
Запис за тривогою — лише в настроєному режимі й без передтригера.
У настроєному режимі канал усередині сигналу, значно ширшого за нього, перші огляди показує рівень біля нуля: полицю там оцінено по самому сигналу. Рівень стає правдивим, коли рядки підтверджено.
Сильна несуча в крайньому біні каналу займає й сусідній канал.
Для запису з файлу й демонстраційного сигналу тривог немає.

Wiki описує версію 0.9.49. Версію вашої програми видно в меню «Довідка» → «Про програму». Знайшли неточність? Напишіть нам.