Battery.h

Go to the documentation of this file.

/************************************************
*
*  CROSSCONTROL AUX API
*
*  Battery.h
*
*  Version 2.7.2.0, 2014-08-25
*
*  (c) maximatecc 2013
*
*  File description: 
*  External battery status and settings (Only available on specific models)
*
*  Use the function GetBattery() to get a handle to pass on to the other functions. 
*  Use the method Battery_release(BATTERYHANDLE) to return the handle.
*
*  Example Usage:
*  @include battery_example.cpp
*
************************************************/

#ifndef CC_BATTERY_H_
#define CC_BATTERY_H_

#include "CCAuxErrors.h"
#include "CCPlatform.h"

#ifdef __cplusplus
namespace CrossControl {
#endif

  /*
   * Diagnostic timer data
   */
  struct BatteryTimerType
  {
    unsigned long TotRunTimeMain;    
    unsigned long TotRunTimeBattery; 
    unsigned long RunTime_m20;       
    unsigned long RunTime_m20_0;     
    unsigned long RunTime_0_40;      
    unsigned long RunTime_40_60;     
    unsigned long RunTime_60_70;     
    unsigned long RunTime_70_80;     
    unsigned long RunTime_Above80;   
  };

  typedef enum
  {
    ChargingStatus_NoCharge     = 0, 
    ChargingStatus_Charging     = 1, 
    ChargingStatus_FullyCharged = 2, 
    ChargingStatus_TempLow      = 3, 
    ChargingStatus_TempHigh     = 4, 
    ChargingStatus_Unknown      = 5  
  } ChargingStatus;

  typedef enum
  {
    PowerSource_Battery = 0,
    PowerSource_ExternalPower = 1
  } PowerSource;

  typedef enum
  {
    ErrorStatus_NoError = 0,
    ErrorStatus_ThermistorTempSensor = 1,
    ErrorStatus_SecondaryTempSensor = 2,
    ErrorStatus_ChargeFail = 3,
    ErrorStatus_Overcurrent = 4,
    ErrorStatus_Init = 5
  } ErrorStatus;

  typedef void* BATTERYHANDLE;

  EXTERN_C
    CCAUXDLL_API
    BATTERYHANDLE
    CCAUXDLL_CALLING_CONV
    GetBattery(void);

  EXTERN_C
    CCAUXDLL_API
    void
    CCAUXDLL_CALLING_CONV
    Battery_release(BATTERYHANDLE);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_isBatteryPresent (BATTERYHANDLE, bool* batteryIsPresent);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getBatteryVoltageStatus (BATTERYHANDLE, unsigned char* batteryVoltagePercent);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getBatteryChargingStatus (BATTERYHANDLE, ChargingStatus* status);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getPowerSource (BATTERYHANDLE, PowerSource* status);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getBatteryTemp (BATTERYHANDLE, signed short* temperature);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getHwErrorStatus (BATTERYHANDLE, ErrorStatus* errorCode);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getTimer (BATTERYHANDLE, BatteryTimerType* times);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getMinMaxTemp (BATTERYHANDLE, signed short* minTemp, signed short* maxTemp);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getBatteryHWversion (BATTERYHANDLE, char* buff, int len);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getBatterySwVersion (
                                                     BATTERYHANDLE, 
                                                     unsigned short* major,
                                                     unsigned short* minor,
                                                     unsigned short* release,
                                                     unsigned short* build);

  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    Battery_getBatterySerial (BATTERYHANDLE, char* buff, int len);


#ifdef __cplusplus
} /* namespace CrossControl */
#endif

#endif /* CC_BATTERY_H_ */