max17042_battery.h 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  1. /*
  2. * Fuel gauge driver for Maxim 17042 / 8966 / 8997
  3. * Note that Maxim 8966 and 8997 are mfd and this is its subdevice.
  4. *
  5. * Copyright (C) 2011 Samsung Electronics
  6. * MyungJoo Ham <myungjoo.ham@samsung.com>
  7. *
  8. * This program is free software; you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License as published by
  10. * the Free Software Foundation; either version 2 of the License, or
  11. * (at your option) any later version.
  12. *
  13. * This program is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License
  19. * along with this program; if not, write to the Free Software
  20. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  21. */
  22. #ifndef __MAX17042_BATTERY_H_
  23. #define __MAX17042_BATTERY_H_
  24. #define MAX17042_STATUS_BattAbsent (1 << 3)
  25. #define MAX17042_BATTERY_FULL (100)
  26. #define MAX17042_DEFAULT_SNS_RESISTOR (10000)
  27. enum max17042_register {
  28. MAX17042_STATUS = 0x00,
  29. MAX17042_VALRT_Th = 0x01,
  30. MAX17042_TALRT_Th = 0x02,
  31. MAX17042_SALRT_Th = 0x03,
  32. MAX17042_AtRate = 0x04,
  33. MAX17042_RepCap = 0x05,
  34. MAX17042_RepSOC = 0x06,
  35. MAX17042_Age = 0x07,
  36. MAX17042_TEMP = 0x08,
  37. MAX17042_VCELL = 0x09,
  38. MAX17042_Current = 0x0A,
  39. MAX17042_AvgCurrent = 0x0B,
  40. MAX17042_SOC = 0x0D,
  41. MAX17042_AvSOC = 0x0E,
  42. MAX17042_RemCap = 0x0F,
  43. MAX17042_FullCAP = 0x10,
  44. MAX17042_TTE = 0x11,
  45. MAX17042_V_empty = 0x12,
  46. MAX17042_RSLOW = 0x14,
  47. MAX17042_AvgTA = 0x16,
  48. MAX17042_Cycles = 0x17,
  49. MAX17042_DesignCap = 0x18,
  50. MAX17042_AvgVCELL = 0x19,
  51. MAX17042_MinMaxTemp = 0x1A,
  52. MAX17042_MinMaxVolt = 0x1B,
  53. MAX17042_MinMaxCurr = 0x1C,
  54. MAX17042_CONFIG = 0x1D,
  55. MAX17042_ICHGTerm = 0x1E,
  56. MAX17042_AvCap = 0x1F,
  57. MAX17042_ManName = 0x20,
  58. MAX17042_DevName = 0x21,
  59. MAX17042_FullCAPNom = 0x23,
  60. MAX17042_TempNom = 0x24,
  61. MAX17042_TempLim = 0x25,
  62. MAX17042_TempHot = 0x26,
  63. MAX17042_AIN = 0x27,
  64. MAX17042_LearnCFG = 0x28,
  65. MAX17042_FilterCFG = 0x29,
  66. MAX17042_RelaxCFG = 0x2A,
  67. MAX17042_MiscCFG = 0x2B,
  68. MAX17042_TGAIN = 0x2C,
  69. MAx17042_TOFF = 0x2D,
  70. MAX17042_CGAIN = 0x2E,
  71. MAX17042_COFF = 0x2F,
  72. MAX17042_MaskSOC = 0x32,
  73. MAX17042_SOC_empty = 0x33,
  74. MAX17042_T_empty = 0x34,
  75. MAX17042_FullCAP0 = 0x35,
  76. MAX17042_LAvg_empty = 0x36,
  77. MAX17042_FCTC = 0x37,
  78. MAX17042_RCOMP0 = 0x38,
  79. MAX17042_TempCo = 0x39,
  80. MAX17042_EmptyTempCo = 0x3A,
  81. MAX17042_K_empty0 = 0x3B,
  82. MAX17042_TaskPeriod = 0x3C,
  83. MAX17042_FSTAT = 0x3D,
  84. MAX17042_SHDNTIMER = 0x3F,
  85. MAX17042_dQacc = 0x45,
  86. MAX17042_dPacc = 0x46,
  87. MAX17042_VFSOC0 = 0x48,
  88. MAX17042_QH = 0x4D,
  89. MAX17042_QL = 0x4E,
  90. MAX17042_VFSOC0Enable = 0x60,
  91. MAX17042_MLOCKReg1 = 0x62,
  92. MAX17042_MLOCKReg2 = 0x63,
  93. MAX17042_MODELChrTbl = 0x80,
  94. MAX17042_OCV = 0xEE,
  95. MAX17042_OCVInternal = 0xFB,
  96. MAX17042_VFSOC = 0xFF,
  97. };
  98. /*
  99. * used for setting a register to a desired value
  100. * addr : address for a register
  101. * data : setting value for the register
  102. */
  103. struct max17042_reg_data {
  104. u8 addr;
  105. u16 data;
  106. };
  107. struct max17042_platform_data {
  108. struct max17042_reg_data *init_data;
  109. int num_init_data; /* Number of enties in init_data array */
  110. bool enable_current_sense;
  111. /*
  112. * R_sns in micro-ohms.
  113. * default 10000 (if r_sns = 0) as it is the recommended value by
  114. * the datasheet although it can be changed by board designers.
  115. */
  116. unsigned int r_sns;
  117. };
  118. #endif /* __MAX17042_BATTERY_H_ */