proximity16.h

Go to the documentation of this file.

/****************************************************************************
** Copyright (C) 2020 MikroElektronika d.o.o.
** Contact: https://www.mikroe.com/contact
**
** Permission is hereby granted, free of charge, to any person obtaining a copy
** of this software and associated documentation files (the "Software"), to deal
** in the Software without restriction, including without limitation the rights
** to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
** copies of the Software, and to permit persons to whom the Software is
** furnished to do so, subject to the following conditions:
** The above copyright notice and this permission notice shall be
** included in all copies or substantial portions of the Software.
**
** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
** OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
** DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
** OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
**  USE OR OTHER DEALINGS IN THE SOFTWARE.
****************************************************************************/
 
#ifndef PROXIMITY16_H
#define PROXIMITY16_H
 
#ifdef __cplusplus
extern "C"{
#endif
 
#ifdef PREINIT_SUPPORTED
#include "preinit.h"
#endif
 
#ifdef MikroCCoreVersion
    #if MikroCCoreVersion >= 1
        #include "delays.h"
    #endif
#endif
 
#include "drv_digital_out.h"
#include "drv_digital_in.h"
#include "drv_i2c_master.h"
 
#define PROXIMITY16_DCI_ZONE_CONFIG             0x5450
#define PROXIMITY16_DCI_FREQ_HZ                 0x5458
#define PROXIMITY16_DCI_INT_TIME                0x545C
#define PROXIMITY16_DCI_FW_NB_TARGET            0x5478
#define PROXIMITY16_DCI_RANGING_MODE            0xAD30
#define PROXIMITY16_DCI_DSS_CONFIG              0xAD38
#define PROXIMITY16_DCI_TARGET_ORDER            0xAE64
#define PROXIMITY16_DCI_SHARPENER               0xAED8
#define PROXIMITY16_DCI_INTERNAL_CP             0xB39C
#define PROXIMITY16_DCI_MOTION_DETECTOR_CFG     0xBFAC
#define PROXIMITY16_DCI_SINGLE_RANGE            0xCD5C
#define PROXIMITY16_DCI_OUTPUT_CONFIG           0xCD60
#define PROXIMITY16_DCI_OUTPUT_ENABLES          0xCD68
#define PROXIMITY16_DCI_OUTPUT_LIST             0xCD78
#define PROXIMITY16_DCI_PIPE_CONTROL            0xCF78
 
#define PROXIMITY16_UI_CMD_STATUS               0x2C00
#define PROXIMITY16_UI_CMD_START                0x2C04
#define PROXIMITY16_UI_CMD_END                  0x2FFF
 
 // proximity16_reg
 
#define PROXIMITY16_TEMP_BUFFER_SIZE            1024
#define PROXIMITY16_NVM_DATA_SIZE               492
#define PROXIMITY16_OFFSET_BUFFER_SIZE          488
#define PROXIMITY16_XTALK_BUFFER_SIZE           776
 
#define PROXIMITY16_RESOLUTION_4X4              16
#define PROXIMITY16_RESOLUTION_8X8              64
 
#define PROXIMITY16_RANGING_MODE_CONTINUOUS     1
#define PROXIMITY16_RANGING_MODE_AUTONOMOUS     3
 
#define PROXIMITY16_START_BH                    0x0000000Dul
#define PROXIMITY16_METADATA_BH                 0x54B400C0ul
#define PROXIMITY16_COMMONDATA_BH               0x54C00040ul
#define PROXIMITY16_AMBIENT_RATE_BH             0x54D00104ul
#define PROXIMITY16_SPAD_COUNT_BH               0x55D00404ul
#define PROXIMITY16_NB_TARGET_DETECTED_BH       0xCF7C0401ul
#define PROXIMITY16_SIGNAL_RATE_BH              0xCFBC0404ul
#define PROXIMITY16_RANGE_SIGMA_MM_BH           0xD2BC0402ul
#define PROXIMITY16_DISTANCE_BH                 0xD33C0402ul
#define PROXIMITY16_REFLECTANCE_BH              0xD43C0401ul
#define PROXIMITY16_TARGET_STATUS_BH            0xD47C0401ul
#define PROXIMITY16_MOTION_DETECT_BH            0xCC5008C0ul
#define PROXIMITY16_METADATA_IDX                0x54B4
#define PROXIMITY16_SPAD_COUNT_IDX              0x55D0
#define PROXIMITY16_AMBIENT_RATE_IDX            0x54D0
#define PROXIMITY16_NB_TARGET_DETECTED_IDX      0xCF7C
#define PROXIMITY16_SIGNAL_RATE_IDX             0xCFBC
#define PROXIMITY16_RANGE_SIGMA_MM_IDX          0xD2BC
#define PROXIMITY16_DISTANCE_IDX                0xD33C
#define PROXIMITY16_REFLECTANCE_EST_PC_IDX      0xD43C
#define PROXIMITY16_TARGET_STATUS_IDX           0xD47C
#define PROXIMITY16_MOTION_DETEC_IDX            0xCC50
 
#define PROXIMITY16_DEF_RESOLUTION              PROXIMITY16_RESOLUTION_8X8
#define PROXIMITY16_DEF_RANGING_FREQ_HZ         2
#define PROXIMITY16_DEF_RANGING_MODE            PROXIMITY16_RANGING_MODE_AUTONOMOUS
#define PROXIMITY16_DEF_INTEGRATION_TIME_MS     20
 
#define PROXIMITY16_DEVICE_ADDRESS              0x29
 
 // proximity16_set
 
#define PROXIMITY16_MAP_MIKROBUS( cfg, mikrobus ) \
    cfg.scl = MIKROBUS( mikrobus, MIKROBUS_SCL ); \
    cfg.sda = MIKROBUS( mikrobus, MIKROBUS_SDA ); \
    cfg.i2c_rst = MIKROBUS( mikrobus, MIKROBUS_RST ); \
    cfg.lpn = MIKROBUS( mikrobus, MIKROBUS_PWM ); \
    cfg.int_pin = MIKROBUS( mikrobus, MIKROBUS_INT )
 
 // proximity16_map
 // proximity16
 
typedef struct
{
    // Output pins
    digital_out_t i2c_rst;      
    digital_out_t lpn;          
    // Input pins
    digital_in_t  int_pin;      
    // Modules
    i2c_master_t  i2c;          
    // I2C slave address
    uint8_t slave_address;      
    uint8_t stream_count;
    uint32_t data_read_size;
    uint8_t offset_data[ PROXIMITY16_OFFSET_BUFFER_SIZE ];
    uint8_t temp_buf[ PROXIMITY16_TEMP_BUFFER_SIZE ];
 
} proximity16_t;
 
typedef struct
{
    pin_name_t scl;             
    pin_name_t sda;             
    pin_name_t i2c_rst;         
    pin_name_t lpn;             
    pin_name_t int_pin;         
    uint32_t   i2c_speed;       
    uint8_t    i2c_address;     
} proximity16_cfg_t;
 
typedef enum
{
    PROXIMITY16_OK = 0,
    PROXIMITY16_ERROR = -1
 
} proximity16_return_value_t;
 
typedef struct
{
    int8_t silicon_temp_degc;
 
    uint8_t nb_target_detected[ PROXIMITY16_RESOLUTION_8X8 ];
 
    int16_t distance_mm[ PROXIMITY16_RESOLUTION_8X8 ];
 
    uint8_t target_status[ PROXIMITY16_RESOLUTION_8X8 ];
 
} proximity16_results_data_t;
 
typedef union 
{
    uint32_t bytes;
    struct 
    {
        uint32_t type : 4;
        uint32_t size : 12;
        uint32_t idx : 16;
    };
} proximity16_block_header_t;
 
void proximity16_cfg_setup ( proximity16_cfg_t *cfg );
 
err_t proximity16_init ( proximity16_t *ctx, proximity16_cfg_t *cfg );
 
err_t proximity16_default_cfg ( proximity16_t *ctx );
 
err_t proximity16_write_multi ( proximity16_t *ctx, uint16_t reg, uint8_t *data_in, uint8_t len );
 
err_t proximity16_read_multi ( proximity16_t *ctx, uint16_t reg, uint8_t *data_out, uint16_t len );
 
err_t proximity16_write_byte ( proximity16_t *ctx, uint16_t reg, uint8_t data_in );
 
err_t proximity16_read_byte ( proximity16_t *ctx, uint16_t reg, uint8_t *data_out );
 
err_t proximity16_write_data ( proximity16_t *ctx, uint8_t *data_in, uint16_t len );
 
err_t proximity16_check_communication ( proximity16_t *ctx );
 
uint8_t proximity16_get_int_pin ( proximity16_t *ctx );
 
void proximity16_set_i2c_rst_pin ( proximity16_t *ctx, uint8_t state );
 
void proximity16_set_lpn_pin ( proximity16_t *ctx, uint8_t state );
 
void proximity16_reset_i2c ( proximity16_t *ctx );
 
err_t proximity16_sensor_init ( proximity16_t *ctx );
 
err_t proximity16_dci_write_data ( proximity16_t *ctx, uint16_t index, uint8_t *data_in, uint16_t data_size );
 
err_t proximity16_dci_read_data ( proximity16_t *ctx, uint16_t index, uint8_t *data_out, uint16_t data_size );
 
err_t proximity16_dci_replace_data ( proximity16_t *ctx, uint16_t index, uint8_t *data_in, uint16_t data_size, 
                                     uint8_t *new_data, uint16_t new_data_size, uint16_t new_data_pos );
 
err_t proximity16_set_resolution ( proximity16_t *ctx, uint8_t resolution );
 
err_t proximity16_get_resolution ( proximity16_t *ctx, uint8_t *resolution );
 
err_t proximity16_set_ranging_frequency_hz ( proximity16_t *ctx, uint8_t frequency_hz );
 
err_t proximity16_get_ranging_frequency_hz ( proximity16_t *ctx, uint8_t *frequency_hz );
 
err_t proximity16_set_integration_time_ms ( proximity16_t *ctx, uint32_t integration_time_ms );
 
err_t proximity16_get_integration_time_ms ( proximity16_t *ctx, uint32_t *integration_time_ms );
 
err_t proximity16_set_ranging_mode ( proximity16_t *ctx, uint8_t ranging_mode );
 
err_t proximity16_get_ranging_mode ( proximity16_t *ctx, uint8_t *ranging_mode );
 
err_t proximity16_start_ranging ( proximity16_t *ctx );
 
err_t proximity16_stop_ranging ( proximity16_t *ctx );
 
err_t proximity16_get_ranging_data ( proximity16_t *ctx, proximity16_results_data_t *results );
 
#ifdef __cplusplus
}
#endif
#endif // PROXIMITY16_H
 
 // proximity16
 
// ------------------------------------------------------------------------ END