VL53L0X.h

#ifndef VL53L0X_H_
#define VL53L0X_H_

#include <stdbool.h>
#include "stm32f1xx.h"


    // register addresses from API vl53l0x_device.h (ordered as listed there)
    enum VL53L0X_regAddr
    {
      SYSRANGE_START                              = 0x00,

      SYSTEM_THRESH_HIGH                          = 0x0C,
      SYSTEM_THRESH_LOW                           = 0x0E,

      SYSTEM_SEQUENCE_CONFIG                      = 0x01,
      SYSTEM_RANGE_CONFIG                         = 0x09,
      SYSTEM_INTERMEASUREMENT_PERIOD              = 0x04,

      SYSTEM_INTERRUPT_CONFIG_GPIO                = 0x0A,

      GPIO_HV_MUX_ACTIVE_HIGH                     = 0x84,

      SYSTEM_INTERRUPT_CLEAR                      = 0x0B,

      RESULT_INTERRUPT_STATUS                     = 0x13,
      RESULT_RANGE_STATUS                         = 0x14,

      RESULT_CORE_AMBIENT_WINDOW_EVENTS_RTN       = 0xBC,
      RESULT_CORE_RANGING_TOTAL_EVENTS_RTN        = 0xC0,
      RESULT_CORE_AMBIENT_WINDOW_EVENTS_REF       = 0xD0,
      RESULT_CORE_RANGING_TOTAL_EVENTS_REF        = 0xD4,
      RESULT_PEAK_SIGNAL_RATE_REF                 = 0xB6,

      ALGO_PART_TO_PART_RANGE_OFFSET_MM           = 0x28,

      I2C_SLAVE_DEVICE_ADDRESS                    = 0x8A,

      MSRC_CONFIG_CONTROL                         = 0x60,

      PRE_RANGE_CONFIG_MIN_SNR                    = 0x27,
      PRE_RANGE_CONFIG_VALID_PHASE_LOW            = 0x56,
      PRE_RANGE_CONFIG_VALID_PHASE_HIGH           = 0x57,
      PRE_RANGE_MIN_COUNT_RATE_RTN_LIMIT          = 0x64,

      FINAL_RANGE_CONFIG_MIN_SNR                  = 0x67,
      FINAL_RANGE_CONFIG_VALID_PHASE_LOW          = 0x47,
      FINAL_RANGE_CONFIG_VALID_PHASE_HIGH         = 0x48,
      FINAL_RANGE_CONFIG_MIN_COUNT_RATE_RTN_LIMIT = 0x44,

      PRE_RANGE_CONFIG_SIGMA_THRESH_HI            = 0x61,
      PRE_RANGE_CONFIG_SIGMA_THRESH_LO            = 0x62,

      PRE_RANGE_CONFIG_VCSEL_PERIOD               = 0x50,
      PRE_RANGE_CONFIG_TIMEOUT_MACROP_HI          = 0x51,
      PRE_RANGE_CONFIG_TIMEOUT_MACROP_LO          = 0x52,

      SYSTEM_HISTOGRAM_BIN                        = 0x81,
      HISTOGRAM_CONFIG_INITIAL_PHASE_SELECT       = 0x33,
      HISTOGRAM_CONFIG_READOUT_CTRL               = 0x55,

      FINAL_RANGE_CONFIG_VCSEL_PERIOD             = 0x70,
      FINAL_RANGE_CONFIG_TIMEOUT_MACROP_HI        = 0x71,
      FINAL_RANGE_CONFIG_TIMEOUT_MACROP_LO        = 0x72,
      CROSSTALK_COMPENSATION_PEAK_RATE_MCPS       = 0x20,

      MSRC_CONFIG_TIMEOUT_MACROP                  = 0x46,

      SOFT_RESET_GO2_SOFT_RESET_N                 = 0xBF,
      IDENTIFICATION_MODEL_ID                     = 0xC0,
      IDENTIFICATION_REVISION_ID                  = 0xC2,

      OSC_CALIBRATE_VAL                           = 0xF8,

      GLOBAL_CONFIG_VCSEL_WIDTH                   = 0x32,
      GLOBAL_CONFIG_SPAD_ENABLES_REF_0            = 0xB0,
      GLOBAL_CONFIG_SPAD_ENABLES_REF_1            = 0xB1,
      GLOBAL_CONFIG_SPAD_ENABLES_REF_2            = 0xB2,
      GLOBAL_CONFIG_SPAD_ENABLES_REF_3            = 0xB3,
      GLOBAL_CONFIG_SPAD_ENABLES_REF_4            = 0xB4,
      GLOBAL_CONFIG_SPAD_ENABLES_REF_5            = 0xB5,

      GLOBAL_CONFIG_REF_EN_START_SELECT           = 0xB6,
      DYNAMIC_SPAD_NUM_REQUESTED_REF_SPAD         = 0x4E,
      DYNAMIC_SPAD_REF_EN_START_OFFSET            = 0x4F,
      POWER_MANAGEMENT_GO1_POWER_FORCE            = 0x80,

      VHV_CONFIG_PAD_SCL_SDA__EXTSUP_HV           = 0x89,

      ALGO_PHASECAL_LIM                           = 0x30,
      ALGO_PHASECAL_CONFIG_TIMEOUT                = 0x30,
    };

    enum VL53L0X_vcselPeriodType { VcselPeriodPreRange, VcselPeriodFinalRange };

    struct VL53L0X {
		uint8_t last_status; // status of last I2C transmission
		bool io_2v8;
		uint8_t address;
		uint32_t io_timeout;
		bool did_timeout;
		uint32_t timeout_start_ms;
		uint8_t stop_variable; // read by init and used when starting measurement; is StopVariable field of VL53L0X_DevData_t structure in API
		uint32_t measurement_timing_budget_us;	
	};
	
	/* TCC: Target CentreCheck
	   MSRC: Minimum Signal Rate Check
	   DSS: Dynamic Spad Selection */
	struct VL53L0X_SequenceStepEnables
	{
		bool tcc, msrc, dss, pre_range, final_range;
	};

	struct VL53L0X_SequenceStepTimeouts
	{
		uint16_t pre_range_vcsel_period_pclks, final_range_vcsel_period_pclks;
		uint16_t msrc_dss_tcc_mclks, pre_range_mclks, final_range_mclks;
		uint32_t msrc_dss_tcc_us,    pre_range_us,    final_range_us;
	};

	void VL53L0X_setAddress(struct VL53L0X* dev, uint8_t new_addr);
    bool VL53L0X_init();

    void VL53L0X_writeReg(struct VL53L0X* dev, uint8_t reg, uint8_t value);
    void VL53L0X_writeReg16Bit(struct VL53L0X* dev, uint8_t reg, uint16_t value);
    void VL53L0X_writeReg32Bit(struct VL53L0X* dev, uint8_t reg, uint32_t value);
    uint8_t VL53L0X_readReg(struct VL53L0X* dev, uint8_t reg);
    uint16_t VL53L0X_readReg16Bit(struct VL53L0X* dev, uint8_t reg);
    uint32_t VL53L0X_readReg32Bit(struct VL53L0X* dev, uint8_t reg);

    void VL53L0X_writeMulti(struct VL53L0X* dev, uint8_t reg, uint8_t* src, uint8_t count);
    void VL53L0X_readMulti(struct VL53L0X* dev, uint8_t reg, uint8_t* dst, uint8_t count);

    bool VL53L0X_setSignalRateLimit(struct VL53L0X* dev, float limit_Mcps);
    float VL53L0X_getSignalRateLimit(struct VL53L0X* dev);

    bool VL53L0X_setMeasurementTimingBudget(struct VL53L0X* dev, uint32_t budget_us);
    uint32_t VL53L0X_getMeasurementTimingBudget(struct VL53L0X* dev);

    bool VL53L0X_setVcselPulsePeriod(struct VL53L0X* dev, enum VL53L0X_vcselPeriodType type, uint8_t period_pclks);
    uint8_t VL53L0X_getVcselPulsePeriod(struct VL53L0X* dev, enum VL53L0X_vcselPeriodType type);

    void VL53L0X_startContinuous(struct VL53L0X* dev, uint32_t period_ms);
    void VL53L0X_stopContinuous(struct VL53L0X* dev);
    uint16_t VL53L0X_readRangeContinuousMillimeters(struct VL53L0X* dev);
    uint16_t VL53L0X_readRangeSingleMillimeters(struct VL53L0X* dev);

    bool VL53L0X_timeoutOccurred(struct VL53L0X* dev);

    bool VL53L0X_getSpadInfo(struct VL53L0X* dev, uint8_t * count, bool * type_is_aperture);

    void VL53L0X_getSequenceStepEnables(struct VL53L0X* dev, struct VL53L0X_SequenceStepEnables * enables);
    void VL53L0X_getSequenceStepTimeouts(struct VL53L0X* dev, struct VL53L0X_SequenceStepEnables * enables, struct VL53L0X_SequenceStepTimeouts * timeouts);

    bool VL53L0X_performSingleRefCalibration(struct VL53L0X* dev, uint8_t vhv_init_byte);

    uint16_t VL53L0X_decodeTimeout(uint16_t value);
    uint16_t VL53L0X_encodeTimeout(uint16_t timeout_mclks);
    uint32_t VL53L0X_timeoutMclksToMicroseconds(uint16_t timeout_period_mclks, uint8_t vcsel_period_pclks);
    uint32_t VL53L0X_timeoutMicrosecondsToMclks(uint32_t timeout_period_us, uint8_t vcsel_period_pclks);

	void VL53L0X_startTimeout(struct VL53L0X* dev);
	bool VL53L0X_checkTimeoutExpired(struct VL53L0X* dev);

#endif