Go to the documentation of this file.
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 COLOR3_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 )
74 #define COLOR3_ERROR -1
81 #define COLOR3_COMMAND_TYPE_SPECIAL ( 3 << 5 )
82 #define COLOR3_COMMAND_TYPE_AUTOINC ( 1 << 5 )
83 #define COLOR3_COMMAND_SELECT ( 1 << 7 )
90 #define COLOR3_I2C_SLAVE_ADDR 0x29
97 #define COLOR3_ENABLE 0x00
98 #define COLOR3_ATIME 0x01
99 #define COLOR3_PTIME 0x02
100 #define COLOR3_WTIME 0x03
101 #define COLOR3_AILTL 0x04
102 #define COLOR3_AILTH 0x05
103 #define COLOR3_AIHTL 0x06
104 #define COLOR3_AIHTH 0x07
105 #define COLOR3_PILTL 0x08
106 #define COLOR3_PILTH 0x09
107 #define COLOR3_PIHTL 0x0A
108 #define COLOR3_PIHTH 0x0B
109 #define COLOR3_PERS 0x0C
110 #define COLOR3_CONFIG 0x0D
111 #define COLOR3_PPCOUNT 0x0E
112 #define COLOR3_CONTROL 0x0F
113 #define COLOR3_ID 0x12
114 #define COLOR3_STATUS 0x13
115 #define COLOR3_CDATA 0x14
116 #define COLOR3_CDATAH 0x15
117 #define COLOR3_RDATA 0x16
118 #define COLOR3_RDATAH 0x17
119 #define COLOR3_GDATA 0x18
120 #define COLOR3_GDATAH 0x19
121 #define COLOR3_BDATA 0x1A
122 #define COLOR3_BDATAH 0x1B
123 #define COLOR3_PDATA 0x1C
124 #define COLOR3_PDATAH 0x1D
131 #define COLOR3_ENABLE_REG_DEFAULT 0x00
132 #define COLOR3_ENABLE_REG_PON 0x01
133 #define COLOR3_ENABLE_REG_AEN 0x02
134 #define COLOR3_ENABLE_REG_PEN 0x04
135 #define COLOR3_ENABLE_REG_WEN 0x08
136 #define COLOR3_ENABLE_REG_AIEN 0x10
137 #define COLOR3_ENABLE_REG_PIEN 0x20
144 #define COLOR3_RGBC_TIMING_1_CYC 0xFF
145 #define COLOR3_RGBC_TIMING_4_CYC 0xFC
146 #define COLOR3_RGBC_TIMING_10_CYC 0xF6
147 #define COLOR3_RGBC_TIMING_42_CYC 0xD6
148 #define COLOR3_RGBC_TIMING_64_CYC 0xAD
149 #define COLOR3_RGBC_TIMING_256_CYC 0x00
156 #define COLOR3_PROXY_PULSE_1 0xFF
157 #define COLOR3_PROXY_PULSE_10 0xF6
158 #define COLOR3_PROXY_PULSE_42 0xD6
159 #define COLOR3_PROXY_PULSE_64 0xAD
160 #define COLOR3_PROXY_PULSE_256 0x00
167 #define COLOR3_WAIT_TIME_REG_1_CYC 0xFF
168 #define COLOR3_WAIT_TIME_REG_42_CYC 0xD8
169 #define COLOR3_WAIT_TIME_REG_64_CYC 0xAD
170 #define COLOR3_WAIT_TIME_REG_256_CYC 0x00
177 #define COLOR3_LOW_THRESHOLD_VALUE 0x0130
178 #define COLOR3_HIGH_THRESHOLD_VALUE 0x0170
185 #define COLOR3_EVERY_CYC_INTER 0x00
186 #define COLOR3_1_OR_INTER 0x01
187 #define COLOR3_2_OR_INTER 0x02
188 #define COLOR3_3_OR_INTER 0x03
189 #define COLOR3_5_OR_INTER 0x04
190 #define COLOR3_10_OR_INTER 0x05
191 #define COLOR3_15_OR_INTER 0x06
192 #define COLOR3_20_OR_INTER 0x07
193 #define COLOR3_25_OR_INTER 0x08
194 #define COLOR3_30_OR_INTER 0x09
195 #define COLOR3_35_OR_INTER 0x0A
196 #define COLOR3_40_OR_INTER 0x0B
197 #define COLOR3_45_OR_INTER 0x0C
198 #define COLOR3_50_OR_INTER 0x0D
199 #define COLOR3_55_OR_INTER 0x0E
200 #define COLOR3_60_OR_INTER 0x0F
207 #define COLOR3_LONG_WAIT 0x02
214 #define COLOR3_A_GAIN_1 0x00
215 #define COLOR3_A_GAIN_4 0x01
216 #define COLOR3_A_GAIN_16 0x02
217 #define COLOR3_A_GAIN_60 0x03
224 #define COLOR3_CLEAR_DIODE 0x10
225 #define COLOR3_IR_DIODE 0x20
226 #define COLOR3_BOTH_DIODE 0x30
233 #define COLOR3_LED_STR_100 0x00
234 #define COLOR3_LED_STR_50 0x40
235 #define COLOR3_LED_STR_25 0x80
236 #define COLOR3_LED_STR_12_5 0xC0
243 #define COLOR3_UNKNOWN_COLOR 0
244 #define COLOR3_RED_COLOR 1
245 #define COLOR3_YELLOW_COLOR 2
246 #define COLOR3_GREEN_COLOR 3
247 #define COLOR3_CYAN_COLOR 4
248 #define COLOR3_BLUE_COLOR 5
249 #define COLOR3_MAGENTA_COLOR 6
250 #define COLOR3_WHITE_COLOR 7
251 #define COLOR3_BLACK_COLOR 8
257 #define COLOR3_WHITE_COLOR_LIGHTNESS 97
258 #define COLOR3_BLACK_COLOR_LIGHTNESS 3
259 #define COLOR3_YELLOW_COLOR_HUE_ANGLE 30
260 #define COLOR3_GREEN_COLOR_HUE_ANGLE 90
261 #define COLOR3_CYAN_COLOR_HUE_ANGLE 150
262 #define COLOR3_BLUE_COLOR_HUE_ANGLE 210
263 #define COLOR3_MAGENTA_COLOR_HUE_ANGLE 270
264 #define COLOR3_RED_COLOR_HUE_ANGLE 330
270 #define COLOR3_HSL_HUE_RESOLUTION 360
271 #define COLOR3_HSL_SATURATION_RESOLUTION 100
272 #define COLOR3_HSL_LIGHTNESS_RESOLUTION 100
void color3_write_wait_time_reg(color3_t *ctx, uint8_t wr_data)
Write Wait Time Register function.
err_t color3_get_rgbc_data(color3_t *ctx, color3_channels_t *channels)
Color 3 get rgbc data function.
uint8_t color3_read_pulse_cnt(color3_t *ctx)
Read Proximity Pulse Count function.
uint8_t color3_get_color(color3_hsl_t *hsl)
Color 3 get color function.
void color3_set_diode_select(color3_t *ctx, uint8_t dio_sel)
Set Diode Selection function.
Click configuration structure definition.
Definition: color3.h:301
i2c_master_t i2c
Definition: color3.h:290
uint8_t color3_get_diode_select(color3_t *ctx)
Get Diode Selection function.
pin_name_t scl
Definition: color3.h:303
void color3_normal_wr_data(color3_t *ctx, uint8_t wr_addr, uint16_t wr_data)
Normal write data function.
float saturation
Definition: color3.h:335
void color3_set_prox_inter_trsh_lo(color3_t *ctx, uint16_t wr_data)
Proximity interrupt threshold low value function.
uint8_t color3_read_dev_id(color3_t *ctx)
Read device ID function.
void color3_rgbc_to_hsl(color3_t *ctx, color3_channels_t *rgbc, color3_hsl_t *hsl)
Color 3 rgbc to hsl function.
pin_name_t sda
Definition: color3.h:304
Color 3 RGBC channels data object.
Definition: color3.h:320
uint8_t color3_read_rgbc_timing_reg(color3_t *ctx)
Read RGBC Timing Register function.
uint16_t color3_read_prox_data(color3_t *ctx)
ead proximity data function.
pin_name_t int_pin
Definition: color3.h:307
uint16_t blue
Definition: color3.h:323
uint16_t red
Definition: color3.h:321
uint16_t color3_read_red_data(color3_t *ctx)
Read red data function.
uint8_t color3_read_enable_reg(color3_t *ctx)
Read Enable Register function.
uint8_t i2c_address
Definition: color3.h:311
uint8_t slave_address
Definition: color3.h:293
Color 3 HSL color data object.
Definition: color3.h:333
void color3_write_rgbc_gain(color3_t *ctx, uint8_t gain)
Write RGBC Gain Value function.
digital_in_t int_pin
Definition: color3.h:287
void color3_write_pulse_cnt(color3_t *ctx, uint8_t pulse_cnt)
Write Proximity Pulse Count function.
err_t color3_init(color3_t *ctx, color3_cfg_t *cfg)
Initialization function.
uint8_t color3_get_inter_state(color3_t *ctx)
Get Interrupt state function.
void color3_set_inter_trsh_hi(color3_t *ctx, uint16_t wr_data)
RGBC interrupt threshold high value function.
float hue
Definition: color3.h:334
void color3_special_wr_data(color3_t *ctx, uint8_t wr_addr, uint16_t wr_data)
Special write function.
void color3_special_wr_byte(color3_t *ctx, uint8_t wr_addr, uint8_t wr_data)
Special write byte function.
uint8_t color3_read_led_str(color3_t *ctx)
Read LED Strength function.
uint8_t color3_read_prox_timing_reg(color3_t *ctx)
Read Proximity Timing Register function.
err_t color3_generic_read(color3_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
Generic read function.
void color3_set_prox_inter_trsh_hi(color3_t *ctx, uint16_t wr_data)
Proximity interrupt threshold high value function.
Click ctx object definition.
Definition: color3.h:285
uint8_t color3_read_byte(color3_t *ctx, uint8_t rd_addr)
Read byte function.
void color3_cfg_setup(color3_cfg_t *cfg)
Config Object Initialization function.
uint8_t color3_read_wait_time_reg(color3_t *ctx)
Read Wait Time Register function.
uint8_t color3_read_rgbc_gain(color3_t *ctx)
Read RGBC Gain Value function.
uint16_t color3_read_blue_data(color3_t *ctx)
Read blue data function.
uint8_t color3_read_dev_stat(color3_t *ctx)
Read device status function.
err_t color3_generic_write(color3_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len)
Generic write function.
void color3_set_int_pers(color3_t *ctx, uint8_t int_pers)
Set Interrupt persistence persistence function.
void color3_set_inter_trsh_lo(color3_t *ctx, uint16_t wr_data)
RGBC interrupt threshold low value function.
uint16_t color3_read_data(color3_t *ctx, uint8_t rd_addr)
Read data function.
void color3_write_rgbc_timing_reg(color3_t *ctx, uint8_t wr_data)
Write RGBC Timing Register function.
void color3_set_default_settings(color3_t *ctx)
Default settings function.
void color3_write_prox_timing_reg(color3_t *ctx)
Write Proximity Timing Register function.
uint8_t color3_read_int_pers(color3_t *ctx)
Read Interrupt persistence function.
uint32_t i2c_speed
Definition: color3.h:310
uint8_t color3_read_prox_int_pers(color3_t *ctx)
Read Proximity interrupt persistence function.
void color3_write_enable_reg(color3_t *ctx, uint8_t wr_data)
Write Enable Register function.
void color3_set_prox_int_pers(color3_t *ctx, uint8_t int_pers)
Set Proximity interrupt persistence function.
uint16_t green
Definition: color3.h:322
float lightness
Definition: color3.h:336
uint16_t color3_read_clear_data(color3_t *ctx)
Read clear data function.
uint8_t color3_read_long_wait(color3_t *ctx)
Read long wait function.
uint16_t clear
Definition: color3.h:324
void color3_normal_wr_byte(color3_t *ctx, uint8_t wr_addr, uint8_t wr_data)
Generic read function.
void color3_set_led_str(color3_t *ctx, uint8_t led_str)
Set LED Strength function.
void color3_get_rgb_data(color3_t *ctx, uint16_t *red_data, uint16_t *green_data, uint16_t *blue_data)
Get color data function.
void color3_set_long_wait(color3_t *ctx, uint8_t lon_wait)
Set long wait function.
float color3_get_color_ratio(color3_t *ctx, uint16_t color_data)
Get color ratio function.
uint16_t color3_read_green_data(color3_t *ctx)
Read green data function.