main.c

Go to the documentation of this file.

/********************************** (C) COPYRIGHT *******************************
 * File Name          : main.c
 * Author             : AAA
 * Version            : V1.0.0
 * Date               : 2026/06/26
 * Description        : Точка входа прошивки модуля освещения (LCM).
 *
 *                      Устройство: CH32V003F4P6 (WCH, RISC-V RV32EC).
 *                      Роль на шине: I2C slave, адрес из NVM (заводской 0x7F).
 *                      Исполнение: 8 реле (НО), 4 группы зон освещения.
 *
 *                      Разделение обязанностей:
 *                        — main() + LCM_Module_Poll(): фон (NVM, reboot);
 *                        — I2C1_EV/ER_IRQHandler в lcm_module.c: протокол RC↔LCM.
 *
 *                      Отладочный UART (115200) подключён через debug.c;
 *                      в рабочем режиме управление — только по I2C.
 *********************************************************************************/
 
#include "debug.h"
#include "user_data.h"
#include "lcm_module.h"
#include "event_log.h"
 
/* IWDG timeout ~2 s при LSI ≈ 128 kHz: (999 + 1) * 256 / 128000 = 2.0 s */
#define LCM_IWDG_PRESCALER       IWDG_Prescaler_256
#define LCM_IWDG_RELOAD          999U
 
/*********************************************************************
 * @fn      LCM_IwdgInit
 *
 * @brief   Инициализация Independent Watchdog (IWDG).
 *
 * @details IWDG тактируется от LSI (~128 kHz), который не запускается
 *          автоматически — без явного RCC_LSICmd(ENABLE) и ожидания
 *          RCC_FLAG_LSIRDY биты PVU/RVU в IWDG_STATR никогда не
 *          сбрасываются, а IWDG_Enable() ждёт LSIRDY (RSTSCKR бит 1)
 *          и виснет здесь навсегда — main() не доходит до while(1),
 *          из-за чего EventLog_Process()/LCM_Led_Poll() не выполняются
 *          (хотя I2C-команды всё равно исполняются — их обработка идёт
 *          в ISR независимо от основного цикла).
 *
 *          Конфигурирует прескалер и reload, затем включает watchdog.
 *          После включения IWDG работает всегда до аппаратного reset.
 */
static void LCM_IwdgInit(void)
{
    RCC_LSICmd(ENABLE);
    while (RCC_GetFlagStatus(RCC_FLAG_LSIRDY) == RESET) {
    }
 
    IWDG_WriteAccessCmd(IWDG_WriteAccess_Enable);
    IWDG_SetPrescaler(LCM_IWDG_PRESCALER);
    IWDG_SetReload(LCM_IWDG_RELOAD);
 
    while (IWDG_GetFlagStatus(IWDG_FLAG_PVU) != RESET) {
    }
    while (IWDG_GetFlagStatus(IWDG_FLAG_RVU) != RESET) {
    }
 
    IWDG_ReloadCounter();
    IWDG_Enable();
}
 
/*********************************************************************
 * @fn      main
 *
 * @brief   Главная функция программы.
 *
 * @details Последовательность запуска:
 *
 *          1) NVIC_PriorityGroupConfig — 1 бит preemption, 3 бита subpriority
 *             (должно быть до NVIC_Init в модуле I2C).
 *          2) SystemCoreClockUpdate — пересчёт частоты после reset (Delay, UART).
 *          3) EventLog_Init — USART1 PD6, 115200 8N1, журнал событий.
 *          4) Delay_Init — SysTick для Delay_Us / Delay_Ms.
 *          5) UserData_Init — загрузка 26 байт пользовательской NVM в RAM-кэш;
 *             при ошибке — LCM_Module_ReportUserDataStatus() после Init.
 *          6) LCM_Module_Init — GPIO реле, конфигурация из NVM, I2C slave.
 *          7) LCM_IwdgInit — запуск IWDG для защиты от зависания.
 *
 *          Основной цикл пустой с точки зрения прикладной логики реле:
 *          LCM_Module_Poll() обслуживает отложенную запись flash и перезагрузку;
 *          EventLog_Process() выводит буфер событий на UART;
 *          IWDG_ReloadCounter() подтверждает, что main-цикл жив.
 *          Все команды RC обрабатываются асинхронно в прерываниях I2C.
 *
 * @return  none (функция не возвращает управление)
 */
int main(void)
{
    UserData_Status ud_st;
 
    /* Группа приоритетов прерываний для I2C1_EV / I2C1_ER */
    NVIC_PriorityGroupConfig(NVIC_PriorityGroup_1);
 
    /* Актуальная частота ядра (HSI/PLL) для таймеров и UART */
    SystemCoreClockUpdate();
 
    EventLog_Init();
    EventLog_BootBanner();
 
    Delay_Init();
 
    ud_st = UserData_Init();
    EventLog_UserDataInit(ud_st);
 
    LCM_Module_Init();
    LCM_Module_ReportUserDataStatus(ud_st);
    EventLog_LcmConfig(LCM_Module_GetI2cAddr(),
                       LCM_Module_GetGroupMasks(),
                       LCM_Module_GetRelayState());
 
    LCM_IwdgInit();
    EventLog_PushSystem(2U);
    EventLog_Process();
 
    while (1) {
        LCM_Module_Poll();
        EventLog_Process();
        IWDG_ReloadCounter();
    }
}