/**
 * @file esc_exmc_bus.h
 * @brief LAN9252 ESC 的 EXMC 16-bit 并行总线抽象接口。
 * @note 通过 EXMC NOR/SRAM Region1(NE1,基址 0x60000000)以内存映射方式访问 LAN9252。
 *       16-bit 数据总线 + A16 地址线 + NOE/NWE/NE1 控制线。
 */
#ifndef COMM_ESC_EXMC_BUS_H
#define COMM_ESC_EXMC_BUS_H

#include <cstdint>
#include <cstddef>

/**
 * @brief LAN9252 ESC 的 EXMC 并行总线驱动。
 * @note 提供 16-bit 读写与块读写接口,内部通过内存映射地址直接访问 ESC 寄存器空间。
 */
class EscExmcBus {
public:
    /** @brief 初始化 EXMC NOR/SRAM Region1 与全部 GPIO(AF 复用)。 */
    static void init();

    /** @brief ISR-only:仅供 preempt=0 调用,无锁。 */
    static uint16_t read16(uint32_t offset);

    /** @brief ISR-only:仅供 preempt=0 调用,无锁。 */
    static void write16(uint32_t offset, uint16_t data);
};

#endif /* COMM_ESC_EXMC_BUS_H */