This thread has been locked.

If you have a related question, please click the "Ask a related question" button in the top right corner. The newly created question will be automatically linked to this question.

CCS/OPT3101: Close range issue, Can't read less than 3 meters

Part Number: OPT3101

Tool/software: Code Composer Studio

I am using OPT3101 dev board but wired up to external most MCU over I2C channel of the board. Currently I am running OPT3101  without any calibration and cross talk correction. I am getting good stable readings with larger subframes but for some reason the closest range I am getting is no less than 3 meters.

Question 1: Is the issue of not able to read range less than 3 meters related to not using board calibration values?

Question 2: Since board calibration value is stored in on board MSP430 host at factory calibration, is there a way to pull those values out of onboard MSP430 host ?

Question3: if OPT3101 dev board is use with external MCU with out calibration and correction what should be the expected accuracy and range?

Question 4: I  am using configuration generated by OPT3101 Configuration Tool and want to use OPT3101 in Monoshot mode. But activation monoshot via monoshot_bit  in a register is not working as per documentation in section 7.3.1.2. The monoshot_bit do not reset at the end of the cycle. I found a post with similar issue. (e2e.ti.com/.../756598 Can you please confirm?

/*
Copyright (c) 2018 Texas Instruments Incorporated
All rights reserved not granted herein.
Limited License.  
Texas Instruments Incorporated grants a world-wide, royalty-free, non-exclusive license under copyrights and patents it now or hereafter owns or controls to make, have made, use, import, offer to sell and sell ("Utilize") this software subject to the terms herein.  With respect to the foregoing patent license, such license is granted  solely to the extent that any such patent is necessary to Utilize the software alone.  The patent license shall not apply to any combinations which include this software, other than combinations with devices manufactured by or for TI (TI Devices).  No hardware patent is licensed hereunder.
Redistributions must preserve existing copyright notices and reproduce this license (including the above copyright notice and the disclaimer and (if applicable) source code license limitations below) in the documentation and/or other materials provided with the distribution
Redistribution and use in binary form, without modification, are permitted provided that the following conditions are met:
*	No reverse engineering, decompilation, or disassembly of this software is permitted with respect to any software provided in binary form.
*	any redistribution and use are licensed by TI for use only with TI Devices.
*	Nothing shall obligate TI to provide you with source code for the software licensed and provided to you in object code.
If software source code is provided to you, modification and redistribution of the source code are permitted provided that the following conditions are met:
*	any redistribution and use of the source code, including any resulting derivative works, are licensed by TI for use only with TI Devices.
*	any redistribution and use of any object code compiled from the source code and any resulting derivative works, are licensed by TI for use only with TI Devices.
Neither the name of Texas Instruments Incorporated nor the names of its suppliers may be used to endorse or promote products derived from this software without specific prior written permission.
DISCLAIMER.
THIS SOFTWARE IS PROVIDED BY TI AND TI's LICENSORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL TI AND TI'S LICENSORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/


#include "OPT3101device.h"


/* OPT3101 device initialization Sequence Header file written by OPT3101 Calibration tool - Version 0.9.1
By: Pritesh Patel
On: 2020-05-27 13:19:28
Configuration Settings:
{
	"genDeviceI2CMasterConnection": 1,
	"autoHDRMode": true,
	"monoshotMode": true,
	"TX0HCurrent": 0,
	"monoshotModeNFramesPerShot": 1,
	"genDeviceI2CMasterTempSensor": false,
	"TXDCCurrent": 0,
	"superHDRMode": false,
	"LEDOrder": 0,
	"timeStamp": 2020-05-27 13:19:22,
	"genDeviceAmbientSupport": 0,
	"freqComp": false,
	"monoshotModePowerupDelay": 153,
	"user": pritesh patel,
	"autoHDRRatio": 4.0,
	"multiLEDMode": true,
	"genDeviceEEPROMConnection": false,
	"toolVersion": 0.9.1,
	"crc": 1905640516,
	"autoHDRHThreshold": 25500,
	"genDeviceAvgFrameCount": 8,
	"monoshotModeDeepSleep": false,
}
*/
void OPT3101::device::initialize(void){
	// List of registers to initialize OPT3101 device after power-up

	this->reg.tg_ovl_window_start = 7000; // //Overload flab observation window
	this->reg.en_temp_conv = 1; // //Enables the internal

	this->reg.clip_mode_fc = 1; // //Enables Clip mode for Frequency correction
	this->reg.clip_mode_temp = 0; // //Disables Clip mode for Temp coff phase correction
	this->reg.clip_mode_offset = 0; // //Disables Clip mode for phase offset correction
	this->reg.iq_read_data_sel = 3; // //Enables 16 bit frame counter
	this->reg.iamb_max_sel = 0; // //Sets maximum ambient support
	this->reg.en_temp_corr = 1; // //Enables Temperature Correction
	this->reg.gpio1_obuf_en=1; // //Enabled output buffer on GPIO1 pin
	this->reg.gpo1_mux_sel=2; 	    // //select dig_gpo_0 on gpio1
	this->reg.dig_gpo_sel0 = 9; 	// //Select Data Ready on dig_gpo_0

	this->reg.monoshot_mode=3; // //Sets monoshot mode
	this->reg.dis_glb_pd_refsys=1; // Disables deep sleep PWRDN for blocks
	//this->reg.dis_glb_pd_temp_sens=1;
	//this->reg.dis_glb_pd_illum_drv=1
	//this->reg.dis_glb_pd_afe=1;
	//this->reg.dis_glb_pd_afe_dac=1;
	this->reg.dis_glb_pd_amb_dac=1;
	this->reg.dis_glb_pd_amb_adc=1;
	this->reg.dis_glb_pd_osc=1;
	//this->reg.dis_glb_pd_i2chost_osc=1;
	this->reg.MONOSHOT_NUMFRAME=1; // //Sets number of frames to me measured per trigger
	this->reg.powerup_delay=95; // //Power-up delay for every monoshot trigger

	this->reg.num_sub_frames = 511; // //Sub frames count
	this->reg.num_avg_sub_frames = 511; // //Average frames count
	this->reg.xtalk_filt_time_const = 1; // //Crosstalk filter time constant
	this->reg.tg_seq_int_start 	= 9850; // //Sequence Start
	this->reg.tg_seq_int_end 		= 9858; // //Sequence End
	this->reg.tg_seq_int_mask_start 	= 511; // //Same as AvgFrame Count
	this->reg.tg_seq_int_mask_end 	= 511; // //Same as AvgFrame Count

	this->reg.hdr_thr_high = 25500; // //High Threshold
	this->reg.hdr_thr_low = 5875; // //Low Threshold
	this->reg.en_adaptive_hdr = 1; // //Enables adaptive HDR feature

	this->reg.illum_dac_h_tx0 = 31; // //High Current settings [173.6mA:5.6mA X 31]
	this->reg.illum_scale_h_tx0 = 0; // //Illum scale for H [173.6mA:5.6mA X 31]

	this->reg.illum_dac_l_tx0 = 31; // //High Current settings [043.4mA:1.4mA X 31]
	this->reg.illum_scale_l_tx0 = 3; // //Illum scale for H [043.4mA:1.4mA X 31]

	this->reg.tx_seq_reg   = 0; // //Setting TX Switching order
	this->reg.en_tx_switch = 1 ; // //Enable TX Switching order

	this->reg.tg_en = 1; // //Enables Timing Generator

	this->configurationFlags_xtalkFilterTau =  1; // //This is not a register but a settings flag for the SDK
	this->configurationFlags_monoshotMode =  true; // //This is not a register but a settings flag for the SDK
	this->configurationFlags_xtalkSettlingOneTauInMilliSeconds      =  256; // //This is not a register but a settings flag for the SDK
	this->configurationFlags_xtalkSettlingOneTauInDataReadyCounts   =  2; // //This is not a register but a settings flag for the SDK
	this->configurationFlags_frameTimeInMilliSeconds                =  128; // //This is not a register but a settings flag for the SDK
	this->configurationFlags_avgFrameCountExponentOfTwo             =  9; // //This is not a register but a settings flag for the SDK

}

OPT3101::device::device(void):
configurationFlags_isTXChannelActive{true,false,false},
configurationFlags_isRegisterSetActive{true,true} {}

OPT3101::calibrationC::calibrationC(void) : calibrationC(true) {
	this->recordLength           = 2; // //This configuration requires 2 crosstalk and other configuration record(s)
	this->registerAddressListSize= 25; // //This configuration requires 25 registers [800] bits to be stored for calibration
	this->EEPROM_connected       =  false; // //This configuration helps configure EEPROM
	this->extTempSensor_connected=  false; // //This configuration helps configure Ext temp sensor
	this->registerAddressList[0] = 0x2f; // //Address for register(s) iphase_xtalk_reg_hdr0_tx0
	this->registerAddressList[1] = 0x30; // //Address for register(s) qphase_xtalk_reg_hdr0_tx0
	this->registerAddressList[2] = 0x38; // //Address for register(s) temp_coeff_xtalk_iphase_hdr0_tx0
	this->registerAddressList[3] = 0x39; // //Address for register(s) temp_coeff_xtalk_qphase_hdr0_tx0
	this->registerAddressList[4] = 0x42; // //Address for register(s) phase_offset_hdr0_tx0
	this->registerAddressList[5] = 0x47; // //Address for register(s) tmain_calib_hdr0_tx0,tillum_calib_hdr0_tx0
	this->registerAddressList[6] = 0x45; // //Address for register(s) temp_coeff_main_hdr0_tx0
	this->registerAddressList[7] = 0x46; // //Address for register(s) temp_coeff_illum_hdr0_tx0
	this->registerAddressList[8] = 0x31; // //Address for register(s) iphase_xtalk_reg_hdr1_tx0
	this->registerAddressList[9] = 0x32; // //Address for register(s) qphase_xtalk_reg_hdr1_tx0
	this->registerAddressList[10] = 0x5e; // //Address for register(s) temp_coeff_xtalk_iphase_hdr1_tx0
	this->registerAddressList[11] = 0x60; // //Address for register(s) temp_coeff_xtalk_qphase_hdr1_tx0
	this->registerAddressList[12] = 0x51; // //Address for register(s) phase_offset_hdr1_tx0,temp_coeff_illum_hdr1_tx0
	this->registerAddressList[13] = 0x48; // //Address for register(s) tmain_calib_hdr1_tx0,tillum_calib_hdr1_tx0
	this->registerAddressList[14] = 0x2d; // //Address for register(s) temp_coeff_main_hdr1_tx0
	this->registerAddressList[15] = 0x52; // //Address for register(s) temp_coeff_illum_hdr1_tx0
	this->registerAddressList[16] = 0x2e; // //Address for register(s) illum_xtalk_reg_scale
	this->registerAddressList[17] = 0x3a; // //Address for register(s) scale_temp_coeff_xtalk
	this->registerAddressList[18] = 0x71; // //Address for register(s) shift_illum_phase
	this->registerAddressList[19] = 0x43; // //Address for register(s) en_phase_corr,en_temp_corr,scale_phase_temp_coeff
	this->registerAddressList[20] = 0xb5; // //Address for register(s) scale_amb_phase_corr_coeff
	this->registerAddressList[21] = 0x0c; // //Address for register(s) amb_phase_corr_pwl_coeff0
	this->registerAddressList[22] = 0xb4; // //Address for register(s) amb_phase_corr_pwl_coeff1,amb_phase_corr_pwl_coeff2,amb_phase_corr_pwl_coeff3
	this->registerAddressList[23] = 0xb8; // //Address for register(s) amb_phase_corr_pwl_x0,amb_phase_corr_pwl_x1
	this->registerAddressList[24] = 0xb9; // //Address for register(s) amb_phase_corr_pwl_x2

}

  • Hi Pritesh,

    Without any calibration the device will not give useable data. Phase offset is needed for for correct distance readings and crosstalk needs to be corrected especially when the amplitude is not extremely high. The OPT3101EVMs are all calibrated, why not load the calibration? I don't think I will be able to provide much help on a board before it has calibration loaded due to all the potential issues due to lack of cal.

    Best,

    Alex

  • Hi Alex,

    Is calibration saved in OPT3101 registers, if so which are the calibration registers I can load and try?

    I tried use_xtalk_reg_int, use_xtalk_reg_illum, & en_auto_freq_count but I am not seeing any difference. From the documentation of OPT3101EVM it seems like calibration is saved on MSP430 host MCU on the EVM and I am using external MCU. Is the a way to read calibration values from MSP430 MCU?

  • Hi,

    Yes it is stored in the flash. I would advise to use latte software with EVM to configure the EVM and load cal to OPT3101 registers. Then you can use latte to read all the register from the device (readAllRegisters.py) and then write these with your MCU.

    Best,

    Alex

  • Thanks Alex,

    Unfortunately I have cut I2C, GP1, GP2 and sync_reset traces between MSP and OPT3101 on OPT3101 EVM board so that I can connect OPT3101 to an external MCU through the onboard header. And these traces are very tiny to solder bridge again so that I can connect EVM board to a PC to get registers in Latte software.

    I will have to by a second OPT3101 EVM board to read out register values and try them out. Thanks.