
The system uses SteamVR Base Stations as optical beacons, enabling the Crazyflie to calculate its position onboard with sub-decimeter accuracy and millimeter-level precision.
The base stations contain spinning drums that sweep laser planes across the room. The Crazyflie, or any device equipped with a light receiver (a photodiode), can measure the angle between itself and the base station.
Using multiple receivers, the Crazyflie can determine its own position and orientation relative to the base station. Knowing the base station’s position and orientation in the room then gives the Crazyflie an absolute position.
The lighthouse system uses Lighthouse base stations as beacons. Two generations are supported: V1 and V2.
Lighthouse V1 uses two rotating drums while V2 uses one drum with two slanted light planes. V1 supports up to 2 base stations; V2 is designed for up to 16. The Crazyflie firmware currently supports up to 4 base stations by default, with more available through custom firmware configuration. V2 is the recommended and actively developed option in the Crazyflie ecosystem.
| Characteristics | Lighthouse V1 | Lighthouse V2 | Note |
|---|---|---|---|
| Range | ~6m | 6m | Lighthouse V1 range depends on the environment. V2 range is 6m by specification. |
| Positioning rate | 30Hz (2 base stations) | ~50Hz | V2 rate is independent of the number of base stations |
| Num. base stations | 1 - 2 | 1 - 4 | V2 can support up to 16 in hardware, configurable in the Crazyflie-firmware build |
| Horizontal angle of view | 120° | 150° | |
| Vertical angle of view | 120° | 110° |

To measure position and orientation, the Crazyflie needs to know the position and orientation of each base station in the room. This is called the system geometry.
Geometry setup is done through the Cfclient. The client can automatically estimate and store the geometry on the Crazyflie. The geometry can also be saved to a file and written to multiple Crazyflies, making it straightforward to fly a swarm in the same tracked space.
As an optical system, the Lighthouse requires direct line of sight from the Crazyflie to at least one base station. The range and field of view of the base stations define the tracked volume.
Due to the geometry of the Lighthouse positioning deck , the tracking will work best up to ~50 cm below the base station height.
In a 5x5 meter space, we have measured a relative precision better than 1 mm and an absolute accuracy better than 10 cm. This means that coming back to a take-off/landing pad can be achieved with millimeter precision. At the corners of the space, the precision may vary by a few centimeters.
This is an indoor-only positioning system. It is not designed for outdoor use, and since it is using infrared light, performance can be degraded by direct sunlight.
To use the Lighthouse positioning system, the Lighthouse positioning deck must be installed on every Crazyflie that needs to be tracked.
At least two Lighthouse V2 Base Stations must be installed in the room.
To get started, follow the Getting started with the Lighthouse system tutorial. It will guide you from zero to having your Crazyflie autonomously flying in your space.
For more in depth information, please see the documentation for the Lighthouse system in the crazyflie-firmware repository.