Herelink Manual
- Android based smart device with 5.46 inch 1080P capacitive touch screen.
- Integrated digital transmission system simultaneously transmitting video, telemetry and control.
Herelink HD Video Transmission System Custom Solex TX and QGC ground station software with MAVlink support for Ardupilot and PX4.
- Dual hall effect self centering gimbals with removable sticks.
- 1080P HD video with dual digital video inputs.
- Dual S.bus signal output for simultaneous control of autopilot and pan/tilt cameras.
- 6 customizable Mavlink buttons and Mavlink/SBus hardware wheel.
- RC gimbal control on dedicated service independent of Solex TX / QGC.
- Tether and share video and telemetry via Wi-Fi ground station such as Mission Planner.
- Onboard Arm Cortex A53 & Cortex A53 SOC in both air and ground units for custom applications.
Technical specifications
Ground & Air Unit:
Feature | Specification |
---|---|
SOC: | ARM Cortex A53 4 core 2.2GHz + Cortex A53 4 core 1.4GHz |
Image Processing: | Mali-T860 GPU |
SDR: | A7 + DSP |
Memory: | Air Unit: LPDDR3: 1GB, Ground Station: LPDDR3: 2GB, EMMC: Air / Ground 4GB |
Transmission Distance: | FCC 20km CE / SRRC 12km Image transmission delay: ≤ 110ms Image transmission: 720p@30fps 1080p@30 / 60fps transmission,signal bandwidth 20MHz / 10MHz |
Frequency Band: | 2.4GHz ISM Receive sensitivity: -99dBm@20MHz BW Interference recovery: < 1s |
Ground Station:
Herelink – Ground Station
Feature | Specification |
---|---|
Screen: | 5.46 inch 1080P, 16 million colors, capacitive touch screen |
Audio: | Built-in speaker × 1, built-in microphone × 2 |
Remote control: | Hall affect gimbals with removable sticks x 2, scroll wheel × 1, bottom button × 6 with backlight, top button × 1 (right) |
Wireless: | Bluetooth (disabled) / WIFI / GPS / 2.4G map transmission ground |
Inputs: | MicroUSB × 1, Micro SD × 1 (supports maximum 64GB) |
Antenna: | Circular (5dBi) × 1, detachable, omnidirectional (2dBi) × 1, detachable,built-in wifi antenna, built-in GPS antenna, external GPS antenna interface x 1 |
Power : | Built-in 4950 mAh Lipo Battery |
Charging : | Support micro USB port 5v 2A current charging |
Power consumption: | The average power consumption does not exceed 4W (only picture transmission work, medium screen brightness, WiFi off, GPS off) |
Size: | 217 × 106.5 × 31mm not including external antenna and rocker |
Air Unit:
Feature | Specification |
---|---|
Video Input: | Micro HDMI x 2: Input for external camera video,supports 720P 30fps & 1080P 30/60fps |
Power Input: | 2 Pin interface x 1: Recommended supply voltage ~7V: minimum 6V: maximum 12V and avoid sharing BEC with servos, the average power consumption of the single-sided module is less than 4W |
Telemetry: | 3 Pin interface x 1:3.3V / 5V level UART interface Mavlink Compatible |
USB: | 4 Pin interface x 1: Two 3.3V level RC output connectors (S.bus in phase, S.bus inverting or PPM signal output, ground terminal control) |
Antenna: | Micro USB x 1: for debugging upgrades, support OTG mode |
Size: | MMCX antenna jack x 2: used for signal transmission and ground communication 78.5x30x13mm |
How To Update Firmware
Hex Aero Herelink HD Video Transmission System can be updated on PC, Mac and Linux as per the below process. Newer firmware versions allow you to update the Herelink remote via wifi from with-in the settings app, this is only available if you have the Solex TX app installed.
-
Connect the Herelink Remote unit to your PC via USB.
-
Put the Herelink Remote Unit into Fastboot by pressing Power and D button simultaneously while turning on.
-
-
Extract and Run the application packaged inside the zip file.
-
After Remote Unit upgrade is complete the Unit will automatically restart once finished.
-
Herelink Remote Unit will boot up with Activation window, follow the steps below to continue.
Herelink Activation
- Connect Herelink to your WiFi connection from the settings menu
- Select your region then click ‘Proceed’
- You will then be prompted to input your 16 digit software activation key.
- Once input click ‘done’ the ‘Register’ and your device will then download the latest software and update itself.
Herelink Remote Update Via Wifi
- Make sure you Herelink is connected to wifi and has an internet connection available
- Pull down from the top and select the settings cog in the top corner
- Scroll to the bottom and click the ‘About phone’ option
- Select ‘System Update’
- Select ‘CHECK FOR UPDATE’ in the bottom corner
- The system will now check for an update and install it automatically
Herelink Remote Update Update Error
- You are connected to stable wifi
- The device time is correct
- You entered the correct Key
Pairing, RC Calibration & Setup
The following tutorial will guide you through the steps to setup and calibrate the Herelink system.
ProfiCNC Herelink HD Video Transmission System has a dedicated system settings app for the setup and configuration of the Herelink RC control and radio system.
- Pair The Air Unit
- See Radio & System Status
- Calibrate the RC
- Set RC Mode & Throttle Settings
- Calibrate HW Wheel and Set Channel
- Set Radio Regional Settings
- Configure Sbus Buttons
Video Overview Of Herelink Setup
Herelink Settings App
- From App Launcher slide down the notification drawer from the top
- Select Herelink Setting
- The settings app will open
Pairing with Air Unit
- Tap Pair button and then hold the
Pair/Reset
button on Air Unit untilLED2
blinks.
Joystick and HW Wheel Calibration
- Swipe left to access the joystick screen.
- See RC Calibration Status
- Calibrate Hardware Wheel
- Calibrate Sticks
- Set RC Stick Mode
- Set Hardware Wheel Sbus Channel & Bus
- Reverse RC Channel
- Set Throttle Centre Behavior
Step 1: Calibrate the hardware wheel
- Select ‘HW WHEEL CAL’.
- Click ‘Start rollwheel’ and follow the calibration steps
- Note once complete you can check its correct functioning by looking at the values change, click Pass to return to joystick screen
- Once calibration is complete you can set the Sbus channel output and Bus output for the wheel on the highlighted settingsBus 1 is the same output as the sticks and the wheel can be set to channels 5 – 16, on bus 2 the wheel can be set to channels 1 -16.
- Once complete click ‘SAVE’ to store settings.
Step 2: Calibrate the joysticks
- Click ‘HW JS CAL’
- This screen is split into 2 sections, joystick calibration on the left, joystick testing on the bottom right, instructions for the user to follow will be shown in the green box. Click ‘Start Calibration’ to begin the process and follow the instructions in the green box and the sick movement arrows located around the sticks on the remote as highlighted in red below.
- Once the joystick calibration step is complete the input test area in the red box will activate, follow the instructions above it to test the sticks input are functioning correctly by aligning the black and red circles in each step shown. This will test the joysticks are moving correctly in all axises.
- At the end of this process if you are happy with the input behaviour you can click ‘Pass’ and the calibration will be stored, if you’re experiencing any issues click ‘Fail’ and start the calibration process again using a little more pressure in the corners.
Step 3 RC Mode Selection , Throttle Behavior & Channel Reversing
- Set throttle center and RC mode via the below settings.
- The stick sbus output can be reversed by clicking on ‘REV’ next to the channel you want to change.
- After making any changes click ‘SAVE” to store settings.
Step 4 Calibrate SBUS Output
- To calibrate the joystick SBUS outpiuts click ‘SBUS OUT CAL’.
- Follow the RC stock movement steps as shown in the highlight section moving the stick through each position.
- Once complete click ‘SAVE” to store settings.
Selecting FCC/CE settings
Configure Modes & Mavlink Buttons
- Mode Selection
- Arm/Disarm
- Servo Output Control
- Relay Control
- HW Wheel Channel Mapping
- App Specific Commands
Autopilot Mode Selection
Home Button
Button Configuration
- Tick the box next to the desired button
- Click on drop down to select function
- Open Solex TX App
- Click 3 line in top left corner
- Select ‘Button Mapping’ as above
Configure Sbus Buttons & Wheel
Sbus Outputs
Button Modes Available
- Toggle = Output latches between two pwm values with a short or long press option.
- Momenty = Output changes to active value when pressed and held, returns to default when released.
- Multi = Sends command for channel to go to preset pwm value. Multi buttons can be stacked on both short and long press as well as multiple buttons configurations to allow channel outputs to range in values.
Profiles
Sbus Button Configuration
Share video Stream
1. Enable the video stream on Herelink
2. Connect over Wifi Tethering
3. Connect over USB tethering
4. Connect via Wifi Connection
- If Herelink is connected over wifi, you can get video stream using IP of Herelink on the network.
5. Display the video stream
- Open VLC and go to File >> Open network
Connecting to Mission Planner
For enabling video stream in Herelink settings please refer Share video Stream
You are now connected to the Herelink HotSpot Wifi.
Mavlink
You are now connected to the same wifi network as the Herelink is.
Mavlink
- Open Mission Planner
- Set the port to ‘UDPCL’ (top right)
- Click ‘Connect’
- Enter the IP of the Herelink controller Find your IP
- Enter port ‘14552’
To view live Herelink video in Mission Planner
- Start Solex or QGC to ensure your video is working (this is required to start the streaming process)
- Right click the HUD
- Select ‘Video’
- Select ‘Herelink Video’
- The first time you do this Mission Planner may need to download the files required to play the video. Your device will require and internet connection to be able to do this, you may need to disconnect from the Herelink hotspot to perform this step
Installing a custom app
- Enable Developer Mode by tapping
Settings
->About Phone
->Build Number
multiple times. - Enable
Settings
->Developer options
->USB debugging
- Check if the unit is connected
$ adb devices
List of devices attached
66c4bfea device
- Install app using
adb install <app_name>.apk
$ adb install myapp.apk
Performing Streamed Install
Success
$ adb remove org.myorg.appname
Success
OEM Image Setup
Linux
- Download and unzip following files:
- Remote Unit: oem_ru_base.img
- Air Unit: oem_au_base.img
- Ensure that you select the base image depending upon which unit you are modifying.
- Download and extract zips into same directory.
- Now to generate ext4fs image from the sparse image (.img) downloaded above do
./simg2img_mac oem_au_base.img raw_oem_au_base.img
- Create a mount point directory using
mkdir oem
- Mount the image using
mount raw_oem_au_base.img oem
- Now you should be able to modify files inside the mount directory.
- You need to use
sudo
to be able to do any writes the files inside the mount point. - Once you have made your changes, you need to unmount your drive using command
sudo umount oem
- Afterwards convert the ext4fs image back to android sparse image using command
./img2simg raw_oem_au_base.img oem_au.img
- Now you may flash this image into Herelink Air Unit, by putting it under bootloader using command
adb reboot bootloader
- And finally to flash to image run command
fastboot flash oem oem_au.img
- Check example below for a sample modification.
MacOS
- Setup osxfuse in your system using
brew cask install osxfuse
, this will require rebooting your system proceed and do that. - Follow the steps here to install fuse-ext2. This will allow you to mount ext4fs we will be generating.
- Download and unzip following files:
- Remote Unit: oem_ru_base.img
- Air Unit: oem_au_base.img
- Ensure that you select the base image depending upon which unit you are modifying.
- Download and extract zips into same directory.
- Now to generate ext4fs image from the sparse image (.img) downloaded above do
./simg2img_mac oem_au_base.img raw_oem_au_base.img
- Create a mount point directory using
mkdir oem
- Mount the image using
fuse-ext2 raw_oem_au_base.img oem -o rw+
- Now you should be able to modify files inside the mount directory.
- You need to use
sudo
to be able to do any writes the files inside the mount point. - Once you have made your changes, you need to unmount your drive using command
sudo umount oem
- Afterwards convert the ext4fs image back to android sparse image using command
./img2simg raw_oem_au_base.img oem_au.img
- Now you may flash this image into Herelink Air Unit, by putting it under bootloader using command
adb reboot bootloader
- And finally to flash to image run command
fastboot flash oem oem_au.img
Example Config Change
- In the following example we change the system_id used by herelink air unit for board specific messages.
- Most config files are located in you unit at
/system/etc
in the following example we will pull config using commandadb pull /system/etc/system-control.telepathy-air.conf
- Once pulled the file will contain information like bellow:
# module on/off
board_control_enabled = true
d2d_tracker_enabled = true
camera_control_enabled = true
# board control
board_system_id = 42
# camera control
video_stream_ip_address = 192.168.0.10
camera_system_id = 42
support_multiple_camera = true
support_camera_capture = false
- You can change the value of
board_system_id
andcamera_system_id
fields as per your requirement in your favourite editor. - Once done save this file and exit editor.
- Create a folder inside oem image called
etc
using commandsudo mkdir oem/etc
- Copy file using command
sudo cp system-control.telepathy-air.conf oem/etc/
- Continue to unmount the image and flashing into the unit as described in above steps.
Example App Change
- In the following example we override the installed QGroundcontrol App.
- A new OEM app can be installed under /oem/app/<AppName>/<AppName>.apk
- For installing your custom version of QGroundcontrol, ensure that you started with https://github.com/cubepilot/qgroundcontrol-herelink as your base.
- After building the project, create a folder
QgroundControl
- Copy .apk file
cp -r build-qgroundcontrol-Android_for_armeabi_v7a_Clang_Qt_5_11_0_for_Android_armv72_fd6ff4-Debug/android-build/build/outputs/apk/android-build-debug.apk QGroundControl/QGroundControl.apk
- Also create a lib directory
QGroundControl/lib
- Copy libraries
cp -r build-qgroundcontrol-Android_for_armeabi_v7a_Clang_Qt_5_11_0_for_Android_armv72_fd6ff4-Debug/android-build/libs/armeabi-v7a/ QGroundControl/lib/arm/
- Finally move QgroundControl directory to oem image
sudo cp -r QGroundControl oem/app/QGroundControl
- Do ensure you have already created app directory inside oem image if not already done
sudo mkdir oem/app
- Continue to unmount the image and flashing into the unit as described in above steps.
- On boot several files are setup for use, and you can override these files
- These files can exist in (searched in this order)
- /data/oem/etc – user default – wiped on factory reset
- /oem/etc – oem default
- /system/etc – system default
- files that can be overridden (optimus is the internal GCS name, telepathy-air is the air unit (ro.product.device))
- lampsignal-telepathy-air.json
- rc_service_config_optimus.ini
- mavlink-router.optimus.conf
- system-control.optimus.conf
Generate a bug report
- Follow this tutorial…
- Connect the Herelink remote to your computer with an USB cable
- Open the terminal of you computer then enter the command :
adb bugreport
> press enter The above command will generate the bureport and save zip file on the device, the path will be mentioned in the output of command (copy the path to use it in step 3) - Send the zip file to you computer by using the command :
adb pull
- Contact your reseller or Hex / Proficnc to send the bug report zip file. The bug report must be accompanied by detailed information on what happened: which application is causing the problem, the description of the issue, under which conditions, specific settings you made, video, photos, etc…., and all informations that could help staff to reproduce or understand the issue.
Herelink FAQ
Herelink - Register Failure
-Wi-Fi 5.8GHz
-IP Address Not in range 192.168.0.x
-Region Select the correct region and within 5mins difference
* Please check and fulfil three requirements, otherwise register failure as a result
Herelink - Solex as Autostarting App
Herelink - Screenshot
Herelink - Video / Camera
- Canon EOS M3_________Stock/out of the box settings
- GoPro 3_______________Stock/out of the box settings
- GoPro 4_______________Stock/out of the box settings (NO LONGER WORKS)
- GoPro 5_______________Stock/out of the box settings
- GoPro 7_______________Stock/out of the box settings
- GoPro 8_______________Stock/out of the box settings (with its Media Module)
- Go Pro Hero 10 Black ____Works with media mod
- ZCam E1______________Stock/out of the box settings
- Foxeer Box2___________Specific settings
- Flir Duo Pro____________Stock/out of the box settings
- Sony AS200V___________Stock/out of the box settings
- Sony NEX-3N___________Stock/out of the box settings
- Sony a5100____________Stock/out of the box settings
- Sony A6000____________Stock/out of the box settings
- Sony A6300____________Stock/out of the box settings
- Sony A7R______________Stock/out of the box settings
- Sony A7Rii_____________Stock/out of the box settings
- Sony RX1Rii____________Stock/out of the box settings
- Sony RX0 mki___________Stock/out of the box settings
- Sony RX100VI___________Stock/out of the box settings
- Sony HX50_____________Stock/out of the box settings
- Sony HX60V____________Stock/out of the box settings
- Sony HDR-CX450_______Stock/out of the box settings
- Sony HDR-PJ620_______Stock/out of the box settings
- Sony HDR-CX440_______Stock/out of the box settings
- Foxeer HS1223__________Set resolution to 1080p 30fps with Foxeer app
- Foxtech Seeker 30 max___Stock/out of the box settings
- Waltter move 500________Stock/out of the box settings
- Hawkeye Firefly split 4k___Stock/out of the box settings (firmware 20190926 works – better than others)
- Firefly Q6______________Stock/out of the box settings
-Mapir Survey 3__________Stock/out of the box settings - Optris PI-Series_________Stock/out of the box settings (via companion computer with MS Windows)
- EKEN H9R_____________Stock/out of the box settings
- Black Magic micro cinema_Stock/out of the box settings
- NextVision cameras with TRIP2 accessory_Stock/out of the box settings
- Foxtech FH310Z
- Panasonic GH6__________Stock/out of the box settings
- Sony FX6 (1080P mode)
Cameras HDMI is fully working with HereLink including full camera control via airpixel controller - Tarot TL10X-T2D________Stock/out of the box settings
************ Not Working ****************************************
- Workswell Wiris Mini
- Workswell Wiris and Wiris 2nd Generation
- Xiaomi Yi
- Foxtech SEEKER 30x-HD