Controller Tv Lift

TVLift Controller

Профессиональная платформа управления лифтом для телевизора на базе ESP32.

Проект включает в себя:

• прошивку контроллера ESP32;
• мобильное приложение;
• сервер обновлений и управления;
• веб-панель администратора;
• аппаратную документацию;
• систему удаленного обновления прошивки (OTA — Over-the-Air);
• полную инженерную документацию.

Основные возможности

• управление электроприводом лифта;
• поддержка Wi-Fi и Ethernet;
• первоначальная настройка через Captive Portal;
• безопасное удаленное обновление прошивки;
• хранение настроек во Flash памяти;
• REST API для мобильного приложения;
• журнал событий;
• диагностика устройства;
• поддержка нескольких аппаратных ревизий.

Архитектура проекта

TVLift/

├── docs/               Документация
├── firmware/           Прошивка ESP32
├── backend/            Сервер
├── mobile/             Мобильное приложение
├── web-admin/          Панель администратора
├── hardware/           KiCad (схемы и PCB)
├── tools/              Скрипты и утилиты
├── component-library/  Библиотека компонентов
└── README.md

Документация

Архитектура

Аппаратная часть

Библиотека компонентов

В проекте используется собственная библиотека утвержденных компонентов.

Все новые устройства должны использовать компоненты из этой библиотеки, если нет технической причины выбрать другой элемент.

Используемые технологии

Firmware

• ESP32
• ESP-IDF
• PlatformIO
• C++17

Backend

• Python
• FastAPI
• PostgreSQL

Mobile

• Flutter

Web

• React
• TypeScript

Основные принципы разработки

Проект строится по следующим правилам:

• модульная архитектура;
• минимальная связанность модулей;
• отсутствие глобальных переменных;
• отсутствие динамического выделения памяти в рабочем режиме;
• аппаратная независимость бизнес-логики;
• документирование всех архитектурных решений;
• обязательное код-ревью перед слиянием изменений.

Структура прошивки

Firmware состоит из независимых модулей.

• Boot
• Configuration
• Storage
• Hardware Abstraction Layer (HAL)
• Network Manager
• OTA Manager
• REST API
• Elevator Controller
• Logger
• Diagnostics

Состояния контроллера

Boot

↓

Hardware Init

↓

Load Configuration

↓

Network Connection

↓

Cloud Connection

↓

Ready

↓

Working

↓

Error Recovery

Требования к качеству

• единый стиль кода;
• обязательное документирование публичных интерфейсов;
• отсутствие магических чисел;
• отсутствие дублирования кода;
• обязательные журналы ошибок;
• возможность безопасного восстановления после сбоя.

Версионирование

Используется Semantic Versioning.

MAJOR.MINOR.PATCH

Например

2.4.15

Лицензия

Определяется владельцем проекта.

Статус проекта

🚧 В активной разработке.