Lab042: attenuator on hand, relax the gain restriction

The bench has an AT30S: 30 dB, SMA, rated to 200 W. That removes the last
hardware blocker and changes the safety analysis.

With 30 dB in line, TX at full 0 dB gain lands at about -23 dBm on the
receiver, some 25 dB below the +2.5 dBm damage threshold. The whole
tx_hardwaregain range is therefore safe, so the staged -60 dB start and
the -30 dB ceiling are no longer needed.

- record the attenuator in the inventory and note that its 200 W rating is
  irrelevant here, attenuation does not depend on level
- replace the interim procedure with a level budget table and a starting
  point of -30 dB, giving about -53 dBm at the receiver
- require a visual check that the attenuator is actually in the path
  before the first transmit
- keep the ban on running without it: it guards against operator error,
  not against the calculated level

Only the environment blocker is left: pyadi-iio and libiio are missing
from the interpreter on PATH.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

docs/lab042_hardware_loopback_spec.md

@@ -58,7 +58,9 @@
 | Кабели SMA | будут найдены |
 | Антенны: штыревые на магнитном основании, короткая штыревая | есть, **в Lab042 не используются** |
 | Рамочная антенна Donut AM (0,5–2 МГц) | к проекту отношения не имеет |
-| **Аттенюатор SMA 30 дБ** | **отсутствует** |
+| **Аттенюатор AT30S**, 30 дБ, до 200 Вт, разъёмы SMA | есть |
+
+Аппаратных препятствий к началу работы нет. Запас по мощности у аттенюатора избыточен на много порядков — рассчитан на передатчики в сотни ватт, а у нас доли милливатта, — но это никак не мешает: ослабление от уровня сигнала не зависит.
 
 Важно: устройство — **Pluto+**, а не оригинальный ADALM-PLUTO. Отличия, которые имеют значение:
 
@@ -72,22 +74,27 @@
 
 1. **Антенны убрать со стола до начала работы.** Не «не подключать», а физически убрать. Случайно вкрученная в передатчик антенна превращает лабораторную в незаконный выход в эфир.
 2. Передатчик не включать при отключённом кабеле: выход без нагрузки вреден для оконечного каскада.
-3. Соединять выход передатчика со входом приёмника **только через аттенюатор**. Аттенюатора сейчас нет, поэтому действует временный порядок ниже.
+3. Аттенюатор AT30S включается **в разрыв** между выходом передатчика и входом приёмника. Не параллельно, не на свободный порт — именно последовательно в тракт.
+4. Перед первым включением передатчика убедиться глазами, что аттенюатор действительно в цепи. Это единственное, что стоит между опечаткой в настройке усиления и сгоревшим приёмником.
 
-### Про аттенюатор: почему он нужен и как начать без него
+### Расчёт уровней
 
-Выход передатчика Pluto+ при нулевом ослаблении даёт примерно **+7 дБм**. Предельно допустимый уровень на входе приёмника — около **+2,5 дБм**. То есть прямой кабель при максимальном усилении передатчика выводит приёмник за предел и может его повредить.
+| Величина | Значение |
+|---|---|
+| Выход передатчика Pluto+ при усилении 0 дБ | около **+7 дБм** |
+| Предельно допустимый уровень на входе приёмника | около **+2,5 дБм** |
+| Ослабление аттенюатора | 30 дБ |
+| Уровень на входе приёмника при усилении 0 дБ | около **−23 дБм** |
 
-Регулировка `tx_hardwaregain_chan0` работает в диапазоне от −89 до 0 дБ. При установке −30 дБ выход составит около −23 дБм — это в тридцать раз ниже опасного порога и одновременно отличный рабочий уровень для кабеля.
+Вывод: **с аттенюатором в разрыве весь диапазон `tx_hardwaregain_chan0` от −89 до 0 дБ безопасен для приёмника.** Запас до порога повреждения составляет более 25 дБ даже в самом худшем случае.
 
-**Временный порядок до появления аттенюатора:**
+**Порядок подбора усиления:**
 
-1. Перед первым включением выставить `tx_hardwaregain_chan0 = -60`.
+1. Начать с `tx_hardwaregain_chan0 = -30`. Это даёт около −53 дБм на входе приёмника — заведомо чистый и заведомо безопасный уровень.
-2. Убедиться, что приёмник видит сигнал. При −60 дБ он будет слабым, но различимым.
+2. Если сигнал слишком слаб, поднимать шагами по 10 дБ.
-3. Поднимать усиление шагами по 10 дБ, **не превышая −30 дБ**, пока созвездие не станет чистым.
+3. Если созвездие разваливается при сильном сигнале — это насыщение приёмника, лечится **уменьшением** усиления, а не увеличением.
-4. Значение выше −20 дБ без аттенюатора не выставлять ни при каких обстоятельствах.
 
-Аттенюатор на 30 дБ стоит недорого и защищает не от расчётного уровня, а от ошибки оператора: одна опечатка в настройке усиления — и приёмник выходит из строя. **Заказать стоит, начинать работу можно не дожидаясь.**
+Без аттенюатора работать запрещено даже при малом усилении: защита нужна не от расчётного уровня, а от ошибки оператора.
 
 ---
 
@@ -137,7 +144,7 @@
 | Несущая передачи и приёма | 435 МГц | обе одинаковые |
 | Частота дискретизации | 640 000 | совпадает с трактом |
 | Полоса радиочастотного тракта | 200 000 Гц | минимум Pluto, сигнал занимает около 27 кГц |
-| Усиление передатчика | начать с −60 дБ, не выше −30 дБ без аттенюатора | см. раздел 5 |
+| Усиление передатчика | начать с −30 дБ | с аттенюатором безопасен весь диапазон, см. раздел 5 |
 | Режим усиления приёмника | `manual` | автоматика мешает измерениям |
 | Усиление приёмника | начать с 20 дБ | подобрать по амплитуде |
 | Циклический буфер передачи | **выключен** | см. раздел 7 |
@@ -211,7 +218,7 @@
 | Полное время передачи, секунды | измерение |
 | Фактическая полезная скорость, кбит/с | расчёт из двух предыдущих |
 | Усиление передатчика и приёмника | из настроек устройства |
-| Ослабление аттенюатора, дБ | из состава схемы |
+| Ослабление аттенюатора, дБ | 30, AT30S |
 
 **Обязательные файлы в `data/processed/lab042`**