Разработчику
Пишете код киоска, панели или сервера — вам сюда. Здесь всё, что нельзя узнать из ко да: почему плата отвечает именно так и какие команды ломают железо навсегда.
- устройство монорепо и зачем каждый пакет;
- протокол платы замков и четыре запрета;
- состояние ячейки как свод трёх источников;
- сторожевой таймер, сборка, заливка, развёртывание.
Оператору
Следите за постаматами и выезжаете к ним — вам сюда. Без жаргона: что означает каждое состояние ячейки, что делать при каждой тревоге и когда ехать не нужно.
- как настроить карту ячеек и мастер привязки;
- как открыть ячейку удалённо и вручную;
- что делать при каждой тревоге;
- к кому идти, когда ничего не помогает.
Три вещи, которые верны для всех
- Команды «закрыть» не существует. Защёлка пружинная: плата убирает язычок на треть секунды, а дверцу закрывает человек рукой. «Закрыто» — это показание датчика, а не результат команды.
- Подтверждение открытия не значит, что дверь открылась. Плата подтверждает, что приняла команду. Открылась ли дверца, знает только датчик.
- Если приложение зависнет, плата перезагрузится сама примерно через пять минут. Это страховка, а не поломка, и в логах при этом не будет ничего.
Документация по железу — прошивка, образы, разделы памяти, UART-консоль — живёт отдельно, в репозитории прошивки. Здесь она не переписана: пересказано только то, что нужно для работы с кодом или для эксплуатации.