#ifndef PLSR_HAL_F407_H
#define PLSR_HAL_F407_H

#include "plsr_types.h"
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

#define PLSR_HW_AXIS_COUNT           (PLSR_AXIS_COUNT)
#define PLSR_HW_DIR_POINT_NONE       (0xFFU)

typedef enum
{
    PLSR_HW_STATE_IDLE = 0,
    PLSR_HW_STATE_DIR_SETTLING,     /* DIR 已置位，等待方向建立延时 */
    PLSR_HW_STATE_PWM_PENDING,      /* 延时已到，等待首个非零频率启动 PWM */
    PLSR_HW_STATE_RUNNING,          /* PWM 输出中，更新中断计数 */
    PLSR_HW_STATE_DONE
} PLSR_HW_STATE;

typedef struct
{
    uint32_t frequencyHz;           /* 初始频率（起始速度，可为 0） */
    int64_t targetPulses;           /* 本段目标脉冲数 */
    uint8_t directionPoint;         /* DIR 输出点（Y 点号，0xFF=无） */
    uint8_t directionPositive;
    uint16_t directionDelayMs;
} PLSR_HW_START_PARAMS;

PLSR_RESULT PlsrHwInit(void);

PLSR_RESULT PlsrHwStartPulse(uint8_t axis, const PLSR_HW_START_PARAMS *params);
PLSR_RESULT PlsrHwSetFrequency(uint8_t axis, uint32_t frequencyHz);
PLSR_RESULT PlsrHwStopPulse(uint8_t axis);
uint8_t PlsrHwIsPulseActive(uint8_t axis);
PLSR_HW_STATE PlsrHwGetState(uint8_t axis);
uint32_t PlsrHwGetTimerClockHz(uint8_t axis);

/* 每 1ms tick 推进 HAL 状态机（DIR 延时等）。 */
void PlsrHwTick(uint8_t axis);

/* 输出定时器更新中断入口（生产由 IRQHandler 调用，host 由测试调用）。 */
void PlsrHwOnTimerUpdate(uint8_t axis);

/* 输出点（Y0~Y20）引脚映射表：DIR 点解析用。 */
uint8_t PlsrHwResolveDirectionPoint(uint8_t pointNumber);

#ifdef PLSR_HOST_TEST
/* 模拟寄存器访问与中断触发（测试用）。 */
uint32_t PlsrHwTestGetArr(uint8_t axis);
uint32_t PlsrHwTestGetCcr(uint8_t axis);
uint32_t PlsrHwTestGetPsc(uint8_t axis);
uint8_t PlsrHwTestGetPwmEnabled(uint8_t axis);
uint8_t PlsrHwTestGetDirLevel(uint8_t axis);
void PlsrHwTestTriggerUpdate(uint8_t axis);
#endif

#ifdef __cplusplus
}
#endif

#endif /* PLSR_HAL_F407_H */