smartsens  2.0.0.0
smartsens.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 SMARTSENS_H
29 #define SMARTSENS_H
30 
31 #ifdef __cplusplus
32 extern "C"{
33 #endif
34 
39 #ifdef PREINIT_SUPPORTED
40 #include "preinit.h"
41 #endif
42 
43 #ifdef MikroCCoreVersion
44  #if MikroCCoreVersion >= 1
45  #include "delays.h"
46  #endif
47 #endif
48 
49 #include "drv_digital_out.h"
50 #include "drv_digital_in.h"
51 #include "drv_i2c_master.h"
52 #include "drv_spi_master.h"
53 #include "spi_specifics.h"
54 
83 #define SMARTSENS_FLASHIMG 0 /*< Firmware image for flash include */
84 #define SMARTSENS_FLASH 1 /*< Boot firmware from flash */
85 #define SMARTSENS_RAM 0 /*< Upload and boot firmware from RAM */
86 
91 #define SMARTSENS_REG_COMMAND_INPUT 0x00
92 #define SMARTSENS_REG_WAKE_UP_FIFO 0x01
93 #define SMARTSENS_REG_NON_WAKE_UP_FIFO 0x02
94 #define SMARTSENS_REG_STATUS_DEBUG_FIFO 0x03
95 #define SMARTSENS_REG_CHIP_CTRL 0x05
96 #define SMARTSENS_REG_HOST_INTERFACE_CTRL 0x06
97 #define SMARTSENS_REG_HOST_INTERRUPT_CTRL 0x07
98 #define SMARTSENS_REG_RESET_REQUEST 0x14
99 #define SMARTSENS_REG_TIMESTAMP_EVENT_REQUEST 0x15
100 #define SMARTSENS_REG_HOST_CTRL 0x16
101 #define SMARTSENS_REG_HOST_STATUS 0x17
102 #define SMARTSENS_REG_HOST_CRC 0x18191A1B
103 #define SMARTSENS_REG_FUSER2_PRODUCT_ID 0x1C
104 #define SMARTSENS_REG_FUSER2_REVISION_ID 0x1D
105 #define SMARTSENS_REG_ROM_VERSION 0x1E1F
106 #define SMARTSENS_REG_KERNEL_VERSION 0x2021
107 #define SMARTSENS_REG_USER_VERSION 0x2223
108 #define SMARTSENS_REG_FEATURE_STATUS 0x24
109 #define SMARTSENS_REG_BOOT_STATUS 0x25
110 #define SMARTSENS_REG_HOST_INTERRUPT_TIMESTAMP 0x26 // Start of interrupt state. Length 5 Bytes. [0x26..0x2A]
111 #define SMARTSENS_REG_CHIP_ID 0x2B
112 #define SMARTSENS_REG_INTERRUPT_STATUS 0x2D
113 #define SMARTSENS_REG_ERROR_VALUE 0x2E
114 #define SMARTSENS_REG_ERROR_AUX 0x2F
115 #define SMARTSENS_REG_DEBUG_VALUE 0x30
116 #define SMARTSENS_REG_DEBUG_STATE 0x31
117 
122 #define SMARTSENS_CMD_DOWNLOAD_POST_MORTEM_DATA 0x0001
123 #define SMARTSENS_CMD_UPLOAD_TO_RAM 0x0002
124 #define SMARTSENS_CMD_BOOT_RAM 0x0003
125 #define SMARTSENS_CMD_ERASE_FLASH 0x0004
126 #define SMARTSENS_CMD_WRITE_FLASH 0x0005
127 #define SMARTSENS_CMD_BOOT_FLASH 0x0006
128 #define SMARTSENS_CMD_SET_SENSOR_DATA_INJECTION 0x0007
129 #define SMARTSENS_CMD_INJECT_SENSOR_DATA 0x0008
130 #define SMARTSENS_CMD_FIFO_FLUSH 0x0009
131 #define SMARTSENS_CMD_SOFT_PASS_THROUGH 0x000A
132 #define SMARTSENS_CMD_REQUEST_SENSOR_SELF_TEST 0x000B
133 #define SMARTSENS_CMD_REQUEST_SENSOR_FAST_OFFSET_COMPENSATION 0x000C
134 #define SMARTSENS_CMD_CONFIGURE_SENSOR 0x000D
135 #define SMARTSENS_CMD_CHANGE_SENSOR_DYNAMIC_RANGE 0x000E
136 #define SMARTSENS_CMD_SET_CHANGE_SENSITIVITY 0x000F
137 #define SMARTSENS_CMD_DEBUG_TEST 0x0010
138 #define SMARTSENS_CMD_DUT_CONTINUE 0x0011
139 #define SMARTSENS_CMD_DUT_START_TEST 0x0012
140 #define SMARTSENS_CMD_CTRL_FIFO_FORMAT 0x0015
141 #define SMARTSENS_CMD_RAISE_SPEED 0x0017
142 /*
143  * COMMANDS WITH PARAMETERS:
144  * 0x0100..0x01FF -> System Parameters
145  * 0x0200..0x02FF -> BSX Algorithm Parameters
146  * 0x0300..0x03FF -> Virual Sensor Information Parameters
147  * 0x0500..0x05FF -> Virtual Sensor Configuration Parameters
148  * 0x0800..0x0DFF -> Costumer Defined
149  * 0x0E00..0x0EFF -> Physical Sensor Control Parameters
150  */
151 // System Parameters
152 #define SMARTSENS_CMD_SYSTEM_PARAMETERS_READ_MASK 0x1000
153 #define SMARTSENS_CMD_META_EVENT_CTRL_NON_WAKE_UP_FIFO 0x0101
154 #define SMARTSENS_CMD_META_EVENT_CTRL_WAKE_UP_FIFO 0x0102
155 #define SMARTSENS_CMD_META_EVENT_CTRL_FIFO_CTRL 0x0103
156 #define SMARTSENS_CMD_META_EVENT_CTRL_FIRMWARE_VERSION 0x0104
157 #define SMARTSENS_CMD_META_EVENT_CTRL_TIMESTAMPS 0x0105
158 #define SMARTSENS_CMD_META_EVENT_CTRL_FRAMEWORK_STATUS 0x0106
159 #define SMARTSENS_CMD_META_EVENT_CTRL_VIRUAL_SENSOR_PRESENT 0x011F
160 #define SMARTSENS_CMD_META_EVENT_CTRL_PHYSICAL_SENSOR_PRESENT 0x0120
161 #define SMARTSENS_CMD_META_EVENT_CTRL_PHYSICAL_SENSOR_INFO 0x0121 //0x0121..0x0160
162 // BSX Algorithm Parameters
163 #define SMARTSENS_CMD_CALIBRATION_STATE_ACCELEROMETER 0x0201
164 #define SMARTSENS_CMD_CALIBRATION_STATE_GYROSCOPE 0x0203
165 #define SMARTSENS_CMD_CALIBRATION_STATE_MAGNETOMETER 0x0205
166 #define SMARTSENS_CMD_SIC_MATRIX 0x027D
167 #define SMARTSENS_CMD_BSX_VERSION 0x027E
168 // Virual Sensor Information Parameters
169 #define SMARTSENS_CMD_VIRTUAL_SENSOR_INFO 0x0300
170 
175 #define SMARTSENS_START_FLASH_ADR 0x00001F84
176  // smartsens_reg
178 
193 #define SMARTSENS_SENSOR_ID_CUSTOM_START 160
194 #define SMARTSENS_SENSOR_ID_CUSTOM_END 191
195 #define SMARTSENS_SENSOR_ID_MAX 200
196 #define SMARTSENS_SENSOR_ID_TBD SMARTSENS_SENSOR_ID_MAX - 1
197 #define SMARTSENS_SENSOR_ID_ACC_PASS 1 /* Accelerometer passthrough */
198 #define SMARTSENS_SENSOR_ID_ACC_RAW 3 /* Accelerometer uncalibrated */
199 #define SMARTSENS_SENSOR_ID_ACC 4 /* Accelerometer corrected */
200 #define SMARTSENS_SENSOR_ID_ACC_BIAS 5 /* Accelerometer offset */
201 #define SMARTSENS_SENSOR_ID_ACC_WU 6 /* Accelerometer corrected wake up */
202 #define SMARTSENS_SENSOR_ID_ACC_RAW_WU 7 /* Accelerometer uncalibrated wake up */
203 #define SMARTSENS_SENSOR_ID_GYRO_PASS 10 /* Gyroscope passthrough */
204 #define SMARTSENS_SENSOR_ID_GYRO_RAW 12 /* Gyroscope uncalibrated */
205 #define SMARTSENS_SENSOR_ID_GYRO 13 /* Gyroscope corrected */
206 #define SMARTSENS_SENSOR_ID_GYRO_BIAS 14 /* Gyroscope offset */
207 #define SMARTSENS_SENSOR_ID_GYRO_WU 15 /* Gyroscope wake up */
208 #define SMARTSENS_SENSOR_ID_GYRO_RAW_WU 16 /* Gyroscope uncalibrated wake up */
209 #define SMARTSENS_SENSOR_ID_MAG_PASS 19 /* Magnetometer passthrough */
210 #define SMARTSENS_SENSOR_ID_MAG_RAW 21 /* Magnetometer uncalibrated */
211 #define SMARTSENS_SENSOR_ID_MAG 22 /* Magnetometer corrected */
212 #define SMARTSENS_SENSOR_ID_MAG_BIAS 23 /* Magnetometer offset */
213 #define SMARTSENS_SENSOR_ID_MAG_WU 24 /* Magnetometer wake up */
214 #define SMARTSENS_SENSOR_ID_MAG_RAW_WU 25 /* Magnetometer uncalibrated wake up */
215 #define SMARTSENS_SENSOR_ID_GRA 28 /* Gravity vector */
216 #define SMARTSENS_SENSOR_ID_GRA_WU 29 /* Gravity vector wake up */
217 #define SMARTSENS_SENSOR_ID_LACC 31 /* Linear acceleration */
218 #define SMARTSENS_SENSOR_ID_LACC_WU 32 /* Linear acceleration wake up */
219 #define SMARTSENS_SENSOR_ID_RV 34 /* Rotation vector */
220 #define SMARTSENS_SENSOR_ID_RV_WU 35 /* Rotation vector wake up */
221 #define SMARTSENS_SENSOR_ID_GAMERV 37 /* Game rotation vector */
222 #define SMARTSENS_SENSOR_ID_GAMERV_WU 38 /* Game rotation vector wake up */
223 #define SMARTSENS_SENSOR_ID_GEORV 40 /* Geo-magnetic rotation vector */
224 #define SMARTSENS_SENSOR_ID_GEORV_WU 41 /* Geo-magnetic rotation vector wake up */
225 #define SMARTSENS_SENSOR_ID_ORI 43 /* Orientation */
226 #define SMARTSENS_SENSOR_ID_ORI_WU 44 /* Orientation wake up */
227 #define SMARTSENS_SENSOR_ID_TILT_DETECTOR 48 /* Tilt detector */
228 #define SMARTSENS_SENSOR_ID_STD 50 /* Step detector */
229 #define SMARTSENS_SENSOR_ID_STC 52 /* Step counter */
230 #define SMARTSENS_SENSOR_ID_STC_WU 53 /* Step counter wake up */
231 #define SMARTSENS_SENSOR_ID_SIG 55 /* Significant motion */
232 #define SMARTSENS_SENSOR_ID_WAKE_GESTURE 57 /* Wake gesture */
233 #define SMARTSENS_SENSOR_ID_GLANCE_GESTURE 59 /* Glance gesture */
234 #define SMARTSENS_SENSOR_ID_PICKUP_GESTURE 61 /* Pickup gesture */
235 #define SMARTSENS_SENSOR_ID_AR 63 /* Activity recognition */
236 #define SMARTSENS_SENSOR_ID_WRIST_TILT_GESTURE 67 /* Wrist tilt gesture */
237 #define SMARTSENS_SENSOR_ID_DEVICE_ORI 69 /* Device orientation */
238 #define SMARTSENS_SENSOR_ID_DEVICE_ORI_WU 70 /* Device orientation wake up */
239 #define SMARTSENS_SENSOR_ID_STATIONARY_DET 75 /* Stationary detect */
240 #define SMARTSENS_SENSOR_ID_MOTION_DET 77 /* Motion detect */
241 #define SMARTSENS_SENSOR_ID_ACC_BIAS_WU 91 /* Accelerometer offset wake up */
242 #define SMARTSENS_SENSOR_ID_GYRO_BIAS_WU 92 /* Gyroscope offset wake up */
243 #define SMARTSENS_SENSOR_ID_MAG_BIAS_WU 93 /* Magnetometer offset wake up */
244 #define SMARTSENS_SENSOR_ID_STD_WU 94 /* Step detector wake up */
245 #define SMARTSENS_SENSOR_ID_TEMP 128 /* Temperature */
246 #define SMARTSENS_SENSOR_ID_BARO 129 /* Barometer */
247 #define SMARTSENS_SENSOR_ID_HUM 130 /* Humidity */
248 #define SMARTSENS_SENSOR_ID_GAS 131 /* Gas */
249 #define SMARTSENS_SENSOR_ID_TEMP_WU 132 /* Temperature wake up */
250 #define SMARTSENS_SENSOR_ID_BARO_WU 133 /* Barometer wake up */
251 #define SMARTSENS_SENSOR_ID_HUM_WU 134 /* Humidity wake up */
252 #define SMARTSENS_SENSOR_ID_GAS_WU 135 /* Gas wake up */
253 #define SMARTSENS_SENSOR_ID_STC_HW 136 /* Hardware Step counter */
254 #define SMARTSENS_SENSOR_ID_STD_HW 137 /* Hardware Step detector */
255 #define SMARTSENS_SENSOR_ID_SIG_HW 138 /* Hardware Significant motion */
256 #define SMARTSENS_SENSOR_ID_STC_HW_WU 139 /* Hardware Step counter wake up */
257 #define SMARTSENS_SENSOR_ID_STD_HW_WU 140 /* Hardware Step detector wake up */
258 #define SMARTSENS_SENSOR_ID_SIG_HW_WU 141 /* Hardware Significant motion wake up */
259 #define SMARTSENS_SENSOR_ID_ANY_MOTION 142 /* Any motion */
260 #define SMARTSENS_SENSOR_ID_ANY_MOTION_WU 143 /* Any motion wake up */
261 #define SMARTSENS_SENSOR_ID_EXCAMERA 144 /* External camera trigger */
262 #define SMARTSENS_SENSOR_ID_GPS 145 /* GPS */
263 #define SMARTSENS_SENSOR_ID_LIGHT 146 /* Light */
264 #define SMARTSENS_SENSOR_ID_PROX 147 /* Proximity */
265 #define SMARTSENS_SENSOR_ID_LIGHT_WU 148 /* Light wake up */
266 #define SMARTSENS_SENSOR_ID_PROX_WU 149 /* Proximity wake up */
267 #define SMARTSENS_IS_SYS_ID( sid ) ( ( sid ) >= 224 )
268 #define SMARTSENS_SYS_ID_PADDING 0
269 #define SMARTSENS_SYS_ID_TS_SMALL_DELTA 251
270 #define SMARTSENS_SYS_ID_TS_LARGE_DELTA 252
271 #define SMARTSENS_SYS_ID_TS_FULL 253
272 #define SMARTSENS_SYS_ID_META_EVENT 254
273 #define SMARTSENS_SYS_ID_TS_SMALL_DELTA_WU 245
274 #define SMARTSENS_SYS_ID_TS_LARGE_DELTA_WU 246
275 #define SMARTSENS_SYS_ID_TS_FULL_WU 247
276 #define SMARTSENS_SYS_ID_META_EVENT_WU 248
277 #define SMARTSENS_SYS_ID_FILLER 255
278 #define SMARTSENS_SYS_ID_DEBUG_MSG 250
279 #define SMARTSENS_SYS_ID_SMARTSENS_LOG_UPDATE_SUB 243
280 #define SMARTSENS_SYS_ID_SMARTSENS_LOG_DOSTEP 244
281 #define SMARTSENS_N_VIRTUAL_SENSOR_MAX 256 /* Maximum no of available virtual sensor */
282 #define SMARTSENS_SPECIAL_SENSOR_ID_OFFSET 245 /* Special & debug virtual sensor id starts at 245 */
283 
288 #define SMARTSENS_META_EVENT_FLUSH_COMPLETE 1
289 #define SMARTSENS_META_EVENT_SAMPLE_RATE_CHANGED 2
290 #define SMARTSENS_META_EVENT_POWER_MODE_CHANGED 3
291 #define SMARTSENS_META_EVENT_ALGORITHM_EVENTS 5
292 #define SMARTSENS_META_EVENT_SENSOR_STATUS 6
293 #define SMARTSENS_META_EVENT_BSX_DO_STEPS_MAIN 7
294 #define SMARTSENS_META_EVENT_BSX_DO_STEPS_CALIB 8
295 #define SMARTSENS_META_EVENT_BSX_GET_OUTPUT_SIGNAL 9
296 #define SMARTSENS_META_EVENT_RESERVED1 10
297 #define SMARTSENS_META_EVENT_SENSOR_ERROR 11
298 #define SMARTSENS_META_EVENT_FIFO_OVERFLOW 12
299 #define SMARTSENS_META_EVENT_DYNAMIC_RANGE_CHANGED 13
300 #define SMARTSENS_META_EVENT_FIFO_WATERMARK 14
301 #define SMARTSENS_META_EVENT_RESERVED2 15
302 #define SMARTSENS_META_EVENT_INITIALIZED 16
303 #define SMARTSENS_META_TRANSFER_CAUSE 17
304 #define SMARTSENS_META_EVENT_SENSOR_FRAMEWORK 18
305 #define SMARTSENS_META_EVENT_RESET 19
306 #define SMARTSENS_META_EVENT_SPACER 20
307 
312 #define SMARTSENS_CHIP_ID_VALUE 0x70
313 #define SMARTSENS_FUSER2_PRODUCT_ID_VALUE 0x89
314 
319 #define SMARTSENS_BOOTSTATUS_FLASH_DETECTED 0x01
320 #define SMARTSENS_BOOTSTATUS_FLASH_VERIFY_DONE 0x02
321 #define SMARTSENS_BOOTSTATUS_FLASH_VERIFY_ERROR 0x04
322 #define SMARTSENS_BOOTSTATUS_NO_FLASH 0x08
323 #define SMARTSENS_BOOTSTATUS_HOST_INTERFACE_READY 0x10
324 #define SMARTSENS_BOOTSTATUS_HOST_FW_VERIFY_DONE 0x20
325 #define SMARTSENS_BOOTSTATUS_HOST_FW_VERIFY_ERROR 0x40
326 #define SMARTSENS_BOOTSTATUS_HOST_FW_IDLE 0x80
327 
332 #define SMARTSENS_HOSTSTATUS_POWER_STATE 0x01
333 #define SMARTSENS_HOSTSTATUS_HOST_PROTOCOL 0x02
334 #define SMARTSENS_HOSTSTATUS_HOST_CHANNEL_0 0x10
335 #define SMARTSENS_HOSTSTATUS_HOST_CHANNEL_1 0x20
336 #define SMARTSENS_HOSTSTATUS_HOST_CHANNEL_2 0x40
337 #define SMARTSENS_HOSTSTATUS_HOST_CHANNEL_3 0x80
338 
343 #define SMARTSENS_IST_MASK_ASSERTED 0x1
344 #define SMARTSENS_IST_MASK_FIFO_W 0x6
345 #define SMARTSENS_IST_MASK_FIFO_NW 0x18
346 #define SMARTSENS_IST_MASK_STATUS 0x20
347 #define SMARTSENS_IST_MASK_DEBUG 0x40
348 #define SMARTSENS_IST_MASK_RESET_FAULT 0x80
349 #define SMARTSENS_IST_FIFO_W_DRDY 0x2
350 #define SMARTSENS_IST_FIFO_W_LTCY 0x4
351 #define SMARTSENS_IST_FIFO_W_WM 0x6
352 #define SMARTSENS_IST_FIFO_NW_DRDY 0x8
353 #define SMARTSENS_IST_FIFO_NW_LTCY 0x10
354 #define SMARTSENS_IST_FIFO_NW_WM 0x18
355 #define SMARTSENS_IS_INT_FIFO_W( status ) ( status & SMARTSENS_IST_MASK_FIFO_W )
356 #define SMARTSENS_IS_INT_FIFO_NW( status ) ( status & SMARTSENS_IST_MASK_FIFO_NW )
357 #define SMARTSENS_IS_INT_STATUS( status ) ( status & SMARTSENS_IST_MASK_STATUS )
358 #define SMARTSENS_IS_INT_ASYNC_STATUS( status ) ( status & SMARTSENS_IST_MASK_DEBUG )
359 #define SMARTSENS_IS_INT_RESET( status ) ( status & SMARTSENS_IST_MASK_RESET_FAULT )
360 #define SMARTSENS_IST_MASK_FIFO ( SMARTSENS_IST_MASK_FIFO_W | SMARTSENS_IST_MASK_FIFO_NW )
361 #define SMARTSENS_IS_INT_FIFO( status ) ( status & SMARTSENS_IST_MASK_FIFO )
362 
367 #define SMARTSENS_ICTL_DISABLE_FIFO_W 0x01
368 #define SMARTSENS_ICTL_DISABLE_FIFO_NW 0x02
369 #define SMARTSENS_ICTL_DISABLE_STATUS_FIFO 0x04
370 #define SMARTSENS_ICTL_DISABLE_DEBUG 0x08
371 #define SMARTSENS_ICTL_DISABLE_FAULT 0x10
372 #define SMARTSENS_ICTL_ACTIVE_LOW 0x20
373 #define SMARTSENS_ICTL_EDGE 0x40
374 #define SMARTSENS_ICTL_OPEN_DRAIN 0x80
375 
380 #define SMARTSENS_HIF_CTRL_ABORT_TRANSFER_CHANNEL_0 0x01
381 #define SMARTSENS_HIF_CTRL_ABORT_TRANSFER_CHANNEL_1 0x02
382 #define SMARTSENS_HIF_CTRL_ABORT_TRANSFER_CHANNEL_2 0x04
383 #define SMARTSENS_HIF_CTRL_ABORT_TRANSFER_CHANNEL_3 0x08
384 #define SMARTSENS_HIF_CTRL_AP_SUSPENDED 0x10
385 #define SMARTSENS_HIF_CTRL_TIMESTAMP_EV_CTRL 0x40
386 #define SMARTSENS_HIF_CTRL_ASYNC_STATUS_CHANNEL 0x80
387 
392 #define SMARTSENS_LE2U16( x ) ( ( uint16_t )( ( x )[ 0 ] | ( x )[ 1 ] << 8 ) )
393 #define SMARTSENS_LE2S16( x ) ( ( int16_t )SMARTSENS_LE2U16( x ) )
394 #define SMARTSENS_LE2U24( x ) ( ( uint32_t )( ( x )[ 0 ] | \
395  ( uint32_t )( x )[ 1 ] << 8 | \
396  ( uint32_t )( x )[ 2 ] << 16 ) )
397 #define SMARTSENS_LE2U32( x ) ( ( uint32_t )( ( x )[ 0 ] | \
398  ( uint32_t )( x )[ 1 ] << 8 | \
399  ( uint32_t )( x )[ 2 ] << 16 | \
400  ( uint32_t )( x )[ 3 ] << 24 ) )
401 #define SMARTSENS_LE2S32( x ) ( ( int32_t )SMARTSENS_LE2U32( x ) )
402 #define SMARTSENS_LE2U40( x ) ( SMARTSENS_LE2U32( x ) | ( uint32_t )( x )[ 4 ] << 32 )
403 #define SMARTSENS_TIMESTAMP_TO_SEC( x ) ( ( uint32_t ) ( x * ( 15625.0 / UINT32_C( 1000000000 ) ) ) )
404 
410 #define SMARTSENS_SLAVE_ADDRESS_1 0x29
411 #define SMARTSENS_SLAVE_ADDRESS_0 0x28
412 
421 #define SMARTSENS_SET_DATA_SAMPLE_EDGE SET_SPI_DATA_SAMPLE_EDGE
422 #define SMARTSENS_SET_DATA_SAMPLE_MIDDLE SET_SPI_DATA_SAMPLE_MIDDLE
423  // smartsens_set
425 
440 #define SMARTSENS_MAP_MIKROBUS( cfg, mikrobus ) \
441  cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
442  cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
443  cfg.miso = MIKROBUS( mikrobus, MIKROBUS_MISO ); \
444  cfg.mosi = MIKROBUS( mikrobus, MIKROBUS_MOSI ); \
445  cfg.sck = MIKROBUS( mikrobus, MIKROBUS_SCK ); \
446  cfg.cs = MIKROBUS( mikrobus, MIKROBUS_CS ); \
447  cfg.rst = MIKROBUS( mikrobus, MIKROBUS_RST ); \
448  cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
449  // smartsens_map // smartsens
452 
457 typedef enum
458 {
463 
469 {
474 };
475 
481 {
482  uint8_t sensor_id;
484  uint8_t data_size;
485  uint8_t *data_ptr;
486  uint32_t *time_stamp;
487 };
488 
494 typedef err_t ( *smartsens_master_io_t )( struct smartsens_s*, uint8_t, uint8_t*, uint8_t );
496 typedef void ( *smartsens_fifo_parse_callback_t )( struct smartsens_fifo_parse_data_info *callback_info, void *private_data );
497 
503 {
504  uint16_t u16_val;
505  uint8_t bytes[ 2 ];
506 };
507 
513 {
514  uint32_t u32_val;
515  uint8_t bytes[ 4 ];
516 };
517 
523 {
524  float f_val;
525  uint32_t u32_val;
526  uint8_t bytes[ 4 ];
527 };
528 
534 {
535  uint8_t sensor_type;
536  uint8_t driver_id;
537  uint8_t driver_version;
538  uint8_t power;
544  uint8_t event_size;
546 };
547 
553 {
554  uint8_t event_size;
557 };
558 
564 {
565  uint32_t read_pos;
566  uint32_t read_length;
567  uint32_t remain_length;
568  uint32_t buffer_size;
569  uint8_t *buffer;
570 };
571 
576 typedef struct smartsens_s
577 {
578  digital_out_t rst;
580  digital_in_t int_pin;
582  i2c_master_t i2c;
583  spi_master_t spi;
585  uint8_t slave_address;
586  pin_name_t chip_select;
594 
596 
601 typedef struct
602 {
603  pin_name_t scl;
604  pin_name_t sda;
605  pin_name_t miso;
606  pin_name_t mosi;
607  pin_name_t sck;
608  pin_name_t cs;
609  pin_name_t rst;
610  pin_name_t int_pin;
612  uint32_t i2c_speed;
613  uint8_t i2c_address;
615  uint32_t spi_speed;
616  spi_master_mode_t spi_mode;
617  spi_master_chip_select_polarity_t cs_polarity;
622 
627 typedef enum
628 {
632 
634 
651 
667 
683 
698 
714 err_t smartsens_generic_write ( smartsens_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len );
715 
731 err_t smartsens_generic_read ( smartsens_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len );
732 
745 err_t smartsens_byte_write ( smartsens_t *ctx, uint8_t reg, uint8_t data_in );
746 
759 err_t smartsens_byte_read ( smartsens_t *ctx, uint8_t reg, uint8_t *data_out );
760 
769 
784 err_t smartsens_cmd_write ( smartsens_t *ctx, uint16_t cmd, uint8_t *cmd_buf, uint16_t cmd_len );
785 
799 err_t smartsens_status_read ( smartsens_t *ctx, uint16_t *cmd, uint8_t *cmd_buf, uint16_t *cmd_len );
800 
813 err_t smartsens_get_parameter ( smartsens_t *ctx, uint16_t parameter,
814  uint8_t *parameter_buf, uint16_t *parameter_len );
815 
824 
836 
852 
867 
881 
892 
904 err_t smartsens_get_virt_sensor_list ( smartsens_t *ctx, uint8_t *sensor_list );
905 
918 err_t smartsens_set_virt_sensor_cfg( smartsens_t *ctx, uint8_t sensor_id, float sample_rate, uint32_t latency );
919 
930 err_t smartsens_get_and_process_fifo ( smartsens_t *ctx, uint8_t *work_buffer, uint32_t buffer_size );
931 
943 err_t smartsens_register_fifo_parse_callback ( smartsens_t *ctx, uint8_t sensor_id,
945 
946 #ifdef __cplusplus
947 }
948 #endif
949 #endif // SMARTSENS_H
950  // smartsens
952 
953 // ------------------------------------------------------------------------ END
smartsens_generic_write
err_t smartsens_generic_write(smartsens_t *ctx, uint8_t reg, uint8_t *data_in, uint8_t len)
Smart Sens data writing function.
smartsens_status_read
err_t smartsens_status_read(smartsens_t *ctx, uint16_t *cmd, uint8_t *cmd_buf, uint16_t *cmd_len)
Read Status and Debug FIFO.
smartsens_register_fifo_parse_callback
err_t smartsens_register_fifo_parse_callback(smartsens_t *ctx, uint8_t sensor_id, smartsens_fifo_parse_callback_t callback, void *callback_ref)
Link a callback to virtual sensor.
smartsens_fifo_buffer::read_pos
uint32_t read_pos
Definition: smartsens.h:565
smartsens_master_io_t
err_t(* smartsens_master_io_t)(struct smartsens_s *, uint8_t, uint8_t *, uint8_t)
Smart Sens Click driver interface.
Definition: smartsens.h:494
smartsens_cfg_t::rst
pin_name_t rst
Definition: smartsens.h:609
smartsens_fifo_parse_callback_table::callback_ref
void * callback_ref
Definition: smartsens.h:556
smartsens_s::rst
digital_out_t rst
Definition: smartsens.h:578
smartsens_sensor_info::driver_version
uint8_t driver_version
Definition: smartsens.h:537
smartsens_cfg_t::cs
pin_name_t cs
Definition: smartsens.h:608
smartsens_u16_conv
U16 converter union.
Definition: smartsens.h:503
smartsens_t
struct smartsens_s smartsens_t
Smart Sens Click context object.
smartsens_s::slave_address
uint8_t slave_address
Definition: smartsens.h:585
smartsens_sensor_info::max_rate
union smartsens_float_conv max_rate
Definition: smartsens.h:541
smartsens_power_on_device
err_t smartsens_power_on_device(smartsens_t *ctx)
Power on device boot/upload firmware to device.
smartsens_fifo_parse_data_info::data_size
uint8_t data_size
Definition: smartsens.h:484
smartsens_byte_write
err_t smartsens_byte_write(smartsens_t *ctx, uint8_t reg, uint8_t data_in)
Byte writing function.
spi_specifics.h
This file contains SPI specific macros, functions, etc.
smartsens_s::read_f
smartsens_master_io_t read_f
Definition: smartsens.h:590
smartsens_cfg_t::i2c_speed
uint32_t i2c_speed
Definition: smartsens.h:612
smartsens_float_conv
Float converter union.
Definition: smartsens.h:523
smartsens_reset
void smartsens_reset(smartsens_t *ctx)
Reset device.
smartsens_fifo_type
smartsens_fifo_type
Fifo type enum.
Definition: smartsens.h:469
smartsens_sensor_info::event_size
uint8_t event_size
Definition: smartsens.h:544
smartsens_float_conv::u32_val
uint32_t u32_val
Definition: smartsens.h:525
smartsens_s::spi
spi_master_t spi
Definition: smartsens.h:583
smartsens_cfg_t
Smart Sens Click configuration object.
Definition: smartsens.h:602
smartsens_s
Smart Sens Click context object.
Definition: smartsens.h:577
smartsens_s::int_pin
digital_in_t int_pin
Definition: smartsens.h:580
smartsens_sensor_info::max_range
union smartsens_u16_conv max_range
Definition: smartsens.h:539
smartsens_float_conv::bytes
uint8_t bytes[4]
Definition: smartsens.h:526
work_buffer
uint8_t work_buffer[WORK_BUFFER_SIZE]
Definition: main.c:62
SMARTSENS_FIFO_TYPE_MAX
@ SMARTSENS_FIFO_TYPE_MAX
Definition: smartsens.h:473
smartsens_float_conv::f_val
float f_val
Definition: smartsens.h:524
smartsens_update_virtual_sensor_list
err_t smartsens_update_virtual_sensor_list(smartsens_t *ctx)
Update the callback table's information.
smartsens_u32_conv::bytes
uint8_t bytes[4]
Definition: smartsens.h:515
smartsens_sw_reset
err_t smartsens_sw_reset(smartsens_t *ctx)
SW Reset device.
smartsens_cfg_t::scl
pin_name_t scl
Definition: smartsens.h:603
smartsens_drv_interface_selection
void smartsens_drv_interface_selection(smartsens_cfg_t *cfg, smartsens_drv_t drv_sel)
Smart Sens driver interface setup function.
smartsens_fifo_parse_data_info::data_ptr
uint8_t * data_ptr
Definition: smartsens.h:485
smartsens_cfg_t::int_pin
pin_name_t int_pin
Definition: smartsens.h:610
SMARTSENS_N_VIRTUAL_SENSOR_MAX
#define SMARTSENS_N_VIRTUAL_SENSOR_MAX
Definition: smartsens.h:281
smartsens_default_cfg
err_t smartsens_default_cfg(smartsens_t *ctx)
Smart Sens default configuration function.
smartsens_sensor_info
Sensor info.
Definition: smartsens.h:534
smartsens_sensor_info::power
uint8_t power
Definition: smartsens.h:538
SMARTSENS_FIFO_TYPE_STATUS
@ SMARTSENS_FIFO_TYPE_STATUS
Definition: smartsens.h:472
smartsens_s::chip_select
pin_name_t chip_select
Definition: smartsens.h:586
SMARTSENS_FIFO_TYPE_NON_WAKEUP
@ SMARTSENS_FIFO_TYPE_NON_WAKEUP
Definition: smartsens.h:471
smartsens_cfg_t::spi_speed
uint32_t spi_speed
Definition: smartsens.h:615
smartsens_s::write_f
smartsens_master_io_t write_f
Definition: smartsens.h:589
smartsens_cfg_t::drv_sel
smartsens_drv_t drv_sel
Definition: smartsens.h:619
smartsens_drv_t
smartsens_drv_t
Smart Sens Click driver selector.
Definition: smartsens.h:458
smartsens_get_parameter
err_t smartsens_get_parameter(smartsens_t *ctx, uint16_t parameter, uint8_t *parameter_buf, uint16_t *parameter_len)
Get command parameters response.
smartsens_cfg_t::sck
pin_name_t sck
Definition: smartsens.h:607
smartsens_return_value_t
smartsens_return_value_t
Smart Sens Click return value data.
Definition: smartsens.h:628
smartsens_get_virt_sensor_list
err_t smartsens_get_virt_sensor_list(smartsens_t *ctx, uint8_t *sensor_list)
Get the virtual sensor list.
smartsens_sensor_info::driver_id
uint8_t driver_id
Definition: smartsens.h:536
smartsens_update_firmware
err_t smartsens_update_firmware(smartsens_t *ctx)
Upload firmware image to the device.
smartsens_byte_read
err_t smartsens_byte_read(smartsens_t *ctx, uint8_t reg, uint8_t *data_out)
Byte reading function.
smartsens_cfg_t::cs_polarity
spi_master_chip_select_polarity_t cs_polarity
Definition: smartsens.h:617
smartsens_s::table
struct smartsens_fifo_parse_callback_table table[SMARTSENS_N_VIRTUAL_SENSOR_MAX]
Definition: smartsens.h:592
SMARTSENS_DRV_SEL_SPI
@ SMARTSENS_DRV_SEL_SPI
Definition: smartsens.h:459
smartsens_generic_read
err_t smartsens_generic_read(smartsens_t *ctx, uint8_t reg, uint8_t *data_out, uint8_t len)
Smart Sens data reading function.
smartsens_fifo_parse_callback_t
void(* smartsens_fifo_parse_callback_t)(struct smartsens_fifo_parse_data_info *callback_info, void *private_data)
Definition: smartsens.h:496
smartsens_cfg_t::mosi
pin_name_t mosi
Definition: smartsens.h:606
smartsens_cfg_t::i2c_address
uint8_t i2c_address
Definition: smartsens.h:613
smartsens_fifo_buffer::remain_length
uint32_t remain_length
Definition: smartsens.h:567
smartsens_fifo_parse_callback_table
Callback prase.
Definition: smartsens.h:553
smartsens_sensor_info::min_rate
union smartsens_float_conv min_rate
Definition: smartsens.h:545
SMARTSENS_FIFO_TYPE_WAKEUP
@ SMARTSENS_FIFO_TYPE_WAKEUP
Definition: smartsens.h:470
smartsens_get_and_process_fifo
err_t smartsens_get_and_process_fifo(smartsens_t *ctx, uint8_t *work_buffer, uint32_t buffer_size)
Get and process the FIFO.
smartsens_u16_conv::u16_val
uint16_t u16_val
Definition: smartsens.h:504
smartsens_fifo_buffer::buffer_size
uint32_t buffer_size
Definition: smartsens.h:568
smartsens_sensor_info::sensor_type
uint8_t sensor_type
Definition: smartsens.h:535
smartsens_fifo_parse_data_info::time_stamp
uint32_t * time_stamp
Definition: smartsens.h:486
SMARTSENS_DRV_SEL_I2C
@ SMARTSENS_DRV_SEL_I2C
Definition: smartsens.h:460
smartsens_set_virt_sensor_cfg
err_t smartsens_set_virt_sensor_cfg(smartsens_t *ctx, uint8_t sensor_id, float sample_rate, uint32_t latency)
Set configuration fro virtual sensor.
smartsens_sensor_info::resolution
union smartsens_u16_conv resolution
Definition: smartsens.h:540
smartsens_get_interrupt
uint8_t smartsens_get_interrupt(smartsens_t *ctx)
Get interrupt.
smartsens_cfg_t::miso
pin_name_t miso
Definition: smartsens.h:605
smartsens_cfg_t::spi_mode
spi_master_mode_t spi_mode
Definition: smartsens.h:616
smartsens_cfg_setup
void smartsens_cfg_setup(smartsens_cfg_t *cfg)
Smart Sens configuration object setup function.
smartsens_fifo_parse_data_info::sensor_id
uint8_t sensor_id
Definition: smartsens.h:482
smartsens_cmd_write
err_t smartsens_cmd_write(smartsens_t *ctx, uint16_t cmd, uint8_t *cmd_buf, uint16_t cmd_len)
Send command.
smartsens_cfg_t::sda
pin_name_t sda
Definition: smartsens.h:604
smartsens_fifo_parse_callback_table::callback
smartsens_fifo_parse_callback_t callback
Definition: smartsens.h:555
SMARTSENS_ERROR
@ SMARTSENS_ERROR
Definition: smartsens.h:630
smartsens_boot_firmware
err_t smartsens_boot_firmware(smartsens_t *ctx)
Boot firmware image.
smartsens_fifo_buffer
Fifo buffer.
Definition: smartsens.h:564
smartsens_init
err_t smartsens_init(smartsens_t *ctx, smartsens_cfg_t *cfg)
Smart Sens initialization function.
smartsens_u32_conv
U32 converter union.
Definition: smartsens.h:513
smartsens_sensor_info::fifo_reserved
union smartsens_u32_conv fifo_reserved
Definition: smartsens.h:542
smartsens_u16_conv::bytes
uint8_t bytes[2]
Definition: smartsens.h:505
smartsens_s::i2c
i2c_master_t i2c
Definition: smartsens.h:582
smartsens_sensor_info::fifo_max
union smartsens_u32_conv fifo_max
Definition: smartsens.h:543
smartsens_fifo_buffer::buffer
uint8_t * buffer
Definition: smartsens.h:569
SMARTSENS_ERROR_TIMEOUT
@ SMARTSENS_ERROR_TIMEOUT
Definition: smartsens.h:631
smartsens_fifo_parse_data_info::fifo_type
enum smartsens_fifo_type fifo_type
Definition: smartsens.h:483
smartsens_s::drv_sel
smartsens_drv_t drv_sel
Definition: smartsens.h:587
smartsens_fifo_parse_data_info
Parsing data info.
Definition: smartsens.h:481
smartsens_u32_conv::u32_val
uint32_t u32_val
Definition: smartsens.h:514
smartsens_fifo_buffer::read_length
uint32_t read_length
Definition: smartsens.h:566
SMARTSENS_OK
@ SMARTSENS_OK
Definition: smartsens.h:629
smartsens_fifo_parse_callback_table::event_size
uint8_t event_size
Definition: smartsens.h:554
smartsens_s::last_time_stamp
uint32_t last_time_stamp[SMARTSENS_FIFO_TYPE_MAX]
Definition: smartsens.h:593