Go to the documentation of this file.
35 #ifndef SPECTROMETER_H
36 #define SPECTROMETER_H
38 #include "mikrosdk_version.h"
41 #if mikroSDK_GET_VERSION < 20800ul
42 #include "rcu_delays.h"
48 #include "drv_digital_out.h"
49 #include "drv_digital_in.h"
50 #include "drv_i2c_master.h"
63 #define SPECTROMETER_MAP_MIKROBUS( cfg, mikrobus ) \
64 cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
65 cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
66 cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
73 #define SPECTROMETER_RETVAL uint8_t
75 #define SPECTROMETER_OK 0x00
76 #define SPECTROMETER_INIT_ERROR 0xFF
83 #define SPECTROMETER_I2C_DEV_ADR 0x39
90 #define SPECTROMETER_ASTAT 0x60
91 #define SPECTROMETER_CH0_DATA_L 0x61
92 #define SPECTROMETER_CH0_DATA_H 0x62
93 #define SPECTROMETER_ITIME_L 0x63
94 #define SPECTROMETER_ITIME_M 0x64
95 #define SPECTROMETER_ITIME_H 0x65
96 #define SPECTROMETER_CH1_DATA_L 0x66
97 #define SPECTROMETER_CH1_DATA_H 0x67
98 #define SPECTROMETER_CH2_DATA_L 0x68
99 #define SPECTROMETER_CH2_DATA_H 0x69
100 #define SPECTROMETER_CH3_DATA_L 0x6A
101 #define SPECTROMETER_CH3_DATA_H 0x6B
102 #define SPECTROMETER_CH4_DATA_L 0x6C
103 #define SPECTROMETER_CH4_DATA_H 0x6D
104 #define SPECTROMETER_CH5_DATA_L 0x6E
105 #define SPECTROMETER_CH5_DATA_H 0x6F
106 #define SPECTROMETER_CFG 0x70
107 #define SPECTROMETER_STAT 0x71
108 #define SPECTROMETER_SYNC_EDGE 0x72
109 #define SPECTROMETER_GPIO 0x73
110 #define SPECTROMETER_LED 0x74
111 #define SPECTROMETER_ENABLE 0x80
112 #define SPECTROMETER_ATIME 0x81
113 #define SPECTROMETER_WTIME 0x83
114 #define SPECTROMETER_SP_TH_L_LSB 0x84
115 #define SPECTROMETER_SP_TH_L_MSB 0x85
116 #define SPECTROMETER_SP_TH_H_LSB 0x86
117 #define SPECTROMETER_SP_TH_H_MSB 0x87
118 #define SPECTROMETER_AUXID 0x90
119 #define SPECTROMETER_REVID 0x91
120 #define SPECTROMETER_ID 0x92
121 #define SPECTROMETER_STATUS 0x93
122 #define SPECTROMETER_ASTATUS 0x94
123 #define SPECTROMETER_CH0_ADC_DATA_L 0x95
124 #define SPECTROMETER_CH0_ADC_DATA_H 0x96
125 #define SPECTROMETER_CH1_ADC_DATA_L 0x97
126 #define SPECTROMETER_CH1_ADC_DATA_H 0x98
127 #define SPECTROMETER_CH2_ADC_DATA_L 0x99
128 #define SPECTROMETER_CH2_ADC_DATA_H 0x9A
129 #define SPECTROMETER_CH3_ADC_DATA_L 0x9B
130 #define SPECTROMETER_CH3_ADC_DATA_H 0x9C
131 #define SPECTROMETER_CH4_ADC_DATA_L 0x9D
132 #define SPECTROMETER_CH4_ADC_DATA_H 0x9E
133 #define SPECTROMETER_CH5_ADC_DATA_L 0x9F
134 #define SPECTROMETER_CH5_ADC_DATA_H 0xA0
135 #define SPECTROMETER_STAT_2 0xA3
136 #define SPECTROMETER_STAT_3 0xA4
137 #define SPECTROMETER_STAT_5 0xA6
138 #define SPECTROMETER_STAT_6 0xA7
139 #define SPECTROMETER_CFG_0 0xA9
140 #define SPECTROMETER_CFG_1 0xAA
141 #define SPECTROMETER_CFG_3 0xAC
142 #define SPECTROMETER_CFG_6 0xAF
143 #define SPECTROMETER_CFG_8 0xB1
144 #define SPECTROMETER_CFG_9 0xB2
145 #define SPECTROMETER_CFG_10 0xB3
146 #define SPECTROMETER_CFG_12 0xB5
147 #define SPECTROMETER_PERS 0xBD
148 #define SPECTROMETER_GPIO_2 0xBE
149 #define SPECTROMETER_ASTEP_L 0xCA
150 #define SPECTROMETER_ASTEP_H 0xCB
151 #define SPECTROMETER_AGC_GAIN_MAX 0xCF
152 #define SPECTROMETER_AZ_CFG 0xD6
153 #define SPECTROMETER_FD_TIME_1 0xD8
154 #define SPECTROMETER_FD_TIME_2 0xDA
155 #define SPECTROMETER_FD_CFG0 0xD7
156 #define SPECTROMETER_FD_STAT 0xDB
157 #define SPECTROMETER_INTENAB 0xF9
158 #define SPECTROMETER_CTL 0xFA
159 #define SPECTROMETER_FIFO_MAP 0xFC
160 #define SPECTROMETER_FIFO_LVL 0xFD
161 #define SPECTROMETER_FDATA_L 0xFE
162 #define SPECTROMETER_FDATA_H 0xFF
169 #define SPECTROMETER_CFG_LED_SEL 0x08
170 #define SPECTROMETER_CFG_INT_SEL 0x04
171 #define SPECTROMETER_CFG_INT_MODE_SYND 0x03
172 #define SPECTROMETER_CFG_INT_MODE_SYNS 0x01
173 #define SPECTROMETER_CFG_INT_MODE_SPM 0x00
180 #define SPECTROMETER_STAT_WAIT_SYNC 0x02
181 #define SPECTROMETER_STAT_READY 0x01
188 #define SPECTROMETER_GPIO_PD_GPIO 0x02
189 #define SPECTROMETER_GPIO_PD_INT 0x01
196 #define SPECTROMETER_LED_LED_ACT 0x80
197 #define SPECTROMETER_LED_LED_DRV_4MA 0x00
198 #define SPECTROMETER_LED_LED_DRV_6MA 0x01
199 #define SPECTROMETER_LED_LED_DRV_8MA 0x02
200 #define SPECTROMETER_LED_LED_DRV_10MA 0x03
201 #define SPECTROMETER_LED_LED_DRV_12MA 0x04
202 #define SPECTROMETER_LED_LED_DRV_256MA 0x7E
203 #define SPECTROMETER_LED_LED_DRV_258MA 0x7F
210 #define SPECTROMETER_EN_FDEN 0x40
211 #define SPECTROMETER_EN_SMUXEN 0x10
212 #define SPECTROMETER_EN_WEN 0x08
213 #define SPECTROMETER_EN_SP_EN 0x02
214 #define SPECTROMETER_EN_PON 0x01
221 #define SPECTROMETER_STATUS_ASAT 0x80
222 #define SPECTROMETER_STATUS_AINT 0x08
223 #define SPECTROMETER_STATUS_FINT 0x04
224 #define SPECTROMETER_STATUS_CINT 0x02
225 #define SPECTROMETER_STATUS_SINT 0x01
232 #define SPECTROMETER_STAT_2_AVALID 0x40
233 #define SPECTROMETER_STAT_2_ASAT_DIG 0x10
234 #define SPECTROMETER_STAT_2_ASAT_ANA 0x08
235 #define SPECTROMETER_STAT_2_FDSAT_ANA 0x02
236 #define SPECTROMETER_STAT_2_FDSAT_DIG 0x01
243 #define SPECTROMETER_STAT_3_INT_SP_H 0x20
244 #define SPECTROMETER_STAT_3_INT_SP_L 0x10
251 #define SPECTROMETER_STAT_5_SINT_FD 0x08
252 #define SPECTROMETER_STAT_5_SINT_SMUX 0x04
259 #define SPECTROMETER_STAT_6_FIFO_OV 0x80
260 #define SPECTROMETER_STAT_6_OVTEMP 0x20
261 #define SPECTROMETER_STAT_6_FD_TRIG 0x10
262 #define SPECTROMETER_STAT_6_SP_TRIG 0x04
263 #define SPECTROMETER_STAT_6_SAI_ACT 0x02
264 #define SPECTROMETER_STAT_6_INT_BUSY 0x01
271 #define SPECTROMETER_CFG_0_LOW_POW 0x20
272 #define SPECTROMETER_CFG_0_REG_BANK_1 0x10
273 #define SPECTROMETER_CFG_0_REG_BANK_0 0x00
274 #define SPECTROMETER_CFG_0_WLONG 0x04
281 #define SPECTROMETER_CFG_1_AGAIN_512 0x0A
282 #define SPECTROMETER_CFG_1_AGAIN_256 0x09
283 #define SPECTROMETER_CFG_1_AGAIN_128 0x08
284 #define SPECTROMETER_CFG_1_AGAIN_64 0x07
285 #define SPECTROMETER_CFG_1_AGAIN_32 0x06
286 #define SPECTROMETER_CFG_1_AGAIN_16 0x05
287 #define SPECTROMETER_CFG_1_AGAIN_8 0x04
288 #define SPECTROMETER_CFG_1_AGAIN_4 0x03
289 #define SPECTROMETER_CFG_1_AGAIN_2 0x02
290 #define SPECTROMETER_CFG_1_AGAIN_1 0x01
291 #define SPECTROMETER_CFG_1_AGAIN_05 0x00
298 #define SPECTROMETER_CFG_3_SAI 0x10
305 #define SPECTROMETER_CFG_6_SMUX_CMD_2 0x10
306 #define SPECTROMETER_CFG_6_SMUX_CMD_1 0x08
307 #define SPECTROMETER_CFG_6_SMUX_CMD_0 0x00
314 #define SPECTROMETER_CFG_8_FIFO_TH_16 0xC0
315 #define SPECTROMETER_CFG_8_FIFO_TH_8 0x80
316 #define SPECTROMETER_CFG_8_FIFO_TH_4 0x40
317 #define SPECTROMETER_CFG_8_FIFO_TH_1 0x00
318 #define SPECTROMETER_CFG_8_FD_AGC 0x08
319 #define SPECTROMETER_CFG_8_SP_AGC 0x04
326 #define SPECTROMETER_CFG_9_SIEN_FD 0x40
327 #define SPECTROMETER_CFG_9_SIEN_SMUX 0x10
334 #define SPECTROMETER_CFG_10_AGC_H_3 0xC0
335 #define SPECTROMETER_CFG_10_AGC_H_2 0x80
336 #define SPECTROMETER_CFG_10_AGC_H_1 0x40
337 #define SPECTROMETER_CFG_10_AGC_H_0 0x00
338 #define SPECTROMETER_CFG_10_AGC_L_3 0x60
339 #define SPECTROMETER_CFG_10_AGC_L_2 0x20
340 #define SPECTROMETER_CFG_10_AGC_L_1 0x10
341 #define SPECTROMETER_CFG_10_AGC_L_0 0x00
342 #define SPECTROMETER_CFG_10_FD_PERS_DEF 0x02
349 #define SPECTROMETER_CFG_12_SP_TH_CH_4 0x04
350 #define SPECTROMETER_CFG_12_SP_TH_CH_3 0x03
351 #define SPECTROMETER_CFG_12_SP_TH_CH_2 0x02
352 #define SPECTROMETER_CFG_12_SP_TH_CH_1 0x01
353 #define SPECTROMETER_CFG_12_SP_TH_CH_0 0x00
360 #define SPECTROMETER_PERS_APERS_60 0x0F
361 #define SPECTROMETER_PERS_APERS_55 0x0E
362 #define SPECTROMETER_PERS_APERS_50 0x0D
363 #define SPECTROMETER_PERS_APERS_45 0x0C
364 #define SPECTROMETER_PERS_APERS_40 0x0B
365 #define SPECTROMETER_PERS_APERS_35 0x0A
366 #define SPECTROMETER_PERS_APERS_30 0x09
367 #define SPECTROMETER_PERS_APERS_25 0x08
368 #define SPECTROMETER_PERS_APERS_20 0x07
369 #define SPECTROMETER_PERS_APERS_15 0x06
370 #define SPECTROMETER_PERS_APERS_10 0x05
371 #define SPECTROMETER_PERS_APERS_5 0x04
372 #define SPECTROMETER_PERS_APERS_3 0x03
373 #define SPECTROMETER_PERS_APERS_2 0x02
374 #define SPECTROMETER_PERS_APERS_1 0x01
375 #define SPECTROMETER_PERS_APERS 0x00
382 #define SPECTROMETER_GPIO_2_GPIO_INV 0x08
383 #define SPECTROMETER_GPIO_2_GPIO_IN 0x04
384 #define SPECTROMETER_GPIO_2_GPIO_OUT 0x02
391 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_512 0xA0
392 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_256 0x90
393 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_128 0x80
394 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_64 0x70
395 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_32 0x60
396 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_16 0x50
397 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_8 0x40
398 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_4 0x30
399 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_2 0x20
400 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_1 0x10
401 #define SPECTROMETER_AGC_GAIN_MAX_AGC_FD_GAIN_MAX_05 0x00
402 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_512 0x0A
403 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_256 0x09
404 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_128 0x08
405 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_64 0x07
406 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_32 0x06
407 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_16 0x05
408 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_8 0x04
409 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_4 0x03
410 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_2 0x02
411 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_1 0x01
412 #define SPECTROMETER_AGC_GAIN_MAX_AGC_AGAIN_MAX_05 0x00
419 #define SPECTROMETER_FD_CFG0_FD_FIFO 0x80
426 #define SPECTROMETER_FD_STAT_FD_VALID 0x20
427 #define SPECTROMETER_FD_STAT_FD_SAT 0x10
428 #define SPECTROMETER_FD_STAT_FD_120HZ_VALID 0x08
429 #define SPECTROMETER_FD_STAT_FD_100HZ_VALID 0x04
430 #define SPECTROMETER_FD_STAT_FD_120HZ 0x02
431 #define SPECTROMETER_FD_STAT_FD_100HZ 0x01
438 #define SPECTROMETER_INTENAB_ASIEN 0x80
439 #define SPECTROMETER_INTENAB_SP_IEN 0x08
440 #define SPECTROMETER_INTENAB_F_IEN 0x04
441 #define SPECTROMETER_INTENAB_SIEN 0x01
448 #define SPECTROMETER_CTL_AZ_SP_MAN 0x04
449 #define SPECTROMETER_CTL_FIFO_CLR 0x02
450 #define SPECTROMETER_CTL_CLR_SAI_ACT 0x01
457 #define SPECTROMETER_FIFO_MAP_WR_DATA_CH6 0x40
458 #define SPECTROMETER_FIFO_MAP_WR_DATA_CH5 0x20
459 #define SPECTROMETER_FIFO_MAP_WR_DATA_CH3 0x10
460 #define SPECTROMETER_FIFO_MAP_WR_DATA_CH2 0x08
461 #define SPECTROMETER_FIFO_MAP_WR_DATA_CH1 0x04
462 #define SPECTROMETER_FIFO_MAP_WR_DATA_CH0 0x02
463 #define SPECTROMETER_FIFO_MAP_WR_ASTAT 0x01
470 #define SPECTROMETER_FD_TIME_2_FD_GAIN_05 0x00
471 #define SPECTROMETER_FD_TIME_2_FD_GAIN_1 0x08
472 #define SPECTROMETER_FD_TIME_2_FD_GAIN_2 0x10
473 #define SPECTROMETER_FD_TIME_2_FD_GAIN_4 0x18
474 #define SPECTROMETER_FD_TIME_2_FD_GAIN_8 0x20
475 #define SPECTROMETER_FD_TIME_2_FD_GAIN_16 0x28
476 #define SPECTROMETER_FD_TIME_2_FD_GAIN_32 0x30
477 #define SPECTROMETER_FD_TIME_2_FD_GAIN_64 0x38
478 #define SPECTROMETER_FD_TIME_2_FD_GAIN_128 0x40
479 #define SPECTROMETER_FD_TIME_2_FD_GAIN_256 0x48
480 #define SPECTROMETER_FD_TIME_2_FD_GAIN_512 0x50
487 #define SPECTROMETER_UNKNOWN_FREQ 0x01
488 #define SPECTROMETER_DETECTED_100_HZ 0x02
489 #define SPECTROMETER_DETECTED_120_HZ 0x03
490 #define SPECTROMETER_READING_ERROR 0x00
497 #define SPECTROMETER_ID_VALUE 0x24
760 #endif // _SPECTROMETER_H_
uint8_t i2c_address
Definition: spectrometer.h:543
uint32_t i2c_speed
Definition: spectrometer.h:542
Click ctx object definition.
Definition: spectrometer.h:511
#define SPECTROMETER_RETVAL
Definition: spectrometer.h:73
void spectrometer_raw_rd_val_mode_1(spectrometer_t *ctx, uint8_t *adc_data)
Raw Read Mode 1 function.
uint8_t spectrometer_get_data_ready(spectrometer_t *ctx)
Reading and Polling the the AVALID bit function.
void spectrometer_raw_rd_val_mode_2(spectrometer_t *ctx, uint8_t *adc_data)
Raw Read Mode 2 function.
void spectrometer_generic_read(spectrometer_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic read function.
void spectrometer_f5f8_clr_nir(spectrometer_t *ctx)
SMUX Configuration for F5,F6,F7,F8,NIR,Clear function.
void spectrometer_cfg_setup(spectrometer_cfg_t *cfg)
Config Object Initialization function.
uint8_t spectrometer_flicker_detection(spectrometer_t *ctx)
name function
pin_name_t scl
Definition: spectrometer.h:533
Click configuration structure definition.
Definition: spectrometer.h:530
void spectrometer_fd_cfg(spectrometer_t *ctx)
Flicker Detect Configuration function.
void spectrometer_pon(spectrometer_t *ctx)
Set the power on bit function.
uint8_t slave_address
Definition: spectrometer.h:522
pin_name_t int_pin
Definition: spectrometer.h:538
void spectrometer_f1f4_clr_nir(spectrometer_t *ctx)
SMUX Configuration for F1,F2,F3,F4,NIR,Clear function.
digital_in_t int_pin
Definition: spectrometer.h:514
i2c_master_t i2c
Definition: spectrometer.h:518
SPECTROMETER_RETVAL spectrometer_init(spectrometer_t *ctx, spectrometer_cfg_t *cfg)
Initialization function.
void spectrometer_reg_bank_cfg(spectrometer_t *ctx, uint8_t reg_bank)
Select Register bank function.
uint8_t spectrometer_get_smux_en(spectrometer_t *ctx)
Reading and Polling the the SMUX Enable bit function.
uint8_t spectrometer_get_int(spectrometer_t *ctx)
Get Interrupt state function.
void spectrometer_sp_en(spectrometer_t *ctx, uint8_t state)
Set the spectral measurement enabled bit function.
void spectrometer_generic_write(spectrometer_t *ctx, uint8_t reg, uint8_t *data_buf, uint8_t len)
Generic write function.
pin_name_t sda
Definition: spectrometer.h:534
void spectrometer_smux_en(spectrometer_t *ctx)
Starting the SMUX function.
void spectrometer_def_cfg(spectrometer_t *ctx)
Default configuration function.