Сеть и обновление прошивки

11. WiFi - STA-подключение

Событийная state-machine поверх (режим STA). Включается PIPCORE_ENABLE_WIFI. Радио работает, пока запрошено wifiRequest(true); при wifiRequest(false) железо полностью деинициализируется.

Важно: таймауты подключения и повторные попытки продвигаются только внутри wifiService() - вызывайте её регулярно (например, каждый проход главного цикла).

Конфигурация

struct WifiConfig
{
    char ssid[kWifiSsidCap] = {};          // kWifiSsidCap = 33
    char password[kWifiPasswordCap] = {};  // kWifiPasswordCap = 65

    bool disableSleep = false;             // true → WIFI_PS_NONE (максимальная
                                           // пропускная способность)

    bool fullScan = false;                 // true → сканировать все каналы
                                           // (медленнее, надёжнее)

    bool autoReconnect = true;             // автоматический реконнект с
                                           // нарастающей паузой

    uint32_t connectTimeoutMs = 15'000;    // таймаут одной попытки
    uint32_t retryDelayMs = 2'500;         // базовая пауза между попытками

    uint32_t staticIp = 0;                 // статический IPv4, формат - см. ниже
    
    uint32_t gateway = 0;                  // если staticIp, gateway и subnet
                                           // все != 0 - DHCP отключается
    uint32_t subnet = 0;
    uint32_t dns1 = 0;                     // необязательные DNS
    uint32_t dns2 = 0;

    void setCredentials(const char *ssidIn, const char *passwordIn);  // безопасное копирование
};

enum class WifiState : uint8_t
{
    Off = 0, Connecting = 1, Connected = 2, Failed = 3, Unsupported = 4
};

Функции

Пример

net::WifiConfig cfg = {};
cfg.setCredentials("MyWiFi", "password");
cfg.disableSleep = true;
net::wifiConfigure(cfg);
net::wifiRequest(true);

const uint32_t start = plat->nowMs();
while (!net::wifiConnected() && plat->nowMs() - start < 20'000)
{
    net::wifiService();
    plat->delayMs(10);
}

if (net::wifiConnected())
{
    const uint32_t ip = net::wifiLocalIpV4();
    log::info("IP: %u.%u.%u.%u",
              unsigned(ip >> 24), unsigned((ip >> 16) & 0xFF),
              unsigned((ip >> 8) & 0xFF), unsigned(ip & 0xFF));
}

Формат IP-адресов

Адреса хранятся как uint32_t в порядке «старший октет - в старших битах»: 192.168.1.10 → 0xC0A8010A; ip >> 24 - первый октет. Это относится и к staticIp, gateway, subnet, dns1, dns2.

Повторные попытки

Если попытка подключения не удалась (таймаут или обрыв), состояние сменяется на Failed / Connecting, и через retryDelayMs начинается новая попытка. При автореконнекте пауза удваивается с каждой неудачей до 16× от базовой - сеть не «заваливается» запросами при лежащем роутере. Ручной реконнект - снова wifiRequest(true).

12. OTA - обновления прошивки

Обновление по манифесту с криптографической проверкой. Включается PIPCORE_ENABLE_OTA (требует WiFi). Сервис сам включает радио на время работы, поэтому WiFi-креды достаточно задать через net::wifiConfigure() - вызывать wifiRequest(true) не нужно.

Поток обновления

GET {URL}/index.json
   → выбор канала (stable / beta) и более нового build
GET {URL}/<релиз>/manifest.json
   → проверка Ed25519-подписи
   → состояние UpdateAvailable
requestInstall()
   → потоковая загрузка с подсчётом SHA-256
   → запись во второй OTA-слот
   → смена загрузочного раздела
   → перезагрузка

Anti-replay: build не может быть меньше сохранённого для канала (хранится в NVS).

Типы

struct Options
{
    uint16_t currentVerMajor = 0, currentVerMinor = 0, currentVerPatch = 0;
    uint64_t currentBuild = 0;               // монотонный счётчик сборки
    const char *ed25519PubkeyHex = nullptr;  // открытый ключ, 64 hex-символа
};

enum class Channel   : uint8_t { Stable = 0, Beta = 1 };
enum class CheckMode : uint8_t { NewerOnly = 0, AllowDowngrade = 1 };

enum class State : uint8_t
{
    Idle = 0, WifiStarting = 1, FetchingManifest = 2, UpdateAvailable = 3,
    Downloading = 4, Installing = 5, Success = 6, Error = 7, UpToDate = 8
};

struct Manifest
{
    char     title[64];
    uint16_t verMajor, verMinor, verPatch;
    char     version[32];
    uint64_t build;
    uint32_t size;               // размер прошивки, байт
    char     url[512];
    char     desc[256];
    uint8_t  sha256[32];         // контрольная сумма образа
    uint8_t  sigEd25519[64];     // подпись манифеста
    bool     hasSig;
};

struct Status
{
    State state;  Error error;
    int httpCode;                // HTTP-код последнего запроса
    int platformCode;            // код для диагностики
    uint32_t downloaded, total;  // прогресс загрузки, байт
    uint32_t lastChangeMs;       // время последней смены состояния
    int8_t versionCmp, buildCmp; // сравнение с текущей прошивкой
    bool pendingVerify;          // прошивка ждёт подтверждения
    Channel channel;
    Manifest manifest;
};

using StatusCallback = void (*)(const Status &st, void *user);

Коды ошибок (ota::Error)

Функции

Пример

ota::Options opt = {};
opt.currentVerMajor = 2;  opt.currentVerMinor = 0;  opt.currentVerPatch = 0;
opt.currentBuild = 2000000;
opt.ed25519PubkeyHex = PIPCORE_PUBKEY;    // ваш публичный ключ, 64 hex-символа

ota::configure(opt, onStatus, nullptr);
ota::requestCheck();

// в главном цикле:
ota::service();

const ota::Status &st = ota::status();
if (st.state == ota::State::UpdateAvailable)
    ota::requestInstall();                // например, после подтверждения пользователя
else if (st.state == ota::State::Error)
    log::error("ota: error %d (http %d)", int(st.error), st.httpCode);

Подтверждение после обновления

Новая прошивка стартует в состоянии pending-verify. Если приложение не вызовет markAppValid(), загрузчик IDF откатится на предыдущую версию. Вызывайте markAppValid(), когда убедились, что всё работает (сеть поднялась, железо ответило):

extern "C" void app_main()
{
    // ... инициализация железа ...
    if (initOk)
        ota::markAppValid();
}

Безопасность

• TLS: сертификат сервера проверяется системным bundle ESP-IDF.
• Подпись: манифест подписывается Ed25519 по каноническому представлению полей (префикс pipcore-ota-manifest, title, version, build, size, sha256, url, desc). Меняйте эти поля только инструментом публикации - иначе подпись станет недействительной.
• Целостность: образ проверяется по SHA-256 из подписанного манифеста.