Quelltext der Seite TIM-UP-19k-S3-ETH Offset Calibration

===TIM-UP-19k-S3-ETH Offset Calibration===

The TIM-UP-19k-S3-ETH currently supports nine different modulation frequencies which calibration data can be stored for. Among others the camera can calibrate its distance offset. These compensation values are stored in the register map from address 0x00C1 on. In order to activate compensation, set Bit 13 in Register ImgProcConfig (0x01E0). Offset compensation values can be set manually. Every modulation frequency must be treated seperately.

'''Preparation for offset calibration'''

# Place your TIM-UP-19k-S3-ETH coplanar in front of a uniform white target
# Info: the measuring is done on a 4x4 pixel window in the center of the field of view
# Avoid extreme environmental light conditions or avoid light completely
# Plug in the TIM-UP-19k-S3-ETH's power cable and control interface connection
# Adjust the integration time in register 0x0005 in order to have an amplitude in the center of the image of approximately 1000-3000
# Measure the distance between the sensor surface and the uniform white target and write it in [mm] into register RealWorldXcoordinate (0x0020)
# Set the desired modulation frequency at which the TIM-UP-19k-S3-ETH should be calibrated; possible values to write into register ModulationFrequency (0x0009):
#:*0 or 5     ... 5MHz
#:*1 or 5,63  ... 5.63MHz
#:*2 or 6,43  ... 6,43MHz
#:*3 or 7,5   ... 7.5MHz
#:*4 or 9     ... 9MHz
#:*5 or 11,25 ... 11.25MHz
#:*6 or 15    ... 15MHz
#:*7 or 22,5  ... 22.5MHz
#:*8 or 45    ... 45MHz
# Wait for all the above changes to take effect: two frame times (1 / frame rate)
# Wait for temperature to level off if the modulation frequency was changed

'''For automated calibration offset calculation proceed with:'''
# Place the calibration command in register: write 0x0013 into register 0x000F
# Poll register CalibrationExtended (0x0021)
# When finished, the CalibrationExtended register should read 0x00A1
# For any other status/error code in CalibrationExtended, please refer to the software user manual
# In order to repeat offset calibration for a different modulation frequency, restart at step 7

'''For manual offset adjustment proceed with'''
# Check the measured distance in the center of the image. We suggest to average the distance over some frames.
# Compare the measured distance with the real one and calculate the difference (offset = real distance - measured distance).
# Write the offset as signed integer into one of these registers, depending on the modulation frequency it is meant to be for:
#:*5MHz ... 0x00C1
#:*5.63MHz ... 0x00C2
#:*6.43MHz ... 0x00C3
#:*7.5MHz ... 0x00C4
#:*9MHz ... 0x00C5
#:*11.25MHz ... 0x00C6
#:*15MHz ... 0x00C7
#:*22.5MHz ... 0x00C8
#:*45MHz ... 0x00C9
# Check how the distance in the data interface changes
# In order to repeat offset calibration for a different modulation frequency, restart at step 7

'''In order to preserve the offset calibration beyond a device reset, the whole register map must be saved to flash:'''
# Write 0x4877 into register 0x0022
# Wait for at least two frame times (1 / frame rate)
# Write 0xdd9e into register 0x0033
# After a short time the operation is finished and the result is stored in register 0x0034; in case of a success it reads 0x0001 (otherwise, please refer to the software user manual)