How to use Litchi Hub with DJI Fly (for drones with no SDK support)

Many consumer drone models aren’t supported by the DJI SDK, making them incompatible with Litchi Pilot.

To work around this limitation, we’ve added a new feature to the Litchi Hub: the ability to export KMZ files. This lets you plan waypoint flights for any DJI drone that supports waypoint mode in the DJI Fly app.

Supported drone models:

  • Air 3 & Air 3S
  • Mavic 3, Mavic 3 Classic & Mavic 3 Pro
  • Mavic 4 Pro
  • Mini 4 Pro (has SDK support so we recommend flying with Litchi Pilot instead)

Step-by-Step Guide

1. Plan your flight in the new Litchi Hub

Head to https://hub.flylitchi.com/ to plan your waypoint flight, then export it to KMZ in the flight settings


2. Create a waypoint flight in DJI Fly

  1. Open the DJI Fly app (drone connection not required)
  2. Enter the Camera View then tap on the Plan Waypoint Flight button
  3. Place 2 waypoints on the map, preferably near the same location as the Litchi Hub flight
  4. Tap on History button then Save the waypoint flight
  5. Close the DJI Fly app

Internally, this will create a .kmz file in the DJI Fly app storage on your mobile device.


3. Locate and replace the DJI Fly KMZ File

  1. Using a file explorer, go to:
Android: Android/data/dji.go.v5/files/waypoint
iOS:     DJI Fly/wayline_mission
  1. Locate the latest folder that was created in the above location, then inside you will find the KMZ file created by DJI Fly.

  2. Rename the KMZ file exported by the Litchi Hub to the same name as the KMZ created by DJI Fly. Then replace the DJI KMZ with the Litchi Hub KMZ


5. Load the Flight in DJI Fly

If you now go back to the DJI Fly app, and load the same waypoint flight you created earlier in the app, it will load the Litchi Hub waypoint flight!

Current limitations of the DJI Fly waypoint mode:

  • Curved turns are not supported
  • Only one “Take Photo”, “Start Recording”, or “Stop Recording” action is allowed per waypoint
  • Tilt Camera action is treated as a transition (not a standalone action)
  • Rotate Drone, Bottom Lights, and Panorama actions are not supported
  • Photo Interval is not supported — start manually if needed
  • Locked heading and gimbal modes are not supported

Why not Mini 4 Pro? Should work the same.

You could use this procedure with the Mini 4 Pro, but the Mini 4 Pro is already supported in the MSDK so you don’t need to go through this procedure.

Would that not equate to acquiring Litchi Pilot, and pay for the software all over again? I don’t have Litchi Pilot since I never had a Mini 3 series drone.

Yes, directly flying a Litchi mission with a Mini 4 Pro would require that you use the new Litchi Pilot app. If I’m not mistake, it is currently freely available since it is still in beta.


I downloaded a kmz file from hub 2.0 and used this technique to run a waypoint mission on my Air 3s. It flew a straight line mission without the usual rounding added by DJI. The drone also stopped at each waypoint. Is this the expected behavior?

I have previously used this technique with kmz files produced by Litchi mission utilities and a Hub 1.0 csv file. Those waypoint missions had the typical DJI rounding.

It is if your path mode is set to straight lines. If you sent the path mode to “Smooth Curves”, you should get your expected behavior:
Capture

Thanks for the quick reply! I did have “path mode” set to “straight” because when I set the path mode to “curved turns”, the export dialogue replied “kmz export does not support curved turns flight mode”. I had set the “drone model” to “other” and “Smooth Curves” was not an option so I used curved turns. When I set “drone model” to Air 3S, the “smooth curves” option was available. I was then able to download the kmz file!

What is the difference between smooth and curved turns?

By the way, the “straight lines” option eliminated the danger of the drone descending lower than the waypoint!

You should see the difference when selecting between the two with an appropriate drone model. “Curved” is used by the Litchi engine where “Smooth” is used by the DJI engine.

I have encountered the same problem. Since I use DJI fly I have to export to kmz but it does not allow me to export the routes with “curves” at the waypoints, but only those with “soft curves” or “straight lines”. However, with the old cvs to kmz conversion system it accepted the “curves” at the waypoints and even in DJI fly you could see the track with the curves. Soft curves are difficult to control because the route can drop too much in altitude or widen too much where it shouldn’t.

You will need to explain what you mean by “soft curves” as that term is not used by either Litchi or DJI.

DJI Fly waypoints only support curved paths that pass through each waypoint. As a result, it is possible for the flight path to become lower (or higher) than an adjacent waypoint. It is also possible for DJI Fly to fly a straight line mission. However, such a mission must be loaded via a KMZ file as there is no way to select the path mode from within DJI Fly.

Sorry “Smooth Curves”..

Ok. I understand now. What Litchi is calling “Smooth Curves” is referring to DJI’s method of making the flight path pass through each waypiont. Litchi’s method places a straight flight path between each pair of waypoints with the option to use curves at the locations of the waypoints.

Each method has their advantages and disadvantages. As you point out, DJI’s method may allow the flight path to become lower (or higher) than any of the waypoints used to create the path.

As DJI does not support Litchi’s style of curved flights, one cannot export that kind of path into a DJI KMZ file. Your only choices will be either straight lines or smooth curves.