Learning Center

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 forUse
Network nameStarts with Reach:, for example Reach:C6:98. A renamed receiver shows its own name, for example Rover:C7:77.
Passwordemlidreach, unless someone changed it
  1. Open the tablet's Wi-Fi list

    See Join a Wi-Fi network if you're not sure how.

  2. Tap the receiver's network

    Look for the name in the table above.

  3. Type the password and tap Connect

    Type emlidreach (see Typing).

  4. 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.

  5. 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.

  6. 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.

The Home screen: nine workflow cards in the middle, and a column of six buttons down the right side: Home, Survey, Grade, Settings, Manual, and an orange Pre-Flight Checks
  1. 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.

The bottom of the Settings page: the About, DIG Module Firmware and Dealer Code boxes, and under them a rounded button labelled Emlid Diagnostics
  1. 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.

The bottom of the Settings page with the rounded Emlid Diagnostics button under the Dealer Code box
  1. 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.

The Emlid Diagnostics window over the Settings page, with a spinning circle and the words Looking for a Reach on this Wi-Fi…
  1. 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.

The Emlid Diagnostics window: Not connected to a Reach. Join the receiver's Wi-Fi hotspot (network name starts with Reach:, password emlidreach), then tap Retry. Buttons Open Wi-Fi settings and Retry
  1. Not connected to a Reach. The tablet is on another network.
  2. Open Wi-Fi settings. Opens the tablet's Wi-Fi list.
  3. 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.
Top of the Emlid Diagnostics window: Receiver, Reach RS3 · Rover, S/N ending C777, Firmware 33.1 · API 11.3, then a green tick and Configured as Ditch Assist Rover
The top of the window. The green line is the verdict: this receiver is set up as a cabled Rover.

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.

The Emlid Diagnostics window listing the receiver's settings, with a white Retry button and a green Configure button in its bottom right corner
  1. 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.

The Emlid Diagnostics window with three boxes: Base, Rover (picked, green border) and Lite Rover, each with a short description; below them the LoRa frequency (MHz) box with 902.000, and Back and Program receiver buttons 1 2 3
  1. Base. Sends RTK corrections over LoRa radio to the rovers. Sits on a tripod at a known or averaged point.
  2. Rover. For every setup that uses the Ditch Assist Control Module, and for DIG. Picked here because the receiver matched it.
  3. 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.

The Emlid Diagnostics window with Base picked. Under the LoRa frequency box: Send at 0.5 Hz instead of 1 Hz, three white buttons GPS, GLONASS and Galileo, and a hint to leave them off
  1. Base, picked. Its round button is filled in.
  2. 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.

The Emlid Diagnostics window with Lite Rover picked; under it the LoRa frequency (MHz) box shows 902.000; Back and Program receiver buttons at the bottom right
  1. 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.
The Emlid Diagnostics window with Lite Rover picked, and the green Program receiver button in its bottom right corner
  1. 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.

The Emlid Diagnostics window listing Programming and Verified lines for GNSS, Position output 1, Position output 2, Base output 1, Base output 2 and Correction input, then a spinning circle on Programming Role; the X in the corner is grey
  1. Verified, with a green tick. That part is written and checked.
  2. 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.

Top of the Emlid Diagnostics window after programming: Receiver, Reach RS3 · Rover, S/N ending C777, Firmware 33.1 · API 11.3, then a green tick and Programmed as Ditch Assist Lite Rover
Done: Programmed as Ditch Assist Lite Rover. The top line still says "Rover"; that's the receiver's own word for its job.

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.

The Emlid Diagnostics window after programming, with the white Retry button and the green Configure button at its bottom right
  1. 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.

Top of the Emlid Diagnostics window: Receiver, Reach RS3 · Rover, S/N ending C777, Firmware 33.1 · API 11.3, then a green tick and Configured as Ditch Assist Lite Rover
The receiver now matches the Ditch Assist Lite setup.

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

RowWhat it shows (example)
RoleBase or rover, plus power on via data port if it switches on with the control module: rover · power on via data port
Base coordinatesHow 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 2Where a base sends corrections: LoRa with frequency, air rate and power, or off
RTCM3 messagesThe messages a base sends: 1006 @0.1, 1074 @1, 1084 @1, 1094 @1
Correction inputWhere a rover gets corrections: LoRa with frequency, air rate and power: lora 902.000 MHz · 18.23 · 20 dBm
GNSSGPS+GLONASS+Galileo · 5 Hz · elev 15° · SNR 35 · tilt off
Position output 1, Position output 2Where 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.
Loggingraw 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.

  1. 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.

  2. Set that one part in Emlid Flow

    Follow the receiver setup guide for the part named in red only.

  3. 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 on Reach:… 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?

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.