Application of TF-Luna IIC in PixHawk1 (ArduPilot Firmware)

TF-Luna can be used with PixHawk1 for the purpose of obstacle avoidance and Altitude Hold. But because it’s a short range sensor so in most cases it is used for obstacle avoidance.

TF -Luna Settings :

Note: If there are any spikes while using the LiDAR as obstacle avoidance sensor then it is advised to change the frame rate to 250Hz, see the command details having command ID as 0x03 in the manual and for the sake of convenience configuring other parameters (like setting frame-rate, changing address etc.) in UART mode is recommended if you don’t have IIC-USB converter. A simple UART-USB adapter or board should work.

At the time of writing this document latest firmware was 3.3.0. For firmware upgrade please contact our technical support.

The default communication of TF-Luna is UART. LiDAR comes with a single cable. In order to use IIC, the cable needs a little modification, details are mentioned in the coming paragraph. Please see TF-Luna IIC communication pin details as below:

If we look at the pin configuration of TF-Luna, IIC can be set by grounding pin-5 in addition to the other four pins . For this purpose a customized cable is needed because in IIC mode we need to connect both pin-4 and pin-5 to the ground.

The modified cable is shown below. I have connected green wire (pin-4) and blue wire (pin-5) to single pin which will go to the GND pin of the source. Leave pin-6 connected. Please ignore the color standard in this case as black wire represents RXD/SDA while yellow wires represents TXD/SCL, just follow the pin numbering according to the user-manual.

TF-Luna, TFmini-S, TFmini-Plus and TF02-Pro can be interfaced with IIC port of PixHak1 flight controller. Their settings are almost same. We take two TF-Luna LiDARs as example and set the address 0x08 and 0x09 separately.

PixHawk Connection:

![|644x281](file:///C:\Users\wyt99\AppData\Local\Temp\ksohtml24992\wps9.jpg) We take PixHawk1 flight controller as an example:

Figure 1 : Schematic Diagram of Connecting TF- Luna to I 2 C Interface of PixHawk

Note:

Default cable sequence of TF-Luna and PixHawk are different, please change it accordingly (SDA and SCL wires need to be interchanged). Look at the pinout of controller, pin configurations are starting from left to right :

IIC connector should be purchased by user

If TF-Luna faces down, please take care the distance between lens and ground, it should be larger than TF-Luna’s blind zone (20cm)

If more TF-Luna need to be connected (10 LiDARs are supported), the method is same.

Power source should meet the product manual demands:5V±0.5V, larger than 150mA (peak current)*number of TF-Luna

Parameters settings :

Common settings:

AVOID_ENABLE= 2 [if 3 = UseFence and UseProximitySensor doesn’t work in IIC then choose 2 = UseProximitySensor ]

AVOID_MARGIN=4

PRX_TYPE=4

Settings for first TF-Luna :

RNGFND1_ADDR=08 [Address of #1 TF-Luna in decimal]

RNGFND1_GNDCLEAR=25 [Unit: cm, depending upon mounting height of the module and should be larger LiDAR than non-detection zone]

RNGFND1_MAX_CM=400 [It could be changed according to real demands but should be smaller than
effective measure range of LiDAR, unit is cm]

RNGFND1_MIN_CM=30 [It could be changed according to real demands and should be larger than
LiDAR non-detection zone, unit is cm]

RNGFND1_ORIENT=0 [#1 TF-Luna real orientation]

RNGFND1_TYPE = 25 [TF-Luna IIC same as TFmini-Plus IIC]

Settings for second TF-Luna:

RNGFND2_ADDR=09 [Address of #2 TF-Luna in decimal]

RNGFND2_GNDCLEAR=25

RNGFND2_MAX_CM=400

RNGFND2_MIN_CM=30

RNGFND2_ORIENT=25 [#2 TF-Luna real orientation]

RNGFND2_TYPE=25 [TF-Luna IIC same as TFmini-Plus IIC]

Upon setting of these parameters, click [Write Params] on the right of the software to finish the process.

If the error message “Bad LiDAR Health” or “Bad Proximity” appears, please check if the connection is correct and the power supply is normal.

![|486x366](file:///C:\Users\wyt99\AppData\Local\Temp\ksohtml24992\wps11.jpg)How to see the target distance from the LiDAR: press Ctrl+F button in keyboard, the following window will pop out:

Click button Proximity , the following window will appear:

The number in green color means the distance from LiDAR in obstacle avoidance mode(the number only refresh when this window opens, closes, zooms in or zooms out, it doesn’t mean the real time distance from LiDAR and will not be influenced in Mission Planner The mission planner version at the time of writing this tutorial was v1.3.76.

3 Likes

update pls… it doesnt work on mine…

I had this exact same setup and it doesnt work.
I have already updated the firmware of the Luna and I also was able to correctly connect via UART. I have seen other posts and most people do need to modify the output through an arduino or something similar before using it .
Are there not any commands that need to be sent or any arrangement to the Luna configuration that wasnt specified in here?