Check and program a Reach with Emlid Diagnostics
The Emlid Diagnostics button at the bottom of Settings reads an Emlid Reach RS3 or RS4 over its own Wi-Fi, tells you which Ditch Assist job it is set up for, and sets it up as a Base, Rover or Lite Rover. Every tap, with a close-up.
In the app Settings › Emlid Diagnostics
Emlid Diagnostics is a button in the Ditch Assist® app. It checks how an Emlid Reach RS3 or RS4 receiver is set up and, if it's wrong, sets it up for you. The tablet talks to the receiver over the receiver's own Wi-Fi. No cables, no Emlid Flow.
A Reach can do one of three jobs in a Ditch Assist system. The app calls them:
- Base: the receiver on the tripod. It sends corrections to the others over its radio.
- Rover: the receiver on the implement, plugged into a control module or DIG™ module with the GPS cable.
- Lite Rover: the receiver on the implement for Ditch Assist Lite. No cable: the tablet reads it over Wi-Fi.
What each job writes to the receiver is on Configure an Emlid Reach. You don't need to know it to use this page.
Before you start
Time: about 5 minutes per receiver.
- The Reach is switched on and charged. It must be an RS3 or RS4: the app can read other models but can't set them up.
- Automatic grading is stopped. The app won't change a receiver while it's grading.
- You know your radio frequency: a number between 902 and 928, the same on the base and every rover. If this is your first base, pick one in that range and write it down.
- Location is switched on in the tablet's pull-down panel (see The pull-down panel), and the tablet is close to the receiver.
First, join the receiver's Wi-Fi
Each Reach makes its own small Wi-Fi network, called a hotspot. The tablet joins it the same way it joins any Wi-Fi. If you've never joined a Wi-Fi network on the tablet, Join a Wi-Fi network shows every tap.
| The tablet asks for | Use |
|---|---|
| Network name | Starts with Reach:, for example Reach:C6:98. A renamed receiver shows its own name, for example Rover:C7:77. |
| Password | emlidreach, unless someone changed it |
Open the tablet's Wi-Fi list
See Join a Wi-Fi network if you're not sure how.
Tap the receiver's network
Look for the name in the table above.
Type the password and tap Connect
Type
emlidreach(see Typing).If the tablet warns about the internet, tap Always connect
The receiver's Wi-Fi has no internet. That's normal. Tell the tablet to stay on it.
Tablet with a SIM card: turn mobile data off
Otherwise Android sends the app's traffic over the phone network, and the app can't find the receiver.
Go back to the Ditch Assist app
Press Back until the app is on screen (see The Back button).
Check the receiver
Tap Settings
Start on the Home screen. If you're somewhere else, tap Home at the top of the column of big buttons down the right side of the screen.
In that same column, Settings is the fourth button from the top, with a gear symbol. Tap it. The Settings page opens: one long page of white boxes.
- Settings. Fourth button down the right side, with a gear.
Scroll to the bottom of Settings
Put a finger on the middle of the screen and slide it up. Do it again until the page stops moving (see Scrolling).
You're at the bottom when the last white box is Dealer Code. Under it, in the middle, is a rounded button with a satellite symbol: Emlid Diagnostics.
- Dealer Code. The last white box on the Settings page. When you see it, you're at the bottom.
Tap Emlid Diagnostics
It's the rounded button with a satellite symbol, in the middle under the Dealer Code box. Tap it. A window called Emlid Diagnostics opens in the middle of the screen.
- Emlid Diagnostics. The very last button on the Settings page.
Wait while it looks for the receiver
For a second or so the window shows a spinning circle and Looking for a Reach on this Wi-Fi…
. The app is reading the receiver's settings.
- Looking for a Reach on this Wi-Fi…. Reading the receiver.
If it says Not connected to a Reach
The tablet isn't on the receiver's Wi-Fi yet. Tap Open Wi-Fi settings, the white button at the bottom of the window. The tablet's Wi-Fi list opens: join the receiver's network (see First, join the receiver's Wi-Fi).
Press Back to return to the app. Then tap Retry, the green button in the bottom right corner of the window. The app looks for the receiver again.
- Not connected to a Reach. The tablet is on another network.
- Open Wi-Fi settings. Opens the tablet's Wi-Fi list.
- Retry. Looks for the receiver again.
Read what it found
At the top of the window is the receiver: its model and job (here Reach RS3 · Rover), serial number and firmware.
Under that is one line in colour, the verdict. It tells you whether the receiver matches a Ditch Assist setup:
- Green tick, for example
Configured as Ditch Assist Rover
: it matches that setup. If that's the job you want, you're finished. Close the window with the X in its top right corner. - Amber, for example
Closest: Ditch Assist Rover — 3 settings differ
: the rows that differ are amber. Go on to the next step to set it up.
The word "Rover" in the top line is the receiver's own name for its job. It stays "Rover" on a Lite Rover too; the green line is the one to read.
Tap Configure
Do this when the verdict is amber, or green with the wrong job.
Configure is the green button with a wrench symbol, in the bottom right corner of the window. Tap it. The window changes to show three choices.
- Configure. Bottom right corner of the window.
Tap the job this receiver will do
Three boxes sit one above the other. The job it matched is already picked: its round button is filled in green. Tap the box you want:
- Base (top box): the receiver on the tripod.
- Rover (middle box): plugged into a control module or DIG module with the GPS cable. It turns on and off with the module.
- Lite Rover (bottom box): Ditch Assist Lite. The tablet reads it over its Wi-Fi.
The box you tap gets a green border and a filled round button.
1
2
3
- Base.
Sends RTK corrections over LoRa radio to the rovers. Sits on a tripod at a known or averaged point.
- Rover.
For every setup that uses the Ditch Assist Control Module, and for DIG.
Picked here because the receiver matched it. - Lite Rover.
On the machine, no control module. The tablet connects straight to the receiver over its Wi-Fi hotspot (Ditch Assist Lite).
Base only: don't tap the three "slow down" buttons
Skip this step for a rover.
When Base is picked, three small buttons appear under the words Send at 0.5 Hz instead of 1 Hz: GPS, GLONASS and Galileo. These do not turn the satellites on or off. All three satellite systems are always used; each button only slows that system's corrections from once a second to once every two seconds. Leave all three white (not tapped), as in the picture. If the radio can't keep up, the app slows one down by itself and tells you.
An RS4 base also shows LoRa power: tap 500 mW, or 1000 mW for more range. An RS3 has no power choice: it always sends at its maximum, 20 dBm.
- Base, picked. Its round button is filled in.
- GPS, GLONASS, Galileo. All white (not tapped) = all satellites used, corrections sent at full speed. Leave them like this.
Check the radio frequency
Under the three boxes is a box labelled LoRa frequency (MHz). It already shows the receiver's frequency, or the last one you used, for example 902.000.
It must be the same number on the base and on every rover. To change it, tap the box, delete the number and type yours, for example 915.000 (see Typing).
A Lite Rover has this box too: it sets the receiver to listen to your base.
A number outside the allowed band shows Enter a frequency between 902.000 and 928.000 MHz
. The limits come from the receiver; North American units allow 902 to 928.
- LoRa frequency (MHz). The same number on the base and every rover.
Tap Program receiver
Program receiver is the green button with a play symbol, in the bottom right corner of the window. Tap it. The app starts writing the settings to the receiver.
Back, to its left, returns to the receiver's settings list without changing anything.
If the app is using this same Reach as its GPS right now (Ditch Assist Lite), an amber note appears above the buttons first:
- For Lite Rover:
The app is connected to this receiver. The connection will drop for a few seconds while it is programmed, then reconnect.
- For Base or Rover: the receiver's Wi-Fi position output is turned off,
so the app will lose this receiver as a GPS source. Disconnect first, or reconnect to another source afterwards.
- Program receiver. Bottom right corner of the window.
Wait while it programs
Lines appear one after another, two for each part of the receiver's settings: Programming GNSS
, then Verified GNSS
with a green tick once the app has read it back. The parts go in this order: GNSS, Position output 1, Position output 2, Base output 1, Base output 2, Correction input, Role.
Leave the tablet alone. On an RS3 set up as a Lite Rover, the whole run took about 15 seconds. The X in the corner is grey: the window can't be closed while it's writing.
A part that doesn't take is tried again, up to three times: Retrying Correction input (2 of 3)…
.
On a Base, if the radio can't carry all three satellite systems once a second, the app slows one to 0.5 Hz and tries again (GLONASS first, then Galileo, then GPS): Radio cannot carry these rates — sending GLONASS at 0.5 Hz
.
- Verified, with a green tick. That part is written and checked.
- Programming Role. The last part, still being written.
Read the result
The app reads the receiver once more. The verdict turns green: Programmed as Ditch Assist Lite Rover
(or Base, or Rover).
The rows below now show the receiver's new settings. On a Lite Rover the row Position output 1 changes to tcpsvr :9001 NMEA · GGA 5 Hz, VTG 1 Hz.
If the app slowed the base, an amber note lists the rates, for example The radio could not carry 1 Hz on every constellation. Corrections now go out at: GPS 1 Hz · GLONASS 0.5 Hz · Galileo 1 Hz.
Tap Retry to check it once more
Retry is the white button beside Configure, at the bottom right of the window. Tap it. The app reads the receiver again from scratch.
- Retry. Reads the receiver again.
You should see Configured as Ditch Assist …
The verdict now reads Configured as Ditch Assist Lite Rover
(or Base, or Rover), with a green tick and no amber rows. The receiver is ready. Close the window with the X in its top right corner.
Next: for Ditch Assist Lite, connect from a workflow card (Connect to the Reach). For a cabled rover, mount it and plug in the GPS cable (On the machine).
Every line in the window, explained
You don't need this to set up a receiver. It's here for when support asks what a line says.
The top lines
The receiver's model and job (Reach RS3 · Rover), its serial number, and its firmware and API version. The job here is the receiver's own (rover or base); it doesn't change to "Lite Rover" when you set one up as a Lite Rover. The coloured verdict line below it names the Ditch Assist setup.
Notes the window can show
Ditch Assist is checked on firmware 33.1 and newer. Update this receiver in Emlid Flow.
(34.8 on an RS4.) The app still sets it up, but Emlid changes its rules between releases, so update first if you can.Programming is disabled on this receiver or firmware — use the Emlid Flow app.
The app can read it but won't change it. Set it up by hand with the receiver setup guide.Stop automatic grading before programming a receiver.
Configure stays grey until you stop.
The rows
| Row | What it shows (example) |
|---|---|
| Role | Base or rover, plus power on via data port if it switches on with the control module: rover · power on via data port |
| Base coordinates | How a base gets its position, averaging time, antenna height: single-and-hold · 120 s · antenna 1.934 m (on a rover this is just the mode, not coordinates) |
| Base output 1, Base output 2 | Where a base sends corrections: LoRa with frequency, air rate and power, or off |
| RTCM3 messages | The messages a base sends: 1006 @0.1, 1074 @1, 1084 @1, 1094 @1 |
| Correction input | Where a rover gets corrections: LoRa with frequency, air rate and power: lora 902.000 MHz · 18.23 · 20 dBm |
| GNSS | GPS+GLONASS+Galileo · 5 Hz · elev 15° · SNR 35 · tilt off |
| Position output 1, Position output 2 | Where the position goes and which NMEA. Cabled Rover: serial UART 38400 NMEA · GGA 5 Hz, VTG 1 Hz. Lite Rover: tcpsvr :9001 NMEA · GGA 5 Hz, VTG 1 Hz. Output 2 is usually bluetooth NMEA · GGA 1 Hz, VTG 1 Hz. |
| Logging | raw on · autostart on. Amber when raw logging is off; leave it recording. |
NTRIP addresses and logins are never read or shown.
The buttons
- Retry: reads the receiver again.
- Configure: opens the three job choices (Base, Rover, Lite Rover).
- Switch base power to 1000 mW (or to 500 mW): only on an RS4 that is already a Ditch Assist base. Changes only the radio power, in one tap.
Programming stopped
If one part of the settings still won't take after three tries, the app stops there rather than leave the receiver half set up. The window shows Programming stopped
and The receiver did not accept one of the settings after 3 attempts. Finish this in the Emlid Flow app, then come back to verify.
The part that failed is in red, for example Failed Base output 1
, with the receiver's own error message under it. The parts above it are done.
Tap Copy details
A message along the bottom of the screen says
Details copied
. If you contact support, paste the details into your email: they list the receiver, its firmware and every step.Set that one part in Emlid Flow
Follow the receiver setup guide for the part named in red only.
Tap Back
The app reads the receiver again. You can also close the window and open Emlid Diagnostics again.
If the window says A different receiver answered — the tablet may have joined another Reach hotspot. Nothing was written. Reconnect and try again.
, the tablet jumped to another receiver's Wi-Fi. Join the right receiver's network and start again.
If it doesn't work
Not connected to a Reach
although you joined its Wi-Fi: the tablet may have dropped back to another network. Check the tablet is still onReach:…and tap Retry. On a Samsung tablet, turn off Switch to better Wi-Fi networks in the Wi-Fi settings, under Intelligent Wi-Fi (step by step: Wi-Fi keeps dropping). More: Fix Ditch Assist Lite problems.- Configure is grey: automatic grading is running, or the app can't set up this receiver (use Emlid Flow and the receiver setup guide).
- Frequency refused: type a number between 902 and 928, for example
915.000. - Stops on the same part every time: update the receiver's firmware in Emlid Flow and try again, or set that part by hand.
- Rover set up, but no RTK: is the base on the same frequency, and sending? See Corrections troubleshooting.
Did this answer your question?
Thanks. That tells us which pages to improve.
Still stuck? Talk to a product specialist. 1-833-DITCH-AS · support@ditchassist.com · Monday to Friday, 8 a.m.–5 p.m. Central.
Calling about a problem? Send your app logs first so support can see what happened.