/******************************************************************************
 * @file    board_pin.h
 * @brief   CBR3 温湿度风扇板级引脚、电平与时序（换板只改本文件）
 * @author  cyWu <1917507415@qq.com>
 * @date    2026.09.04
 * @version V1.1.0，数码管转机 180°（BOARD_DISP_ROTATE_180）
 * @history
 * - V1.1.0, 2026.09.04, cyWu, 转机后温湿窗口/十个位对调 + 段码旋转
 * - V1.0.0, 2026.08.29, cyWu, 首次发布（P0 Bring-up）
 *
 * @note    产品 GPIO 全部集中到本文件；板级 board_jl701n_demo_cfg.h 只保留
 *          UART0_TX=PG6 一项改动。CT1642 用 PG0(CLK)/PG1(DATA)，AHT20 用
 *          PC4(SCL)/PC5(SDA)，两路 IO 独立、无总线共享（2026-08-29 改板飞线分离，
 *          原 PC4/PC5 共线 + bsp_bus 分时机制整体删除）。
 ******************************************************************************/

#ifndef __BOARD_PIN_H__
#define __BOARD_PIN_H__

#include "asm/gpio.h"

/*============================================================================*/
/* 功能开关：某路硬件异常时可单独关掉，不影响配网                             */
/*  0 时对应模块 init/run 直接 return，GPIO 不配，日志打一次 xxx disabled      */
/*============================================================================*/

#define BOARD_LED_ENABLE          1             /**< 1=状态 LED PC2（低亮） */
#define BOARD_KEY_ENABLE          1             /**< 1=按键 PB1（低按下） */
#define BOARD_FAN_ENABLE          1             /**< 1=风扇 MCPWM PC3（高导通） */
#define BOARD_DISP_ENABLE         1             /**< 1=CT1642 数码管（PG0/PG1 独立） */
#define BOARD_TH_ENABLE           1             /**< 1=AHT20 温湿度（PC4/PC5 独立） */
#define BOARD_MODE_ENABLE         1             /* 通风/强力状态机；P1 开 */
#define BOARD_LINKAGE_ENABLE      1             /* 联动引擎（替换原 7 组条件）；P2 开 */
#define BOARD_TIMER_ENABLE        1             /* 定时引擎；P2 开 */
#define BOARD_RUNREC_ENABLE       1             /* 31 天运行记录；P2 开 */
#define BOARD_NVM_ENABLE          1             /* VM 持久化；P1 开 */

/*============================================================================*/
/* GPIO                                                                       */
/*============================================================================*/

#define BOARD_UART_TX_PIN         IO_PORTG_06   /**< 调试 UART TX（只发不占 PC5） */
#define BOARD_DISP_CLK_PIN        IO_PORTG_00   /**< CT1642 CLK（独立，飞线 G0） */
#define BOARD_DISP_DATA_PIN       IO_PORTG_01   /**< CT1642 DATA（独立，飞线 G1） */
#define BOARD_TH_SCL_PIN          IO_PORTC_04   /**< AHT20 SCLK（独立，推挽驱动） */
#define BOARD_TH_SDA_PIN          IO_PORTC_05   /**< AHT20 SDA（开漏+内部上拉，外部 4.7~10k 双保险） */
#define BOARD_FAN_PIN             IO_PORTC_03   /**< 风扇 PWM，高电平导通，MCPWM */
#define BOARD_LED_PIN             IO_PORTC_02   /**< 状态 LED，低电平亮 */
#define BOARD_KEY_PIN             IO_PORTB_01   /**< 按键，低电平按下 */

#define BOARD_LED_ON_LEVEL        0             /**< LED 点亮电平：0=低亮 */
#define BOARD_FAN_ON_LEVEL        1             /**< 风扇有效电平：1=高导通 */
#define BOARD_KEY_ACTIVE_LEVEL    0             /**< 按键有效电平：0=按下为低 */

/*============================================================================*/
/* 按键 / 开机                                                               */
/*============================================================================*/

/**
 * 直接作为 key.c 状态机的 keyLongTime/keyLastTime 使用：
 *   松手时刻 <BOARD_KEY_PAIR_MS   → SHORT_Event，切档（见 5.3）
 *   按住满 BOARD_KEY_PAIR_MS      → LONG_Event（仍按住），切配对提示灯
 *   按住满 BOARD_KEY_OTA_MS       → LAST_Event（仍按住，到点即触发），进 OTA
 *   按满 5s~12s 后松手            → RELEASE_Event，提交配对
 */
#define BOARD_KEY_PAIR_MS         5000          /**< keyLongTime：满 5s 挂配对提示灯 */
#define BOARD_KEY_OTA_MS          12000         /**< keyLastTime：满 12s 到点直接进 OTA */
#define BOARD_KEY_DEBOUNCE_MS     20            /**< 按键消抖 */
#define BOARD_PAIR_TIMEOUT_MS     (120u * 1000u) /**< 配对超时 120s，失败后保持开机 */

/*============================================================================*/
/* LED（单灯 PC2，事件表见 led_manager.c）                                   */
/*============================================================================*/

#define BOARD_LED_FAST_ON_MS      100           /**< 配对快闪：亮 */
#define BOARD_LED_FAST_OFF_MS     100           /**< 配对快闪：灭 */
#define BOARD_LED_OTA_ON_MS       200           /**< OTA 闪：亮 */
#define BOARD_LED_OTA_OFF_MS      200           /**< OTA 闪：灭 */
#define BOARD_LED_PAIR_OK_MS      3000          /**< 配对成功常亮时长（允许直接常亮） */
#define BOARD_LED_PAIR_FAIL_MS    3000          /**< 配对失败 200ms 闪提示时长 */
#define BOARD_LED_STANDBY_ON      1             /**< 1=开机常亮 */

/*============================================================================*/
/* 风扇 PWM                                                                   */
/*============================================================================*/

#define BOARD_FAN_PWM_HZ          20000         /**< MCPWM 频率(Hz)，20k 避开可听啸叫 */
#define BOARD_FAN_DUTY_GEAR0      0             /**< 0% */
#define BOARD_FAN_DUTY_GEAR1      5000          /**< 50%（用户拍板，2026-08-31） */
#define BOARD_FAN_DUTY_GEAR2      7500          /**< 75%（用户拍板，2026-08-31） */
#define BOARD_FAN_DUTY_GEAR3      10000         /**< 100% */

/*============================================================================*/
/* 显示（CT1642）                                                             */
/*============================================================================*/

/**
 * CT1642 动态扫描节拍(ms)。
 * ⚠ CT1642 内部只有单个 12 位锁存器（4 位选 + 8 段码），无按位显示 RAM、不自动扫描，
 *   一次只点亮当前锁存的那 1 位。必须 MCU 持续轮询 4 位才能 4 位同亮、不闪。
 *   本节拍每 BOARD_DISP_SCAN_MS 点亮 1 位、4 位轮询 → 每位 4*BOARD_DISP_SCAN_MS 一轮。
 *   4ms：每位 16ms/62.5Hz、25% 占空，均匀不闪，且不饿死 priority=1 扫描中断里的
 *       主循环喂狗（实测 2ms 节拍会导致上电硬复位，禁止）。
 *   注：SCAN_TEST=1 段扫描用"值变化才刷"机制，本节拍不敏感；正常显示(0)与
 *       位选验证(2)用分时轮询，必须 ≤4ms 否则肉眼可见闪烁。
 */
#define BOARD_DISP_SCAN_MS        4

#define BOARD_DISP_BLINK_MS       500           /**< 告警闪烁半周期（P1 用） */

/**
 * 告警闪烁调试宏（P1 台上验证用，正常固件保持 0）：
 *   0 = 关：闪烁由 app_disp_set_temp/humi_alarm 驱动（app_linkage 按 8.2 喂）
 *   1 = 强制温度管闪（模拟温度超 [min,max]）
 *   2 = 强制湿度管闪（模拟湿度超 [min,max]）
 */
#define BOARD_DISP_ALARM_TEST     0

/**
 * CT1642 协议（18bit/帧，CLK 上升沿采样，DATA 仅在 CLK=低时改变）：
 *   [0:3]   C1-C4 位选（低有效，入参 com 取反后先发 C1）
 *   [4:9]   6 位保留位（固定填 1）
 *   [10:17] Q2-Q9 段码（LSB 先，seg 的 bit0 → Q2 引脚）
 * 发完 18bit：CLK=高 时 DATA 0→1 = 锁存；CLK=低 时 DATA 0→1 = 输出刷新。
 * 刷新一位数码管 = 发一帧；4 位连发 4 帧（每帧仅一个 Cx 位选生效）。
 *
 * ⚠ P0 扫段：段码/位选与硬件物理映射为"待实测"值，台上用 SCAN_TEST 扫清后修正。
 *   seg_tbl 段码位定义：bit7=DP  bit6=G  bit5=F  bit4=E  bit3=D  bit2=C  bit1=B  bit0=A
 *   （bit0 先发 → 落到 Q2 引脚；PCB 上 Q2 接哪段即"软件 A 段"对应的物理段）
 *   COM 位选 → 物理管位映射（2026-08-29 SCAN_TEST=2 实测定型）：
 *   C1=湿度十位  C2=湿度个位  C3=温度十位  C4=温度个位（默认假定温/湿相反，已对调）
 *
 * 转机 180°（2026-09-04）：整板相对窗口旋转后，视觉上
 *   ① 每只管子倒过来：A↔D、B↔E、C↔F，G/DP 不动（段码在 bsp_ct1642_send_frame 里重映射）
 *   ② 温/湿窗口对调，且十位/个位左右对调。
 *   未改软件时典型现象：25/57 会看成「L5 / 52」（7 倒过来像 L）。
 *   0 = 旧板方向；1 = 转机后的量产方向。
 */
#define BOARD_DISP_ROTATE_180     1

#if BOARD_DISP_ROTATE_180
#define BOARD_DISP_COM_TEMP_TEN   0x02          /**< C2：转机后落到温度十位 */
#define BOARD_DISP_COM_TEMP_ONE   0x01          /**< C1：转机后落到温度个位 */
#define BOARD_DISP_COM_HUMI_TEN   0x08          /**< C4：转机后落到湿度十位 */
#define BOARD_DISP_COM_HUMI_ONE   0x04          /**< C3：转机后落到湿度个位 */
#else
#define BOARD_DISP_COM_TEMP_TEN   0x04          /**< C3 = 温度十位（实测定型） */
#define BOARD_DISP_COM_TEMP_ONE   0x08          /**< C4 = 温度个位（实测定型） */
#define BOARD_DISP_COM_HUMI_TEN   0x01          /**< C1 = 湿度十位（实测定型） */
#define BOARD_DISP_COM_HUMI_ONE   0x02          /**< C2 = 湿度个位（实测定型） */
#endif

/**
 * 扫段调试模式（P0 台上定型用，2026-08-29 已全部定型，正常固件保持 0）：
 *   0 = 正常：无采样时写死 25/60（分时轮询 + 提速移位）
 *   1 = 段扫描：4 位同显一段，值变化才刷（无鬼影）；段序已实测确认 A..G 顺序正确
 *   2 = 位扫描：4 位分显 1/2/3/4（分时轮询）；位序已实测确认 C1=湿十/C2=湿个/C3=温十/C4=温个
 */
#define BOARD_DISP_SCAN_TEST      0

/*============================================================================*/
/* 传感器（AHT20）                                                            */
/*============================================================================*/

#define BOARD_TH_PERIOD_MS        2000          /**< 采集周期 2s（手册要求 >1s，规格书第 2.3/18 章） */
#define BOARD_TH_FAIL_MAX         3             /**< 连续失败 3 次判传感器故障 */
#define BOARD_TH_HUMI_PUB_DELTA   2             /**< 对外湿度：相对上次 |ΔH|>=2% 才更新显示/上报 */
#define BOARD_TH_TEMP_PUB_DELTA_X10  5          /**< 对外温度：相对上次 |ΔT|>=0.5℃ 才更新显示/上报 */
#define BOARD_AHT20_WAIT_MS       80            /**< 测量等待时长 */
#define BOARD_AHT20_I2C_HZ        100000        /**< 软件 I2C 时钟 */

/*============================================================================*/
/* 模式（P1 起用，P0 关闭）                                                   */
/*============================================================================*/

#define BOARD_MODE_VENT_ON_MS     (25u * 60u * 1000u)  /**< 通风开段 25min */
#define BOARD_MODE_VENT_OFF_MS    (5u * 60u * 1000u)  /**< 通风停段 5min */
#define BOARD_MODE_POWER_ON_MS    (15u * 60u * 1000u)  /**< 强力一轮 15min */

/*============================================================================*/
/* 联动（第 10 章：1 条 20B 配置，回差开 1 档 / 关 0 档，不改 mode）           */
/*============================================================================*/

#define BOARD_LINKAGE_CFG_LEN     20            /**< DP6 linkage_config 长度(Byte) */
#define BOARD_LINKAGE_OPEN_GEAR   1             /**< 联动开风扇时写的档位（第 10.3 节） */

/*============================================================================*/
/* 运行记录（第 13.1 节：31 天 × uint32 秒）                                   */
/*============================================================================*/

#define BOARD_RUN_RECORD_DAYS     31            /**< 记录天数 */
#define BOARD_RUN_RECORD_SAVE_SEC 900           /**< 累计运行 15 分钟写一次 VM */

#endif /* __BOARD_PIN_H__ */