pac1921  2.0.0.0
pac1921.h
Go to the documentation of this file.
1 /*
2  * MikroSDK - MikroE Software Development Kit
3  * Copyright© 2020 MikroElektronika d.o.o.
4  *
5  * Permission is hereby granted, free of charge, to any person
6  * obtaining a copy of this software and associated documentation
7  * files (the "Software"), to deal in the Software without restriction,
8  * including without limitation the rights to use, copy, modify, merge,
9  * publish, distribute, sublicense, and/or sell copies of the Software,
10  * and to permit persons to whom the Software is furnished to do so,
11  * subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be
14  * included in all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
19  * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
20  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
22  * OR OTHER DEALINGS IN THE SOFTWARE.
23  */
32 // ----------------------------------------------------------------------------
33 
34 #ifndef PAC1921_H
35 #define PAC1921_H
36 
37 #include "drv_digital_out.h"
38 #include "drv_digital_in.h"
39 #include "drv_i2c_master.h"
40 
41 // -------------------------------------------------------------- PUBLIC MACROS
51 #define PAC1921_MAP_MIKROBUS( cfg, mikrobus ) \
52  cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
53  cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
54  cfg.an = MIKROBUS( mikrobus, MIKROBUS_AN ); \
55  cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
56 
62 #define PAC1921_RETVAL uint8_t
63 
64 #define PAC1921_OK 0x00
65 #define PAC1921_INIT_ERROR 0xFF
66 
72 #define PAC1921_SLAVE_ADDRESS 0x4C
73 
79 #define PAC1921_GAIN_CFG_REG 0x00
80 #define PAC1921_INTEGRATION_CFG_REG 0x01
81 #define PAC1921_CONTROL_REG 0x02
82 #define PAC1921_VBUS_RESULT_HIGH 0x10
83 #define PAC1921_VBUS_RESULT_LOW 0x11
84 #define PAC1921_VSENSE_RESULT_HIGH 0x12
85 #define PAC1921_VSENSE_RESULT_LOW 0x13
86 #define PAC1921_VSUM_ACCUMULATOR_HIGH 0x14
87 #define PAC1921_VSUM_ACCUMULATOR_MID_H 0x15
88 #define PAC1921_VSUM_ACCUMULATOR_MID_L 0x16
89 #define PAC1921_VSUM_ACCUMULATOR_LOW 0x17
90 #define PAC1921_ISUM_ACCUMULATOR_HIGH 0x18
91 #define PAC1921_ISUM_ACCUMULATOR_MID_H 0x19
92 #define PAC1921_ISUM_ACCUMULATOR_MID_L 0x1A
93 #define PAC1921_ISUM_ACCUMULATOR_LOW 0x1B
94 #define PAC1921_OVERFLOW_STATUS 0x1C
95 #define PAC1921_VPOWER_RESULT_HIGH 0x1D
96 #define PAC1921_VPOWER_RESULT_LOW 0x1E
97 #define PAC1921_SAMPLES_HIGH 0x21
98 #define PAC1921_SAMPLES_LOW 0x22
99 #define PAC1921_PSUM_ACCUMULATOR_HIGH 0x23
100 #define PAC1921_PSUM_ACCUMULATOR_MID_H 0x24
101 #define PAC1921_PSUM_ACCUMULATOR_MID_M 0x25
102 #define PAC1921_PSUM_ACCUMULATOR_MID_L 0x26
103 #define PAC1921_PSUM_ACCUMULATOR_LOW 0x27
104 #define PAC1921_PRODUCT_ID 0xFD
105 #define PAC1921_MANUFACTURER_ID 0xFE
106 #define PAC1921_REVISION 0xFF
107 
113 #define PAC1921_I_RESOLUTION_11_BIT 0x80
114 #define PAC1921_I_RESOLUTION_14_BIT 0x00
115 #define PAC1921_V_RESOLUTION_11_BIT 0x40
116 #define PAC1921_V_RESOLUTION_14_BIT 0x00
117 #define PAC1921_DIGITAL_I_GAIN_1X 0x00
118 #define PAC1921_DIGITAL_I_GAIN_2X 0x08
119 #define PAC1921_DIGITAL_I_GAIN_4X 0x10
120 #define PAC1921_DIGITAL_I_GAIN_8X 0x18
121 #define PAC1921_DIGITAL_I_GAIN_16X 0x20
122 #define PAC1921_DIGITAL_I_GAIN_32X 0x28
123 #define PAC1921_DIGITAL_I_GAIN_64X 0x30
124 #define PAC1921_DIGITAL_I_GAIN_128X 0x38
125 #define PAC1921_DIGITAL_V_GAIN_1X 0x00
126 #define PAC1921_DIGITAL_V_GAIN_2X 0x01
127 #define PAC1921_DIGITAL_V_GAIN_4X 0x02
128 #define PAC1921_DIGITAL_V_GAIN_8X 0x03
129 #define PAC1921_DIGITAL_V_GAIN_16X 0x04
130 #define PAC1921_DIGITAL_V_GAIN_32X 0x05
131 #define PAC1921_DIGITAL_V_GAIN_64X 0x06
132 #define PAC1921_DIGITAL_V_GAIN_128X 0x07
133 
139 #define PAC1921_SAMPLE_RATE_1 0x00
140 #define PAC1921_SAMPLE_RATE_2 0x10
141 #define PAC1921_SAMPLE_RATE_4 0x20
142 #define PAC1921_SAMPLE_RATE_8 0x30
143 #define PAC1921_SAMPLE_RATE_16 0x40
144 #define PAC1921_SAMPLE_RATE_32 0x50
145 #define PAC1921_SAMPLE_RATE_64 0x60
146 #define PAC1921_SAMPLE_RATE_128 0x70
147 #define PAC1921_SAMPLE_RATE_256 0x80
148 #define PAC1921_SAMPLE_RATE_512 0x90
149 #define PAC1921_SAMPLE_RATE_1024 0xA0
150 #define PAC1921_SAMPLE_RATE_2048 0xB0
151 #define PAC1921_V_SENSE_FILTER_ON 0x08
152 #define PAC1921_V_SENSE_FILTER_OFF 0x00
153 #define PAC1921_V_BUS_FILTER_ON 0x04
154 #define PAC1921_V_BUS_FILTER_OFF 0x00
155 #define PAC1921_READ_INT_OVERRIDE_ON 0x02
156 #define PAC1921_READ_INT_OVERRIDE_OFF 0x00
157 #define PAC1921_FORCED_INTEGRATE_MODE_ON 0x01
158 #define PAC1921_FORCED_INTEGRATE_MODE_OFF 0x00
159 
165 #define PAC1921_MEASUREMENT_MODE_V_POWER_PIN_CTRL 0x00
166 #define PAC1921_MEASUREMENT_MODE_V_SENSE_FREE_RUN 0x40
167 #define PAC1921_MEASUREMENT_MODE_V_BUS_FREE_RUN 0x80
168 #define PAC1921_MEASUREMENT_MODE_V_POWER_FREE_RUN 0xC0
169 #define PAC1921_OUT_PIN_FULL_SCALE_RANGE_3V 0x00
170 #define PAC1921_OUT_PIN_FULL_SCALE_RANGE_2V 0x10
171 #define PAC1921_OUT_PIN_FULL_SCALE_RANGE_1_5_V 0x20
172 #define PAC1921_OUT_PIN_FULL_SCALE_RANGE_1V 0x30
173 #define PAC1921_TIMEOUT_ON 0x08
174 #define PAC1921_TIMEOUT_OFF 0x00
175 #define PAC1921_SLEEP_ON 0x04
176 #define PAC1921_SLEEP_OFF 0x00
177 #define PAC1921_FORCED_READ_MODE_ON 0x02
178 #define PAC1921_FORCED_READ_MODE_OFF 0x00
179 #define PAC1921_FORCED_RECALCULATE_MODE_ON 0x01
180 #define PAC1921_FORCED_RECALCULATE_MODE_OFF 0x00
181 
187 #define PAC1921_VOLTAGE_MAX 10
188 #define PAC1921_CURRENT_MAX 32
189  // End group macro
192 // --------------------------------------------------------------- PUBLIC TYPES
201 typedef struct
202 {
203  uint8_t ctrl_byte;
204  uint8_t cfg_byte;
206  uint8_t sample_num_old;
207  uint8_t iarp;
208  uint16_t output_fsr;
209 
210 } aux_vars_t;
211 
215 typedef struct
216 {
217  uint8_t ctrl_byte;
218  uint8_t cfg_byte;
220  uint8_t sample_num_old;
221  uint8_t iarp;
222  uint16_t output_fsr;
223 
224 } aux_cfg_t;
225 
229 typedef struct
230 {
231  // Output pins
232 
233  digital_out_t int_pin;
234 
235  // Input pins
236 
237  digital_in_t an;
238 
239  // Modules
240 
241  i2c_master_t i2c;
242 
243  // ctx variable
244 
245  uint8_t slave_address;
247 
248 } pac1921_t;
249 
253 typedef struct
254 {
255  // Communication gpio pins
256 
257  pin_name_t scl;
258  pin_name_t sda;
259 
260  // Additional gpio pins
261 
262  pin_name_t an;
263  pin_name_t int_pin;
264 
265  // static variable
266 
267  uint32_t i2c_speed;
268  uint8_t i2c_address;
270 
271 } pac1921_cfg_t;
272  // End types group
274 // ----------------------------------------------- PUBLIC FUNCTION DECLARATIONS
275 
281 #ifdef __cplusplus
282 extern "C"{
283 #endif
284 
294 
304 
313 
324 void pac1921_generic_write ( pac1921_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len );
325 
337 void pac1921_generic_read ( pac1921_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len );
338 
350 void pac1921_write_to_reg ( pac1921_t *ctx, uint8_t reg_addr, uint8_t *write_data, uint8_t len );
351 
362 float pac1921_get_measured_data ( pac1921_t *ctx, uint8_t measurement_mode, uint8_t sample_num );
363 
372 void pac1921_set_int_pin ( pac1921_t *ctx, uint8_t output );
373 
381 uint8_t pac1921_get_an_pin ( pac1921_t *ctx );
382 
383 #ifdef __cplusplus
384 }
385 #endif
386 #endif // _PAC1921_H_
387  // End public_function group
390 
391 // ------------------------------------------------------------------------- END
aux_vars_t::measurement_mode_old
uint8_t measurement_mode_old
Definition: pac1921.h:205
pac1921_t::aux
aux_vars_t aux
Definition: pac1921.h:246
pac1921_t::slave_address
uint8_t slave_address
Definition: pac1921.h:245
pac1921_default_cfg
void pac1921_default_cfg(pac1921_t *ctx)
Click Default Configuration function.
PAC1921_RETVAL
#define PAC1921_RETVAL
Definition: pac1921.h:62
aux_cfg_t::cfg_byte
uint8_t cfg_byte
Definition: pac1921.h:218
pac1921_cfg_t::i2c_address
uint8_t i2c_address
Definition: pac1921.h:268
pac1921_get_an_pin
uint8_t pac1921_get_an_pin(pac1921_t *ctx)
AN pin get input function.
pac1921_t::i2c
i2c_master_t i2c
Definition: pac1921.h:241
aux_vars_t::sample_num_old
uint8_t sample_num_old
Definition: pac1921.h:206
aux_cfg_t::sample_num_old
uint8_t sample_num_old
Definition: pac1921.h:220
aux_cfg_t::ctrl_byte
uint8_t ctrl_byte
Definition: pac1921.h:217
pac1921_get_measured_data
float pac1921_get_measured_data(pac1921_t *ctx, uint8_t measurement_mode, uint8_t sample_num)
Measured data read function.
pac1921_generic_write
void pac1921_generic_write(pac1921_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic write function.
pac1921_cfg_t::i2c_speed
uint32_t i2c_speed
Definition: pac1921.h:267
aux_cfg_t
Auxiliary variables default cfg.
Definition: pac1921.h:216
pac1921_set_int_pin
void pac1921_set_int_pin(pac1921_t *ctx, uint8_t output)
INT pin set output function.
pac1921_cfg_t
Click configuration structure definition.
Definition: pac1921.h:254
pac1921_cfg_t::scl
pin_name_t scl
Definition: pac1921.h:257
pac1921_t::int_pin
digital_out_t int_pin
Definition: pac1921.h:233
pac1921_write_to_reg
void pac1921_write_to_reg(pac1921_t *ctx, uint8_t reg_addr, uint8_t *write_data, uint8_t len)
Register write function.
pac1921_cfg_t::an
pin_name_t an
Definition: pac1921.h:262
aux_vars_t::cfg_byte
uint8_t cfg_byte
Definition: pac1921.h:204
aux_vars_t
Auxiliary variables structure.
Definition: pac1921.h:202
aux_vars_t::output_fsr
uint16_t output_fsr
Definition: pac1921.h:208
aux_cfg_t::iarp
uint8_t iarp
Definition: pac1921.h:221
pac1921_cfg_setup
void pac1921_cfg_setup(pac1921_cfg_t *cfg)
Config Object Initialization function.
pac1921_cfg_t::int_pin
pin_name_t int_pin
Definition: pac1921.h:263
pac1921_generic_read
void pac1921_generic_read(pac1921_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic read function.
pac1921_init
PAC1921_RETVAL pac1921_init(pac1921_t *ctx, pac1921_cfg_t *cfg)
Initialization function.
pac1921_cfg_t::sda
pin_name_t sda
Definition: pac1921.h:258
pac1921_t
Click ctx object definition.
Definition: pac1921.h:230
aux_vars_t::iarp
uint8_t iarp
Definition: pac1921.h:207
aux_vars_t::ctrl_byte
uint8_t ctrl_byte
Definition: pac1921.h:203
pac1921_cfg_t::aux_cfg
aux_cfg_t aux_cfg
Definition: pac1921.h:269
aux_cfg_t::output_fsr
uint16_t output_fsr
Definition: pac1921.h:222
aux_cfg_t::measurement_mode_old
uint8_t measurement_mode_old
Definition: pac1921.h:219
pac1921_t::an
digital_in_t an
Definition: pac1921.h:237