/**
 * @file hal_device_info.h
 * @brief 设备信息 HAL 接口
 */

#ifndef HAL_DEVICE_INFO_H
#define HAL_DEVICE_INFO_H

#include <stdint.h>
#include <stddef.h>
#include <stdbool.h>

#ifdef __cplusplus
extern "C" {
#endif

/**
 * @brief 获取 MAC 地址字符串（格式 "AA:BB:CC:DD:EE:FF"）
 * @param buf  输出缓冲区
 * @param size 缓冲区大小（至少 18 字节）
 * @return 0 成功，负值失败
 */
int hal_device_get_uuid(char *buf, size_t size);

/**
 * @brief 获取设备唯一标识
 * @return 0 成功，负值失败
 */
int hal_device_get_device_id(char *buf, size_t size);

/** @brief 获取固件版本字符串（静态字符串）*/
const char *hal_device_get_firmware_version(void);

#ifdef __cplusplus
}
#endif

#endif /* HAL_DEVICE_INFO_H */
