# Head Tracker v2.2

[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/donate?hosted_button_id=NMU3B9Z82JB3A) [![Join the Discord chat](https://img.shields.io/discord/827622724565467196?style=flat-square)](https://discord.gg/ux5hEaNSPQ)

### Welcome to the Head Tracker Project!

If you're an RC enthusiast with a FPV headset, at some point you might have thought wouldn't it be cool if you could turn your head and the camera would follow. That is the intention of this project.

There are a few ways to get started with this project you will need one of the supported boards. There are two more since v2.1, see [hardware-required](https://headtracker.gitbook.io/head-tracker-v2.2/getting-started/hardware-required "mention") for the choices.

{% hint style="info" %}
Some users have reported bad drift on this version. If you have this issue either revert back to v2.1 or try the development builds (see note below). I think the issue was found but more feedback is needed.
{% endhint %}

{% hint style="info" %}
This v2.2 release has issues running the most recent Nano 33 BLE **Revision 2 boards**. Both the Sense and no-Sense variants. If you own one of these boards it's still in development. You will have to download them here until a release is ready.\
\
Please see the [git-workflow-and-actions](https://headtracker.gitbook.io/head-tracker-v2.2/support/development/git-workflow-and-actions "mention")on how to download the development builds if you don't want to compile yourself.\
\
**Shortcut links**\
**-** You must be logged into GitHub to download the artifacts(compiled files)\
\- Most recent ones are at the top of the list\
\
[Firmware - Master (Development) Branch](https://github.com/dlktdr/HeadTracker/actions/workflows/build-firmware.yml?query=branch%3Amaster+event%3Apush)\
[Windows GUI - Master (Development) Branch](https://github.com/dlktdr/HeadTracker/actions/workflows/build-gui_win.yml?query=branch%3Amaster+event%3Apush)\
[Linux GUI - Master (Development) Branch](https://github.com/dlktdr/HeadTracker/actions/workflows/build-gui_linux.yml?query=branch%3Amaster+event%3Apush)\
MacOS GUI builds - Currently Offline. It needs updating.
{% endhint %}

### Features

* All sensors are already included on the supported boards
* Directly communicate with Bluetooth radios. Taranis X9d+2019, Horus X10, Taranis QX7S, Taranis, etc.. Both PARA and Bluetooth Trainer wireless is supported as of V2.0+&#x20;
* Bluetooth wireless link is available using a second board. It acts like a FRSky remote and outputs PPM or SBUS. For those that don't have a PARA transmitter and want wireless.
* No switch to reset zero is needed. Can use the proximity sensor with the [BLE Sense](https://store.arduino.cc/usa/nano-33-ble-sense) or the [BLE Sense Rev 2](https://store-usa.arduino.cc/collections/boards/products/nano-33-ble-sense-rev2) and just place your hand over it.
* Physical reset zero switch is available on the head or remote board.
* A reset zero event can be configured by rolling your head from one side to the other, so no switch is needed.
* A reset zero event can be configured to send a pulse on a specified output channel. This can be interpreted by the Radio to play an audio track like "camera recentered".
* No compiling code. A flash uploader is included in the GUI with ready to go firmware online.
* Calibration is easily done in the GUI with wizard and visual feedback.
* Gyrometer is calibrated every time the board is still.
* PPM Output signal is completely configurable so it will work with many radios. <mark style="color:red;">**Spektrum DX users**</mark> please read this [dx18](https://headtracker.gitbook.io/head-tracker-v2.2/radio-setup/spektrum/dx/dx18 "mention")
* PPM Input, overrides the channels of your choice and outputs via PPM or Bluetooth (The Arduino Nano Series of the boards is **3.3v Only** please verify your PPM signal level before connecting, see [ppm-input](https://headtracker.gitbook.io/head-tracker-v2.2/getting-started/wiring/ppm-input "mention"))
* PPM input can be input from the remote or the head board&#x20;
* SBUS output from either head or remote boards
* Ability to mount in any orientation with board rotation see [general](https://headtracker.gitbook.io/head-tracker-v2.2/settings/gui-settings/general "mention") there is a video to set it properly.
* 4x PWM Outputs on the Arduino Nano Series
* 4x Analog inputs on the Nano33, 3x Analogs on the DTQ board
* USB Joystick Output. Allows use of channels 1-8 as a HID joystick device. You can setup to receive PPM/Bluetooth from your radio and use it on your favorite simulator if your radio doesn't already support a simulator.
* SBUS Input
* CRSF Input and Output
* WebBLE based interface to configure some settings in the field with your phone. Use this web page to configure <http://www.headtracker.net>. **Hold down the center button and press reset once** to force the board Bluetooth head mode if you don't have it enabled. See [webble](https://headtracker.gitbook.io/head-tracker-v2.2/settings/webble "mention")for more information.

<figure><img src="https://1791219135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FifYnTDP7IFJCZallDj96%2Fuploads%2FwZoFkQ7d8ftnIet3bm4c%2Fimage.png?alt=media&#x26;token=999f97be-1a99-45d5-8561-696aa415d864" alt=""><figcaption></figcaption></figure>

### What's next on the list to support

* XIAO board support.&#x20;
  * This board is nice and small, it doesn't have a magnetometer but works well enough still. It can be used a receiver board instead of another Nano.
  * Wasn't quite ready for v2.2 but you can try it by checking out the development version [git-workflow-and-actions](https://headtracker.gitbook.io/head-tracker-v2.2/support/development/git-workflow-and-actions "mention")
* Board orientation needs to be simplified
  * It's not straight forward right now to mount the board in an odd orientation. This can be improved with a procedure using the accelerometer to rotate the frame pointing down, then some kind of motion (look up, look down) which can then determine what forward is.

## Don't want to assemble one, Buy a ready to go kit

### Medlin Drone - Head Tracker and various mounts for drones

![](https://1791219135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FifYnTDP7IFJCZallDj96%2Fuploads%2FgSPcTQ4nIAxeONhv6EYA%2Fimage.png?alt=media\&token=35731307-543e-4225-9c38-0a22d3a4ec63)

{% embed url="<https://medlin-drone-store.myshopify.com/products/pre-built-head-tracker>" %}

### Motionsic - Head Tracker and a nice Gimbal too.

![](https://1791219135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FifYnTDP7IFJCZallDj96%2Fuploads%2F83Vm3ZSXXzVW4S6luYve%2Fimage.png?alt=media\&token=acd22f1e-2523-4e5b-b43b-26f58439ed09)

{% embed url="<https://fpvdogfight.com/collections/products>" %}
