using RobotNet10.Shared.Sensor;

namespace RobotNet10.RobotApp.Devices;

/// <summary>
/// Interface cho thiết bị Battery (Battery Management System) trong robot AGV
/// Cung cấp thông tin battery theo chuẩn ROS sensor_msgs/BatteryState
/// </summary>
public interface IBattery
{
    /// <summary>
    /// Battery state hiện tại được cache (thread-safe)
    /// </summary>
    BatteryState? CurrentBatteryState { get; }

    /// <summary>
    /// Đọc battery state từ thiết bị
    /// </summary>
    Task<BatteryState> ReadBatteryStateAsync(CancellationToken cancellationToken = default);
}