loadcell6  2.0.0.0
loadcell6.h
Go to the documentation of this file.
1 /****************************************************************************
2 ** Copyright (C) 2020 MikroElektronika d.o.o.
3 ** Contact: https://www.mikroe.com/contact
4 **
5 ** Permission is hereby granted, free of charge, to any person obtaining a copy
6 ** of this software and associated documentation files (the "Software"), to deal
7 ** in the Software without restriction, including without limitation the rights
8 ** to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 ** copies of the Software, and to permit persons to whom the Software is
10 ** furnished to do so, subject to the following conditions:
11 ** The above copyright notice and this permission notice shall be
12 ** included in all copies or substantial portions of the Software.
13 **
14 ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15 ** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
16 ** OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 ** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
18 ** DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
19 ** OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
20 ** USE OR OTHER DEALINGS IN THE SOFTWARE.
21 ****************************************************************************/
22 
28 #ifndef LOADCELL6_H
29 #define LOADCELL6_H
30 
31 #ifdef __cplusplus
32 extern "C"{
33 #endif
34 
35 #include "mikrosdk_version.h"
36 
37 #ifdef __GNUC__
38 #if mikroSDK_GET_VERSION < 20800ul
39 #include "rcu_delays.h"
40 #else
41 #include "delays.h"
42 #endif
43 #endif
44 
45 #include "drv_digital_out.h"
46 #include "drv_digital_in.h"
47 #include "drv_spi_master.h"
48 #include "spi_specifics.h"
49 
50 /* REGISTERS */
51 
52 
53 
54 /* CMD BITS */
55 
56 
57 
58 
59 
60 
81 #define LOADCELL6_REG_STAT 0x00
82 #define LOADCELL6_REG_CTRL1 0x01
83 #define LOADCELL6_REG_CTRL2 0x02
84 #define LOADCELL6_REG_CTRL3 0x03
85 #define LOADCELL6_REG_CTRL4 0x04
86 #define LOADCELL6_REG_CTRL5 0x05
87 #define LOADCELL6_REG_DATA 0x06
88 #define LOADCELL6_REG_SOC_SPI 0x07
89 #define LOADCELL6_REG_SCG_SPI 0x08
90 #define LOADCELL6_REG_SCOC_SPI 0x09
91 #define LOADCELL6_REG_SCGC_SPI 0x0A
92 #define LOADCELL6_REG_RAM 0x0C
93 #define LOADCELL6_REG_SYNC_SPI 0x0D
94 #define LOADCELL6_REG_SOC_ADC 0x15
95 #define LOADCELL6_REG_SCG_ADC 0x16
96 #define LOADCELL6_REG_SCOC_ADC 0x17
97 #define LOADCELL6_REG_SCGC_ADC 0x18
98  // loadcell6_reg
100 
120 #define LOADCELL6_CMD_RATE0 0x01
121 #define LOADCELL6_CMD_RATE1 0x02
122 #define LOADCELL6_CMD_RATE2 0x04
123 #define LOADCELL6_CMD_RATE3 0x08
124 #define LOADCELL6_CMD_IMPD 0x10
125 #define LOADCELL6_CMD_CAL 0x20
126 #define LOADCELL6_CMD_START 0x80
127 #define LOADCELL6_CMD_REG_ACCESS_MODE 0x40
128 
133 #define LOADCELL6_STAT_RDY 0x0001
134 #define LOADCELL6_STAT_MSTAT 0x0002
135 #define LOADCELL6_STAT_DOR 0x0004
136 #define LOADCELL6_STAT_SYSGOR 0x0008
137 #define LOADCELL6_STAT_RATE0 0x0010
138 #define LOADCELL6_STAT_RATE1 0x0020
139 #define LOADCELL6_STAT_RATE2 0x0040
140 #define LOADCELL6_STAT_RATE3 0x0080
141 #define LOADCELL6_STAT_AOR 0x0100
142 #define LOADCELL6_STAT_RDERR 0x0200
143 #define LOADCELL6_STAT_PDSTAT0 0x0400
144 #define LOADCELL6_STAT_PDSTAT1 0x0800
145 #define LOADCELL6_STAT_ERROR 0x4000
146 #define LOADCELL6_STAT_INRESET 0x8000
147 
152 #define LOADCELL6_CTRL1_CONTSC 0x01
153 #define LOADCELL6_CTRL1_SCYCLE 0x02
154 #define LOADCELL6_CTRL1_FORMAT 0x04
155 #define LOADCELL6_CTRL1_U_B 0x08
156 #define LOADCELL6_CTRL1_PD0 0x10
157 #define LOADCELL6_CTRL1_PD1 0x20
158 #define LOADCELL6_CTRL1_SYNC 0x40
159 #define LOADCELL6_CTRL1_EXTCK 0x80
160 
165 #define LOADCELL6_CTRL2_PGAIN_x1 0x00
166 #define LOADCELL6_CTRL2_PGAIN_x2 0x01
167 #define LOADCELL6_CTRL2_PGAIN_x4 0x02
168 #define LOADCELL6_CTRL2_PGAIN_x8 0x03
169 #define LOADCELL6_CTRL2_PGAIN_x16 0x04
170 #define LOADCELL6_CTRL2_PGAIN_x32 0x05
171 #define LOADCELL6_CTRL2_PGAIN_x64 0x06
172 #define LOADCELL6_CTRL2_PGAIN_x128 0x07
173 #define LOADCELL6_CTRL2_PGAGEN 0x08
174 #define LOADCELL6_CTRL2_LPMODE 0x10
175 #define LOADCELL6_CTRL2_BUFEN 0x20
176 #define LOADCELL6_CTRL2_DGAIN_x1 0x00
177 #define LOADCELL6_CTRL2_DGAIN_x2 0x40
178 #define LOADCELL6_CTRL2_DGAIN_x4 0x80
179 #define LOADCELL6_CTRL2_DGAIN_x8 0xC0
180 #define LOADCELL6_CTRL2_DGAIN0 0x40
181 #define LOADCELL6_CTRL2_DGAIN1 0x80
182 
187 #define LOADCELL6_CTRL3_DATA32 0x08
188 #define LOADCELL6_CTRL3_MODBITS 0x10
189 #define LOADCELL6_CTRL3_ENMSYNC 0x20
190 #define LOADCELL6_CTRL3_RESERVED 0x41
191 
196 #define LOADCELL6_CTRL4_DIO1 0x01
197 #define LOADCELL6_CTRL4_DIO2 0x02
198 #define LOADCELL6_CTRL4_DIO3 0x04
199 #define LOADCELL6_CTRL4_DIO4 0x08
200 #define LOADCELL6_CTRL4_DIR1 0x10
201 #define LOADCELL6_CTRL4_DIR2 0x20
202 #define LOADCELL6_CTRL4_DIR3 0x40
203 #define LOADCELL6_CTRL4_DIR4 0x80
204 
209 #define LOADCELL6_CTRL5_NOSCO 0x01
210 #define LOADCELL6_CTRL5_NOSCG 0x02
211 #define LOADCELL6_CTRL5_NOSYSO 0x04
212 #define LOADCELL6_CTRL5_NOSYSG 0x08
213 #define LOADCELL6_CTRL5_CAL0 0x40
214 #define LOADCELL6_CTRL5_CAL1 0x80
215 
216 
221 #define LOADCELL6_DATA_NO_DATA 0
222 #define LOADCELL6_DATA_OK 1
223 #define LOADCELL6_WEIGHT_ZERO 0
224 #define LOADCELL6_WEIGHT_100G 100
225 #define LOADCELL6_WEIGHT_200G 200
226 #define LOADCELL6_WEIGHT_500G 500
227 #define LOADCELL6_WEIGHT_1000G 1000
228 #define LOADCELL6_WEIGHT_5000G 5000
229 #define LOADCELL6_WEIGHT_10000G 10000
230 
239 #define LOADCELL6_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
240 #define LOADCELL6_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
241  // loadcell6_set
243 
258 #define LOADCELL6_MAP_MIKROBUS( cfg, mikrobus ) \
259  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
260  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
261  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
262  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
263  cfg.rst = MIKROBUS( mikrobus, MIKROBUS_RST ); \
264  cfg.syn = MIKROBUS( mikrobus, MIKROBUS_PWM ); \
265  cfg.rdy = MIKROBUS( mikrobus, MIKROBUS_INT )
266  // loadcell6_map // loadcell6
269 
274 typedef struct
275 {
276  // Output pins
277  digital_out_t rst;
279  // Input pins
280  digital_in_t syn;
281  digital_in_t rdy;
283  // Modules
284  spi_master_t spi;
286  pin_name_t chip_select;
288 } loadcell6_t;
289 
294 typedef struct
295 {
296  // Communication gpio pins
297  pin_name_t miso;
298  pin_name_t mosi;
299  pin_name_t sck;
300  pin_name_t cs;
302  // Additional gpio pins
303  pin_name_t rst;
304  pin_name_t syn;
305  pin_name_t rdy;
307  // static variable
308  uint32_t spi_speed;
309  spi_master_mode_t spi_mode;
310  spi_master_chip_select_polarity_t cs_polarity;
313 
318 typedef struct
319 {
320  float tare;
321  uint8_t tare_ok;
334 }
336 
341 typedef enum
342 {
344  LOADCELL6_ERROR = -1
345 
347 
364 
380 
395 
411 err_t loadcell6_generic_write ( loadcell6_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len );
412 
428 err_t loadcell6_generic_read ( loadcell6_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len );
429 
444 
457 uint8_t loadcell6_sync ( loadcell6_t *ctx );
458 
472 
488 err_t loadcell6_write_reg ( loadcell6_t *ctx, uint8_t reg, uint8_t data_in );
489 
505 err_t loadcell6_read_reg ( loadcell6_t *ctx, uint8_t reg, uint8_t *data_out );
506 
522 err_t loadcell6_write_reg_data ( loadcell6_t *ctx, uint8_t reg, uint32_t data_in );
523 
539 err_t loadcell6_read_reg_data ( loadcell6_t *ctx, uint8_t reg, uint32_t *data_out );
540 
555 err_t loadcell6_set_command ( loadcell6_t *ctx, uint8_t cmd );
556 
571 err_t loadcell6_get_status ( loadcell6_t *ctx, uint16_t *status );
572 
587 err_t loadcell6_read_adc ( loadcell6_t *ctx, uint32_t *data_out );
588 
603 err_t loadcell6_tare ( loadcell6_t *ctx, loadcell6_data_t *cell_data );
604 
626 err_t loadcell6_calibration ( loadcell6_t *ctx, uint16_t cal_val, loadcell6_data_t *cell_data );
627 
643 err_t loadcell6_get_weight ( loadcell6_t *ctx, loadcell6_data_t *cell_data, float *weight_g );
644 
645 #ifdef __cplusplus
646 }
647 #endif
648 #endif // LOADCELL6_H
649  // loadcell6
651 
652 // ------------------------------------------------------------------------ END
loadcell6_get_status
err_t loadcell6_get_status(loadcell6_t *ctx, uint16_t *status)
Load Cell 6 get status function.
loadcell6_cfg_t::cs
pin_name_t cs
Definition: loadcell6.h:300
loadcell6_data_t::weight_coeff_10000g
float weight_coeff_10000g
Definition: loadcell6.h:332
loadcell6_generic_write
err_t loadcell6_generic_write(loadcell6_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len)
Load Cell 6 data writing function.
loadcell6_check_data_ready
uint8_t loadcell6_check_data_ready(loadcell6_t *ctx)
Load Cell 6 check data ready function.
loadcell6_data_t
Load Cell 6 Click load cell data object.
Definition: loadcell6.h:319
spi_specifics.h
This file contains SPI specific macros, functions, etc.
loadcell6_read_reg
err_t loadcell6_read_reg(loadcell6_t *ctx, uint8_t reg, uint8_t *data_out)
Load Cell 6 read reg function.
loadcell6_t
Load Cell 6 Click context object.
Definition: loadcell6.h:275
loadcell6_t::syn
digital_in_t syn
Definition: loadcell6.h:280
loadcell6_cfg_t::miso
pin_name_t miso
Definition: loadcell6.h:297
loadcell6_data_t::weight_data_5000g_ok
uint8_t weight_data_5000g_ok
Definition: loadcell6.h:331
loadcell6_generic_read
err_t loadcell6_generic_read(loadcell6_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
Load Cell 6 data reading function.
loadcell6_cfg_t::rst
pin_name_t rst
Definition: loadcell6.h:303
loadcell6_tare
err_t loadcell6_tare(loadcell6_t *ctx, loadcell6_data_t *cell_data)
Load Cell 6 tare the scales function.
loadcell6_data_t::weight_coeff_5000g
float weight_coeff_5000g
Definition: loadcell6.h:330
loadcell6_write_reg_data
err_t loadcell6_write_reg_data(loadcell6_t *ctx, uint8_t reg, uint32_t data_in)
Load Cell 6 read reg data function.
loadcell6_return_value_t
loadcell6_return_value_t
Load Cell 6 Click return value data.
Definition: loadcell6.h:342
loadcell6_data_t::weight_coeff_100g
float weight_coeff_100g
Definition: loadcell6.h:322
loadcell6_hw_reset
err_t loadcell6_hw_reset(loadcell6_t *ctx)
Load Cell 6 hw reset function.
LOADCELL6_ERROR
@ LOADCELL6_ERROR
Definition: loadcell6.h:344
loadcell6_t::spi
spi_master_t spi
Definition: loadcell6.h:284
loadcell6_sync
uint8_t loadcell6_sync(loadcell6_t *ctx)
Load Cell 6 get sync function.
loadcell6_data_t::weight_coeff_500g
float weight_coeff_500g
Definition: loadcell6.h:326
loadcell6_cfg_t::spi_speed
uint32_t spi_speed
Definition: loadcell6.h:308
loadcell6_t::rdy
digital_in_t rdy
Definition: loadcell6.h:281
loadcell6_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: loadcell6.h:309
loadcell6_data_t::weight_coeff_1000g
float weight_coeff_1000g
Definition: loadcell6.h:328
LOADCELL6_OK
@ LOADCELL6_OK
Definition: loadcell6.h:343
loadcell6_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: loadcell6.h:310
loadcell6_data_t::weight_data_500g_ok
uint8_t weight_data_500g_ok
Definition: loadcell6.h:327
loadcell6_default_cfg
err_t loadcell6_default_cfg(loadcell6_t *ctx)
Load Cell 6 default configuration function.
loadcell6_cfg_setup
void loadcell6_cfg_setup(loadcell6_cfg_t *cfg)
Load Cell 6 configuration object setup function.
loadcell6_t::chip_select
pin_name_t chip_select
Definition: loadcell6.h:286
loadcell6_init
err_t loadcell6_init(loadcell6_t *ctx, loadcell6_cfg_t *cfg)
Load Cell 6 initialization function.
loadcell6_data_t::weight_data_1000g_ok
uint8_t weight_data_1000g_ok
Definition: loadcell6.h:329
loadcell6_cfg_t::mosi
pin_name_t mosi
Definition: loadcell6.h:298
loadcell6_get_weight
err_t loadcell6_get_weight(loadcell6_t *ctx, loadcell6_data_t *cell_data, float *weight_g)
Load Cell 6 get weight function.
loadcell6_data_t::weight_coeff_200g
float weight_coeff_200g
Definition: loadcell6.h:324
loadcell6_data_t::weight_data_100g_ok
uint8_t weight_data_100g_ok
Definition: loadcell6.h:323
loadcell6_t::rst
digital_out_t rst
Definition: loadcell6.h:277
loadcell6_cfg_t::rdy
pin_name_t rdy
Definition: loadcell6.h:305
loadcell6_write_reg
err_t loadcell6_write_reg(loadcell6_t *ctx, uint8_t reg, uint8_t data_in)
Load Cell 6 write reg function.
loadcell6_cfg_t::syn
pin_name_t syn
Definition: loadcell6.h:304
loadcell6_calibration
err_t loadcell6_calibration(loadcell6_t *ctx, uint16_t cal_val, loadcell6_data_t *cell_data)
Load Cell 6 calibration function.
loadcell6_data_t::tare
float tare
Definition: loadcell6.h:320
loadcell6_cfg_t::sck
pin_name_t sck
Definition: loadcell6.h:299
loadcell6_set_command
err_t loadcell6_set_command(loadcell6_t *ctx, uint8_t cmd)
Load Cell 6 set command function.
loadcell6_data_t::tare_ok
uint8_t tare_ok
Definition: loadcell6.h:321
loadcell6_data_t::weight_data_10000g_ok
uint8_t weight_data_10000g_ok
Definition: loadcell6.h:333
loadcell6_read_adc
err_t loadcell6_read_adc(loadcell6_t *ctx, uint32_t *data_out)
Load Cell 6 read ADC data function.
loadcell6_data_t::weight_data_200g_ok
uint8_t weight_data_200g_ok
Definition: loadcell6.h:325
loadcell6_read_reg_data
err_t loadcell6_read_reg_data(loadcell6_t *ctx, uint8_t reg, uint32_t *data_out)
Load Cell 6 read reg data function.
loadcell6_cfg_t
Load Cell 6 Click configuration object.
Definition: loadcell6.h:295