Joao Vieira
TLMoto
Diff: LTC68041.h
- Revision:
- 0:f6b9d13870f2
- Child:
- 1:c55c4c93681f
diff -r 000000000000 -r f6b9d13870f2 LTC68041.h
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/LTC68041.h Fri Sep 09 13:46:07 2016 +0000
@@ -0,0 +1,229 @@
+/*!
+LTC6804-1 Multicell Battery Monitor
+
+http://www.linear.com/product/LTC6804-1
+
+http://www.linear.com/product/LTC6804-1#demoboards
+
+REVISION HISTORY
+$Revision: 4432 $
+$Date: 2015-11-30 14:03:02 -0800 (Mon, 30 Nov 2015) $
+
+Copyright (c) 2013, Linear Technology Corp.(LTC)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+The views and conclusions contained in the software and documentation are those
+of the authors and should not be interpreted as representing official policies,
+either expressed or implied, of Linear Technology Corp.
+
+The Linear Technology Linduino is not affiliated with the official Arduino team.
+However, the Linduino is only possible because of the Arduino team's commitment
+to the open-source community. Please, visit http://www.arduino.cc and
+http://store.arduino.cc , and consider a purchase that will help fund their
+ongoing work.
+
+Copyright 2013 Linear Technology Corp. (LTC)
+***********************************************************/
+
+/*! @file
+ @ingroup LTC68041
+ Header for LTC6804-1 Multicell Battery Monitor
+*/
+
+#ifndef LTC68041_H
+#define LTC68041_H
+
+
+#ifndef LTC6804_CS
+#define LTC6804_CS spi_cs
+#endif
+
+
+/*
+ Pre computed crc15 table used for the LTC6804 PEC calculation
+
+ The code used to generate the crc15 table is:
+
+void generate_crc15_table()
+{
+ int remainder;
+ for(int i = 0; i<256;i++)
+ {
+ remainder = i<< 7;
+ for (int bit = 8; bit > 0; --bit)
+ {
+
+ if ((remainder & 0x4000) > 0)//equivalent to remainder & 2^14 simply check for MSB
+ {
+ remainder = ((remainder << 1)) ;
+ remainder = (remainder ^ 0x4599);
+ }
+ else
+ {
+ remainder = ((remainder << 1));
+ }
+ }
+
+ crc15Table[i] = remainder&0xFFFF;
+
+ }
+}
+*/
+
+static const unsigned int crc15Table[256] = {0x0,0xc599, 0xceab, 0xb32, 0xd8cf, 0x1d56, 0x1664, 0xd3fd, 0xf407, 0x319e, 0x3aac, //!<precomputed CRC15 Table
+ 0xff35, 0x2cc8, 0xe951, 0xe263, 0x27fa, 0xad97, 0x680e, 0x633c, 0xa6a5, 0x7558, 0xb0c1,
+ 0xbbf3, 0x7e6a, 0x5990, 0x9c09, 0x973b, 0x52a2, 0x815f, 0x44c6, 0x4ff4, 0x8a6d, 0x5b2e,
+ 0x9eb7, 0x9585, 0x501c, 0x83e1, 0x4678, 0x4d4a, 0x88d3, 0xaf29, 0x6ab0, 0x6182, 0xa41b,
+ 0x77e6, 0xb27f, 0xb94d, 0x7cd4, 0xf6b9, 0x3320, 0x3812, 0xfd8b, 0x2e76, 0xebef, 0xe0dd,
+ 0x2544, 0x2be, 0xc727, 0xcc15, 0x98c, 0xda71, 0x1fe8, 0x14da, 0xd143, 0xf3c5, 0x365c,
+ 0x3d6e, 0xf8f7,0x2b0a, 0xee93, 0xe5a1, 0x2038, 0x7c2, 0xc25b, 0xc969, 0xcf0, 0xdf0d,
+ 0x1a94, 0x11a6, 0xd43f, 0x5e52, 0x9bcb, 0x90f9, 0x5560, 0x869d, 0x4304, 0x4836, 0x8daf,
+ 0xaa55, 0x6fcc, 0x64fe, 0xa167, 0x729a, 0xb703, 0xbc31, 0x79a8, 0xa8eb, 0x6d72, 0x6640,
+ 0xa3d9, 0x7024, 0xb5bd, 0xbe8f, 0x7b16, 0x5cec, 0x9975, 0x9247, 0x57de, 0x8423, 0x41ba,
+ 0x4a88, 0x8f11, 0x57c, 0xc0e5, 0xcbd7, 0xe4e, 0xddb3, 0x182a, 0x1318, 0xd681, 0xf17b,
+ 0x34e2, 0x3fd0, 0xfa49, 0x29b4, 0xec2d, 0xe71f, 0x2286, 0xa213, 0x678a, 0x6cb8, 0xa921,
+ 0x7adc, 0xbf45, 0xb477, 0x71ee, 0x5614, 0x938d, 0x98bf, 0x5d26, 0x8edb, 0x4b42, 0x4070,
+ 0x85e9, 0xf84, 0xca1d, 0xc12f, 0x4b6, 0xd74b, 0x12d2, 0x19e0, 0xdc79, 0xfb83, 0x3e1a, 0x3528,
+ 0xf0b1, 0x234c, 0xe6d5, 0xede7, 0x287e, 0xf93d, 0x3ca4, 0x3796, 0xf20f, 0x21f2, 0xe46b, 0xef59,
+ 0x2ac0, 0xd3a, 0xc8a3, 0xc391, 0x608, 0xd5f5, 0x106c, 0x1b5e, 0xdec7, 0x54aa, 0x9133, 0x9a01,
+ 0x5f98, 0x8c65, 0x49fc, 0x42ce, 0x8757, 0xa0ad, 0x6534, 0x6e06, 0xab9f, 0x7862, 0xbdfb, 0xb6c9,
+ 0x7350, 0x51d6, 0x944f, 0x9f7d, 0x5ae4, 0x8919, 0x4c80, 0x47b2, 0x822b, 0xa5d1, 0x6048, 0x6b7a,
+ 0xaee3, 0x7d1e, 0xb887, 0xb3b5, 0x762c, 0xfc41, 0x39d8, 0x32ea, 0xf773, 0x248e, 0xe117, 0xea25,
+ 0x2fbc, 0x846, 0xcddf, 0xc6ed, 0x374, 0xd089, 0x1510, 0x1e22, 0xdbbb, 0xaf8, 0xcf61, 0xc453,
+ 0x1ca, 0xd237, 0x17ae, 0x1c9c, 0xd905, 0xfeff, 0x3b66, 0x3054, 0xf5cd, 0x2630, 0xe3a9, 0xe89b,
+ 0x2d02, 0xa76f, 0x62f6, 0x69c4, 0xac5d, 0x7fa0, 0xba39, 0xb10b, 0x7492, 0x5368, 0x96f1, 0x9dc3,
+ 0x585a, 0x8ba7, 0x4e3e, 0x450c, 0x8095
+ };
+
+
+
+/*!
+
+ |MD| Dec | ADC Conversion Model|
+ |--|------|---------------------|
+ |01| 1 | Fast |
+ |10| 2 | Normal |
+ |11| 3 | Filtered |
+*/
+#define MD_FAST 1
+#define MD_NORMAL 2
+#define MD_FILTERED 3
+
+
+/*!
+|CH | Dec | Channels to convert |
+|---|------|---------------------|
+|000| 0 | All Cells |
+|001| 1 | Cell 1 and Cell 7 |
+|010| 2 | Cell 2 and Cell 8 |
+|011| 3 | Cell 3 and Cell 9 |
+|100| 4 | Cell 4 and Cell 10 |
+|101| 5 | Cell 5 and Cell 11 |
+|110| 6 | Cell 6 and Cell 12 |
+*/
+
+#define CELL_CH_ALL 0
+#define CELL_CH_1and7 1
+#define CELL_CH_2and8 2
+#define CELL_CH_3and9 3
+#define CELL_CH_4and10 4
+#define CELL_CH_5and11 5
+#define CELL_CH_6and12 6
+
+
+/*!
+
+ |CHG | Dec |Channels to convert |
+ |----|------|----------------------|
+ |000 | 0 | All GPIOS and 2nd Ref|
+ |001 | 1 | GPIO 1 |
+ |010 | 2 | GPIO 2 |
+ |011 | 3 | GPIO 3 |
+ |100 | 4 | GPIO 4 |
+ |101 | 5 | GPIO 5 |
+ |110 | 6 | Vref2 |
+*/
+
+#define AUX_CH_ALL 0
+#define AUX_CH_GPIO1 1
+#define AUX_CH_GPIO2 2
+#define AUX_CH_GPIO3 3
+#define AUX_CH_GPIO4 4
+#define AUX_CH_GPIO5 5
+#define AUX_CH_VREF2 6
+
+//uint8_t CHG = 0; //!< aux channels to be converted
+/*!****************************************************
+ \brief Controls if Discharging transitors are enabled
+ or disabled during Cell conversions.
+
+|DCP | Discharge Permitted During conversion |
+|----|----------------------------------------|
+|0 | No - discharge is not permitted |
+|1 | Yes - discharge is permitted |
+
+********************************************************/
+#define DCP_DISABLED 0
+#define DCP_ENABLED 1
+
+
+
+
+void LTC6804_initialize();
+
+void set_adc(uint8_t MD, uint8_t DCP, uint8_t CH, uint8_t CHG);
+
+void LTC6804_adcv();
+
+void LTC6804_adax();
+
+uint8_t LTC6804_rdcv(uint8_t reg, uint8_t total_ic, uint16_t cell_codes[][12]);
+
+void LTC6804_rdcv_reg(uint8_t reg, uint8_t nIC, uint8_t *data);
+
+int8_t LTC6804_rdaux(uint8_t reg, uint8_t nIC, uint16_t aux_codes[][6]);
+
+void LTC6804_rdaux_reg(uint8_t reg, uint8_t nIC,uint8_t *data);
+
+void LTC6804_clrcell();
+
+void LTC6804_clraux();
+
+void LTC6804_wrcfg(uint8_t nIC,uint8_t config[][6]);
+
+int8_t LTC6804_rdcfg(uint8_t nIC, uint8_t r_config[][8]);
+
+void wakeup_idle();
+
+void wakeup_sleep();
+
+uint16_t pec15_calc(uint8_t len, uint8_t *data);
+
+void spi_write_array( uint8_t length, uint8_t *data);
+
+void spi_write_read(uint8_t *TxData, uint8_t TXlen, uint8_t *rx_data, uint8_t RXlen);
+void output_low(uint8_t pin);
+
+void output_high(uint8_t pin);
+
+#endif