lcm_led.c

Go to the documentation of this file.

/********************************** (C) COPYRIGHT *******************************
 * File Name          : lcm_led.c
 * Description        : Индикация LCM на PD4 (красный) и PC0 (зелёный).
 *
 *                      Активный уровень — 0 (светодиод горит при GPIO=0).
 *
 *                      Важно: из I2C ISR (WCH-Interrupt-fast) НЕЛЬЗЯ вызывать
 *                      __disable_irq()/__enable_irq() — они трогают биты
 *                      MIE и MPIE в mstatus одной маской (0x88). Если такой
 *                      вызов не сбалансирован явным __enable_irq() до выхода
 *                      из ISR, mret восстановит MIE = MPIE = 0, и глобальные
 *                      прерывания погаснут навсегда. Поэтому здесь — только
 *                      прямые атомарные записи в GPIO->BSHR/BCR и volatile
 *                      флаг (один писатель в ISR, один читатель в Poll).
 *********************************************************************************/
 
#include "lcm_led.h"
#include "debug.h"
#include "ch32v00x_conf.h"
 
#define LCM_LED_GREEN_MS          100U
#define LCM_LED_RED_MIN_MS        100U
 
#define LCM_LED_RED_PORT          GPIOD
#define LCM_LED_RED_PIN           GPIO_Pin_4
#define LCM_LED_GREEN_PORT        GPIOC
#define LCM_LED_GREEN_PIN         GPIO_Pin_0
 
/*
 * Сколько мс ещё держать зелёный; уменьшается в LCM_Led_Poll().
 * Задержки — через Delay_Ms() (debug.c, аппаратный SysTick, откалиброван
 * по SystemCoreClock). Самодельный цикл NOP использовался раньше и мог
 * давать неточный интервал (компилятор/wait-states флеша), из-за чего
 * зелёный не гас через заявленные 100 мс.
 */
static volatile uint16_t s_green_ms_left;
 
/*
 * Минимальная видимая длительность красного индикатора ошибки.
 * Без этого: если GET_ERROR приходит сразу после команды с ошибкой,
 * ErrorOn()/ErrorOff() происходят почти одновременно и вспышка не видна.
 * ErrorOn() всегда (пере)запускает таймер s_red_ms_left; ErrorOff() гасит
 * светодиод немедленно, только если таймер уже истёк, иначе выставляет
 * s_red_off_pending — реальное гашение довершит LCM_Led_Poll().
 */
static volatile uint16_t s_red_ms_left;
static volatile uint8_t s_red_off_pending;
 
static void LCM_Led_RedSet(uint8_t on)
{
    if (on != 0U) {
        LCM_LED_RED_PORT->BCR = LCM_LED_RED_PIN;
    } else {
        LCM_LED_RED_PORT->BSHR = LCM_LED_RED_PIN;
    }
}
 
static void LCM_Led_GreenSet(uint8_t on)
{
    if (on != 0U) {
        LCM_LED_GREEN_PORT->BCR = LCM_LED_GREEN_PIN;
    } else {
        LCM_LED_GREEN_PORT->BSHR = LCM_LED_GREEN_PIN;
    }
}
 
static void LCM_Led_ConfigPins(void)
{
    GPIO_InitTypeDef gpio = {0};
 
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC | RCC_APB2Periph_GPIOD, ENABLE);
 
    gpio.GPIO_Speed = GPIO_Speed_30MHz;
    gpio.GPIO_Mode = GPIO_Mode_Out_PP;
 
    gpio.GPIO_Pin = LCM_LED_GREEN_PIN;
    GPIO_Init(LCM_LED_GREEN_PORT, &gpio);
 
    gpio.GPIO_Pin = LCM_LED_RED_PIN;
    GPIO_Init(LCM_LED_RED_PORT, &gpio);
}
 
void LCM_Led_Init(void)
{
    LCM_Led_ConfigPins();
    LCM_Led_RedSet(0U);
    LCM_Led_GreenSet(0U);
    s_green_ms_left = 0U;
    s_red_ms_left = 0U;
    s_red_off_pending = 0U;
}
 
void LCM_Led_ErrorOn(void)
{
    LCM_Led_RedSet(1U);
    s_red_ms_left = LCM_LED_RED_MIN_MS;
    s_red_off_pending = 0U;
}
 
void LCM_Led_ErrorOff(void)
{
    if (s_red_ms_left == 0U) {
        LCM_Led_RedSet(0U);
    } else {
        /* Минимальное время показа не истекло — гашение довершит Poll(). */
        s_red_off_pending = 1U;
    }
}
 
void LCM_Led_ActivityPulse(void)
{
    LCM_Led_GreenSet(1U);
    s_green_ms_left = LCM_LED_GREEN_MS;
}
 
void LCM_Led_Poll(void)
{
    if (s_green_ms_left == 0U && s_red_ms_left == 0U) {
        return;
    }
 
    /* 1 мс за итерацию main (аппаратный SysTick) — не трогает IRQ */
    Delay_Ms(1U);
 
    if (s_green_ms_left != 0U) {
        s_green_ms_left--;
        if (s_green_ms_left == 0U) {
            LCM_Led_GreenSet(0U);
        }
    }
 
    if (s_red_ms_left != 0U) {
        s_red_ms_left--;
        if (s_red_ms_left == 0U && s_red_off_pending != 0U) {
            LCM_Led_RedSet(0U);
            s_red_off_pending = 0U;
        }
    }
}