Every on-screen message explained
What each error, warning and prompt in the app means and what to do about it: 255 messages, grouped by where they appear, each linked to its fix.
Every message the Ditch Assist® app (v1.5.4) shows that an owner might need to act on, grouped by where it appears. Each one gives what it means, what to do, and a link to the full fix. Tap a group to open it. Quickest way in: type a few words of the message into the search box at the top, or use your browser's Find on this page. Words in quotes are exactly as the app shows them; … or N stands for a name or number the app fills in.
Connection and Wi-Fi22 messages · Shown when you connect, or as a red message when a connection drops.
Could not detect a Ditch Assist module. Connect tablet WiFi to the module and try again.
Means: Nothing answered on the tablet's current Wi-Fi.
Do: Join the module Wi-Fi (password 12345678) and tap Connect again. More
Detecting connected module...
Means: Connect is trying each module type in turn.
Do: Wait a few seconds. More
Could not connect to controller. Check WiFi and try again.
Means: The control module didn't accept the connection.
Do: Check the Wi-Fi name and that no other device is joined, then tap Connect. More
Could not reach the DIG module. Check WiFi and retry.
Means: The tablet can't reach the DIG module; the app keeps retrying.
Do: Join MECU_Ditch_Dig (12345678) and check the module has power. More
Tap a workflow card on the Home screen to connect.
Means: The Wi-Fi icon doesn't connect.
Do: Connect from a workflow card or Pre-Flight Checks. More
Designed for a different kit
Means: The connected kit doesn't fully fit this workflow (Excavation on the control module, a scraper workflow on DIG, or Excavation in Lite mode).
Do: Read the note, then Continue Anyway or Pick Different. More
This workflow is designed for the Ditch Assist Control Module, which drives hydraulics on a scraper or grader. The DIG module you're connected to is GNSS-only…
Means: DIG can't move hydraulics; this workflow gives survey and visual guidance only.
Do: Continue Anyway for guidance, or Pick Different and choose Excavation. More
The Excavation workflow is designed for DIG, or for a Ditch Assist Control Module that is being fed by … excavator sensors.
Means: On a control module without excavator sensors, depth follows the GPS antenna, not the bucket.
Do: Pick Different unless the machine has excavator sensors. More
In Ditch Assist Lite the app follows the Emlid Reach antenna, not the bucket tip — there are no excavator sensors…
Means: Readings are only right with the arm in the position you calibrated in.
Do: Continue Anyway and check grade between cuts in that position. More
Your tablet may drop this Wi-Fi
Means: Samsung's "Switch to better Wi-Fi networks" is on and will leave the hotspot every few minutes.
Do: Tap Open Wi-Fi settings and turn that switch off. More
This tablet is set to leave Wi-Fi networks that have no internet. The … hotspot has no internet, so the tablet can disconnect from it every few minutes.
Means: Same notice, full text.
Do: Turn off Switch to better Wi-Fi networks in the tablet's Wi-Fi settings (steps on the linked page). More
No data from controller for Ns — connection lost.
Means: Nothing came from the module for 10 seconds, so the app closed the connection. It retries every 2 s while the tablet stays on the same Wi-Fi.
Do: Check module power and the Wi-Fi name; if it doesn't come back in a few seconds, reconnect from Home. More
Cannot reach the controller. It may be holding a stale connection from a previous session — power-cycle the controller (toggle its power switch for ~5 seconds) and try again from Home.
Means: Five reconnect tries failed.
Do: Switch the module off for 5 seconds and on, wait 30 s, reconnect. More
Wi-Fi changed during reconnect — controller link lost. Reconnect from Home.
Means: The tablet joined another network, so the app stopped retrying.
Do: Rejoin the module Wi-Fi and reconnect from Home. More
Network unavailable — connection to controller lost.
Means: The tablet has no Wi-Fi at all.
Do: Turn Wi-Fi on, rejoin the module and reconnect. More
Connection lost unexpectedly.
Means: The connection dropped with no recorded reason (a second line, if shown, is the technical reason).
Do: Check power and Wi-Fi, reconnect; send logs if it repeats. More
Connection lost
Means: System Check: nothing is connected any more.
Do: Check module power and Wi-Fi, go back and connect. More
Not connected
· No source
· OFFLINE
Means: Pre-Flight Checks: no controller, receiver or simulator connected.
Do: Tap Connect. More
Weak
· Fair
Means: Wi-Fi Signal row (after the dBm reading): weak is below −88 dBm, fair is −81 to −88.
Do: Bring the tablet closer; give the module a clear view of the cab. More
Stop grading before switching mode.
Means: Settings won't change between Ditch Assist and Ditch Assist Lite during automatic grading.
Do: Tap Stop on the Grade screen, then switch. More
Switch mode? Switching mode disconnects the current source.
Means: Changing mode disconnects everything and clears the workflow.
Do: Tap Switch, then reconnect for the new mode. More
GPS and RTK22 messages · The GPS badge, Pre-Flight Checks and System Check rows, and survey card lines.
NO GPS
Means: GPS badge, red: the receiver has no position.
Do: Check receiver power, cable and sky view. More
No GPS signal detected
Means: System Check: no position after 10 seconds.
Do: Check the receiver output, power and Status 2 light. More
Waiting for signal...
· Waiting for fix
Means: System Check or Pre-Flight Checks is waiting for the first position.
Do: Give it a few seconds; if it stays, check the receiver. More
No GPS fix
Means: No usable position right now; Start and calibrate are refused.
Do: Fix the GPS feed, wait for green RTK. More
GPS: STALE — position not updating
Means: No new position within GPS Delay Timeout (5 s).
Do: Check receiver power and cable, and the Wi-Fi link. More
Stale data
· Signal stale (no updates)
Means: Pre-Flight / System Check: positions stopped arriving.
Do: Same as GPS stale. More
GPS position has not updated for Ns. Check the receiver, or drive a few feet.
Means: Survey card: Start is off because GPS is stale.
Do: Check the receiver; with a control module, move a little. More
GPS data is STALE (auto-hold active)
Means: DEBUG box in Settings: GPS is stale and grading is on hold.
Do: Get the GPS feed back; it releases by itself. More
FLOAT
Means: GPS badge, yellow: corrections arriving, no RTK fix yet.
Do: Wait for green RTK before surveying or grading. More
DGPS
Means: GPS badge, orange: differential fix only, about a metre.
Do: Check corrections; John Deere StarFire may need RTK Filter off. More
PPP
Means: GPS badge, yellow: satellite correction service, not RTK.
Do: Use RTK corrections for grade work. More
FLOAT — grading accuracy reduced
· DGPS — grading accuracy reduced
· GPS — grading accuracy reduced
Means: System Check: you're connected but not on RTK Fixed.
Do: Wait for RTK Fixed before working. More
RTK: Unstable
Means: Fewer than 70% of recent fixes were RTK Fixed.
Do: Check the base, correction link and sky view. More
Not reported
Means: Corrections row: the app can't confirm corrections are arriving.
Do: Check the base or correction source. More
RTK Filter is ON and this receiver reports DGPS. Turn off RTK Filter (Settings > Survey) to survey with it. Tap here to open Settings.
Means: The receiver never reports RTK Fixed, so survey is blocked.
Do: Only for receivers that report RTK as DGPS: turn RTK Filter off. More
DIG module is connected but sending no GPS data. Check power and the cable to the GPS receiver. Reconnecting…
Means: DIG's Wi-Fi is fine but the receiver sent nothing for 10 s.
Do: Check the stick receiver's power and cable. More
No Bluetooth devices found. Pair your receiver in Android Settings first.
Means: No paired Bluetooth receivers.
Do: Pair it in Android Bluetooth settings, then Rescan. More
Bluetooth permissions denied. Go to Android Settings to grant access.
Means: The app isn't allowed to use Bluetooth.
Do: Allow Nearby devices and Location for Ditch Assist, then Rescan. More
Failed to connect to …
Means: The Bluetooth receiver didn't accept the link.
Do: Check it's on and nothing else is connected, then Rescan. More
Scan failed: …
Means: The Bluetooth scan stopped with an error.
Do: Turn Bluetooth on and tap Rescan. More
Grading, holds and Start26 messages · Pills, banners and messages on the Grade screen.
HOLD — No RTK Fix
Means: Automatic hold: the fix isn't good enough to grade. Releases by itself.
Do: Check the receiver and base; wait for steady RTK. More
RTK LOST - AUTO HOLD (Ns)
Means: RTK has been lost this many seconds and the valve is held.
Do: Stop if it lasts; check the base and correction link. More
RTK LOST - GPS UNRELIABLE (Ns)
Means: You're on manual hold and the fix dropped.
Do: Don't grade by the numbers until RTK Fixed returns. More
HOLD — GPS Stale
Means: Automatic hold: positions stopped arriving. Releases by itself.
Do: Check the receiver and Wi-Fi link. More
AUTO HOLD - WAITING FOR HDOP ≤ N (NOW N) - SENSITIVITY …
Means: The hold is waiting for satellite geometry to improve.
Do: Wait; if it's all day, set RTK Sensitivity to Low. More
AUTO HOLD - WAITING FOR RTK FIX TO SETTLE - SENSITIVITY …
Means: RTK is back; waiting for it to stay steady.
Do: Wait a few seconds. More
AUTO HOLD - WAITING FOR STEADY RTK FIXED
Means: Low sensitivity: waiting for about 1 s of RTK Fixed.
Do: Wait; check the base if it keeps flipping. More
Auto Grading (Commands OFF)
Means: Guidance runs but no valve commands are sent.
Do: In the DEBUG box of Settings, turn Send Commands on. More
Hydraulic commands are turned off in Settings.
Means: Pre-Flight hydraulic test can't run.
Do: Turn Send Commands on. More
Stop auto grading before testing hydraulics.
Means: The hydraulic test is off while grading.
Do: Tap Stop first. More
If Raise moves down or Lower moves up, reverse the valve connectors.
Means: Reminder in the hydraulic test.
Do: If it's reversed, swap the two solenoid plugs. More
… from survey line — accuracy may decrease
Means: You're more than 30 m off the surveyed line.
Do: Drive back onto the line. More
GPS accuracy reduced — elevation readings may be unreliable
Means: Excavation: fix below RTK Fixed.
Do: Check depth between cuts until RTK returns. More
Stop Auto-Grading? Auto-grading is active. … will stop the controller and halt hydraulics.
Means: Leaving the Grade screen, loading data or opening the editor stops grading. Progress is saved.
Do: Tap Stay to keep grading, or the stop button to go on. More
Elevation Mismatch Warning
· Target Far From Current Ground
Means: The design target is far above or below you (check turned on in Pre-Start Safety).
Do: If it's feet, cancel and recalibrate. More
Far From Reference Point
Means: Manual Grade: you're more than 16 ft from the 0+00 reference.
Do: Go back to it, or set a new reference here. More
Ready to Start? Tapping START will lock this position as the 0+00 reference and begin grading.
Means: Manual Grade start point is about to be set.
Do: Lower the blade to the start point, then tap Start. More
Could not capture reference — GPS coordinates invalid. Try again.
Means: Bad GPS at the moment you started; nothing started.
Do: Tap Start again; check the GPS. More
GPS fix lost while confirming. Reference not captured — try again when GPS is back.
Means: GPS dropped while the Ready to Start box was open.
Do: Wait for the fix, tap Start again. More
Tap HOLD before switching the terrace target
Means: Channel/Berm can't switch while the valve drives the blade.
Do: Tap Hold, switch, tap Resume. More
Stop guidance before switching the target.
Means: Ditch Assist Lite: target can't switch while guidance runs.
Do: Tap Stop, switch, tap Start. More
RTK LOST — GUIDANCE PAUSED
· RTK LOST - GUIDANCE PAUSED (Ns)
Means: Ditch Assist Lite: guidance paused on RTK loss. Clears by itself.
Do: Wait; check the Reach's corrections. More
GPS STALE — GUIDANCE PAUSED
Means: Ditch Assist Lite: positions stopped.
Do: Check the Reach is on and the tablet on its hotspot. More
Switch Grading Mode? This will stop any active grading and clear the current design. Continue?
Means: Changing mode clears what's loaded.
Do: Save what you need, then Switch Mode or Cancel. More
Start New Session?
· Change Mode?
Means: Starting another workflow clears the work in memory. Saved files stay.
Do: Tap Start New to go on, or Cancel. More
Tiling14 messages · Tile design and tile install.
Lower N" to start
· Lower N cm to start
· Lower N ft to start
Means: Start stays off until the plow is within about 1 inch of design depth.
Do: Lower the plow that much. More
Blade must reach target depth before starting. Currently N above target.
Means: Start was tapped above depth.
Do: Lower the plow, then Start. More
Start at the Outlet
Means: You're in the inlet half of the line.
Do: Start at the outlet, or Start Anyway if you mean it. More
Tiling Mode — Operator Notice
Means: Once per session: grade control is RTK only, no plow pitch sensor.
Do: Read and acknowledge; check RTK and watch the depth guide. More
Grade below minimum near …
Means: The design is flatter than Min Grade there.
Do: Raise Max Depth, lower Min Grade, or change the outlet depth. More
Tile shallower than minimum depth near …
Means: The design goes above Min Depth there.
Do: Change the limits, outlet depth or transition. More
Tile deeper than maximum depth near …
Means: The design goes below Max Depth there.
Do: Raise Max Depth or change the outlet depth. More
Tile line runs uphill near …
Means: Water wouldn't drain through that stretch.
Do: Check the outlet end and outlet depth. More
Could not fit within design parameters — proceed with caution
Means: No line fits your depth window at Min Grade.
Do: Widen the depths, lower Min Grade, or use Guided / Freeform. More
No distance in this run clears the depth limits. Change the outlet depth or the limits.
Means: Suggest found no transition that works.
Do: Change the outlet depth or limits. More
Rock Hit — Design Adjusted
Means: The plow rode 2 in or more above design for about 2 s; the target was raised by the error. It also fires during a manual Hold.
Do: Keep going; check Nudge once past it, and after any deliberate lift. More
Contour reference unavailable — steering off the saved route.
Means: A resumed contour job has no saved contour.
Do: Carry on; guidance follows the saved route. More
Contour tile design — use the wizard
Means: This design must open through Contour Tiling.
Do: Open it from the Tiling card: tap Contour Tiling, then Load Existing Design. To carry on a job, use Resume on the Grade screen. More
Survey and design23 messages · Survey screen, Field Survey and design windows.
Waiting for RTK fix — recording paused
Means: RTK dropped; logging paused and resumes by itself.
Do: Slow down or stop and wait for RTK. More
Waiting for an accurate RTK fix — point not logged.
Means: Field Survey: the fix isn't RTK quality yet.
Do: Hold still until RTK, tap Log Point Here again. More
No usable GPS fix — point not logged
Means: Shots mode: no fix, not RTK, or stale.
Do: Wait for RTK, tap Log Point again. More
No GPS fix — can't log a point here.
Means: Field Survey: no position.
Do: Check the receiver, wait for a fix. More
Blade Ht 0 — antenna level
Means: Blade height isn't set; the survey would record antenna height.
Do: Tap the chip and set blade height before surveying. More
Drop a benchmark first
Means: Field Survey needs a benchmark before recording.
Do: Park on a fixed feature and tap Drop Benchmark Here. More
Need a valid GPS fix to use benchmarks.
Means: No position for the benchmark.
Do: Wait for a fix. More
Fewer than 10 points — keep driving or Cancel.
Means: A field survey needs 10 points to save.
Do: Tap Start and keep driving, or Cancel. More
Discard N unsaved points?
Means: Cancel would throw away this session's points.
Do: Keep working, then Stop to save. More
Finish field survey first
Means: You can't leave Field Survey with unsaved work.
Do: Finish & Save, or Cancel to discard. More
Save failed: …
Means: The survey couldn't be written; the points are still in the window.
Do: Tap Save again; check storage. More
Need a GPS fix to set A.
· Need a GPS fix to set B.
Means: AB line point not set: no position.
Do: Wait for a fix, then set it. More
Drive farther from A before setting B (at least ~30 m for a good line).
Means: A and B are too close for a good line.
Do: Drive at least 30 m (100 ft) on, then Set B. More
Not enough survey data
Means: Slope-IQ: fewer than 2 survey points.
Do: Record or load a longer survey. More
No survey data available. Record a survey first.
Means: Simple Grading has no survey to design on.
Do: Record a survey. More
No Slope-IQ Design Loaded
· No Forming Design Loaded
Means: Nothing to grade to yet.
Do: Survey and design, or import a design. More
Outlet: Reversed
Means: The outlet is forced to the higher end.
Do: Check it's right; tap to go back to Auto. More
Over Max
Means: Chart shading: the ditch design cuts deeper than Max Depth (not enforced).
Do: Adjust the design if that cut isn't acceptable. More
Apply Revised Design? Start Fresh Job / Keep My Progress
Means: A changed design is going onto a job with progress.
Do: Keep My Progress keeps coverage; Start Fresh Job clears it. More
Saving this revised design will clear the current grading progress, coverage map, pass number, and nudge, then start a fresh job with the new target.
Means: Saving resets the job. Old designs and jobs stay on disk.
Do: Save Revised Design or Cancel. More
Replace Current Survey?
· Replace Current Design?
Means: Loading replaces what's in memory. Saved files stay.
Do: Save first if needed, then go on. More
Cancelling without saving will discard everything from this session. Tap Stop instead if you want to save.
Means: Cancel never saves.
Do: Keep working, then Stop. More
Terracing8 messages · Terrace design and grading.
−N short — deepen channel?
Means: The channel won't supply enough dirt for the berm.
Do: Tap Auto-Balance or raise Depth Offset. More
Cannot auto-balance — cut requirement exceeds N″ offset cap
Means: Auto-Balance hit Auto Balance Max Offset.
Do: Raise the cap, lower berm height, or haul fill. More
NEEDS FILL
Means: Parts of the berm are below minimum height.
Do: Check the Need Fill zones; make sure the cut covers them. More
Redistribute material from higher berm sections to fill deficit zones
Means: Channel cut alone won't build the berm.
Do: Move dirt from high sections, or deepen the channel. More
Cannot auto-compute side slope from survey data
Means: Not enough usable berm points.
Do: Set the side slope by hand. More
No design
Means: The channel survey has too few points.
Do: Pick a channel survey with more points. More
Terrace design — use the wizard
Means: A terrace design needs both surveys to load.
Do: Tap the Terracing card, then Standard Terracing, then Load Surveys (or Resume Job). More
OUTSIDE ZONE
Means: Described in the in-app manual for Contour-Guided Terracing, but app v1.5.4 shows no zone text.
Do: Read your place from the coloured band on the map and the lightbar, and steer back into the band. More
Calibration and blade height22 messages · The Calibrate Elevation window, the BM badge and Auto Measure.
Not calibrated — elevations are raw GPS
Means: No benchmark offset is set.
Do: Calibrate before working. More
Restored from … — recalibrate before working
Means: The offset is from an earlier session.
Do: Recalibrate to a benchmark. More
No RTK samples collected. Check GPS fix.
Means: The 5-second calibration average got no RTK Fixed readings.
Do: Wait for RTK, hold still, try again. More
Too far from route — move closer
Means: You're more than 50 m from the survey.
Do: Drive onto the run. More
Too far from the design line — move onto the run first
Means: Design-grade calibration from off the line.
Do: Drive onto the run, calibrate again. More
Calibrate Anyway (5s avg)
Means: You're more than 3 m from the benchmark.
Do: Cancel and drive onto it. More
You are … from "…". Drive within 10 m to calibrate.
Means: Field Survey: too far from that benchmark.
Do: Park on it and tap it again. More
Clear the benchmark offset? Grading will use raw GPS elevations until you recalibrate.
Means: Clear BM removes the calibration.
Do: Only clear it if you'll recalibrate. More
Set your current position to … ? This replaces the current calibration.
Means: Confirmation after you type a known elevation under Advanced and tap Set BM.
Do: Set BM to apply, or Cancel. More
Calibrate GPS?
Means: A loaded file may be from a different base setup.
Do: Calibrate if the base moved; otherwise Skip. More
This file was referenced to benchmark "…", but this session is calibrated to "…". Its elevations may not line up.
Means: Field Mode: file and session use different benchmarks.
Do: Calibrate to the file's benchmark before grading. More
This file was recorded without a benchmark reference, so it may not line up with "…".
Means: Field Mode: the file isn't tied to a benchmark.
Do: Check elevation at a known point first. More
Calibrate to this field's benchmark
· Set a benchmark for this field?
Means: Field Mode prompts to tie this session to the field.
Do: Tap Go / Set Benchmark, or Later / Not Now. More
Set Blade Height
· Your blade height hasn't been set yet.
Means: Blade height is 0.
Do: Enter Manually or Auto Measure. More
Auto Measure requires a controller connection for RTK GPS data.
Means: Auto Measure needs a connection.
Do: Connect using the steps shown. More
Requires controller connection + RTK fix
Means: Measure buttons are off until connected on RTK.
Do: Connect and wait for RTK. More
RTK Fix: Waiting for RTK...
· GPS Fix: Waiting for GPS fix...
Means: Auto Measure waits for the fix.
Do: Wait for RTK. More
No RTK samples collected. Check GPS fix and try again.
Means: An Auto Measure step got too few good readings.
Do: Check RTK, tap Measure again. More
Measurement Uncertain
Means: GPS moved more than an inch during a measurement.
Do: Retry Measurement, or enter it by hand. More
Import, export and map layers18 messages · Load lists, file imports and the Map Layers panel.
Export failed. Check storage permission.
Means: The export couldn't be written.
Do: Allow all-files access; check free space. More
Could not load survey data for export.
· Could not load survey: …
Means: That survey file couldn't be read.
Do: Try another survey; send logs if you need it. More
Failed to save survey to disk
Means: A Levee job couldn't be saved.
Do: Check storage and permission, tap Save Job again. More
Error loading data
· Error loading jobs
Means: The saved list couldn't be read.
Do: Close and reopen; note the red text for support. More
No points to display
Means: The selected file has no points.
Do: Pick another; it may be damaged. More
Tap "All fields" above to see every saved survey.
Means: Field Mode shows only the active field.
Do: Tap All fields. More
Import failed: …
Means: The file couldn't be read as an XYZ / XYZP line or design file.
Do: Check the format and export again. More
The file needs at least two points with valid coordinates.
Means: Fewer than two usable rows.
Do: Check the file has latitude, longitude, elevation rows. More
File import is not available for this workflow. Use Ditching, Excavation or Tiling.
Means: Line import only works in those workflows.
Do: Import from Ditching, Excavation or Tiling. More
Failed to parse KML: …
· No features found in KML file
Means: The KML can't be read or has nothing to draw.
Do: Use a .kml (not .kmz) with lines, points or polygons. More
No world file found. Select the image (.jpg) and world file (.jgw) together, or a .zip containing both.
Means: The overlay has no location.
Do: Pick image and world file together, or one .zip. More
No image file found. Select the image (.jpg/.png) and world file (.jgw) together, or a .zip containing both.
Means: No image was picked.
Do: Pick the image and its world file. More
World file uses projected coordinates (UTM/meters). Only WGS84 (EPSG:4326) geographic coordinates are supported. Re-export the world file in lat/lon.
Means: The world file is in metres.
Do: Re-export in WGS84 latitude/longitude. More
Image file not accessible: …
Means: The file isn't on the tablet itself.
Do: Copy it to Downloads and pick it again. More
Image overlay error: …
Means: The image or zip couldn't be loaded.
Do: Check it opens on the tablet; try again. More
Name, URL, and Layers are required
Means: Add WMS Layer needs all three fields.
Do: Fill them in and tap Add. More
Land Forming and LandXML14 messages · Design import for Land Forming and Excavation.
Switch to Metric Units?
Means: Land Forming works in metric only.
Do: Tap Switch to Metric (Cancel won't open Forming). More
No valid data points found in file. N line(s) could not be parsed.
Means: No row could be read as a point.
Do: Export XYZP or AGD again. More
No grade points (3GRD) found in AGD file. N line(s) could not be parsed.
Means: The AGD has no grade rows.
Do: Export with grade points, or XYZP. More
Line N: this XYZP file is missing the proposed elevation (4th column)…
Means: A row lacks its proposed elevation.
Do: Fix the line or export again. More
Line N: this AGD file has a 3GRD row missing its proposed elevation…
Means: A grade row lacks its design elevation.
Do: Export the AGD again. More
File is empty: …
· No non-empty lines in file
· File not found: …
Means: The file is blank or not there.
Do: Copy a fresh export to the tablet and pick it. More
XYZ format — design elevations only. No cut/fill overlay or auto-nudge available.
Means: Only one surface in the file.
Do: Use XYZP or AGD with proposed elevations. More
Triangulating surface from N points. This can take …
Means: Building the surface from a big file.
Do: Wait; thin the design next time. More
GPS is outside the forming design area. Move inside the design before starting.
Means: No target where you are.
Do: Drive inside the design, tap Start. More
No <Surface> elements found in file
Means: The LandXML has no surface.
Do: Export a TIN surface to LandXML. More
Surface "…" has N points but no triangle faces — the TIN is empty or could not be parsed.
Means: Points but no triangles.
Do: Export as a triangulated TIN. More
No valid TIN data found in selected surfaces
Means: The chosen surface has no usable triangles.
Do: Pick another surface or export again. More
Unknown CRS
Means: The app couldn't recognise the LandXML coordinate system (there's no picker to set it).
Do: Re-export in NAD83 State Plane or UTM with the coordinate system in the file. More
Failed to read terrain file: …
· Terrain import failed: …
Means: The existing-ground file won't load.
Do: Pick another surface or go on without terrain. More
Ditch Assist Lite and Emlid25 messages · Connecting, activating and programming an Emlid Reach.
Tablet isn't on a Reach hotspot. Join the Reach WiFi (password emlidreach) and try again.
Means: The tablet isn't on the Reach's Wi-Fi.
Do: Join the reach:… network, tap Emlid Reach. More
Reach found, but no NMEA TCP output is configured. Open Settings → Ditch Assist Lite → Setup guide.
Means: The Reach isn't sending its position over Wi-Fi.
Do: Program the receiver from Emlid Diagnostics at the bottom of Settings: Configure, pick Lite Rover, then Program receiver. More
Reach found. It reports a TCP-server NMEA output, but that port did not accept the connection — make sure the output is switched on and try again.
Means: The output is set up but not accepting connections.
Do: Switch it on in Emlid Flow, or wait and retry. More
Emlid …
· Not activated
Means: This receiver has no unlock code yet.
Do: Tap Activate and follow the steps. More
Connect to the Reach first: join its WiFi hotspot (password emlidreach), then tap Connect.
Means: Activation needs the Reach connected.
Do: Join the hotspot, tap Connect. More
Disconnect the current controller or simulator first.
Means: Another source is connected.
Do: Disconnect it or stop the simulator. More
Couldn't read the receiver ID. Make sure the tablet is on the Reach hotspot and Location is on, then try again.
Means: The app couldn't read the serial number.
Do: Turn Location on, wait, tap Retry. More
This Reach isn't set up for Ditch Assist Lite yet (no position output over Wi-Fi)…
Means: You can activate, but it won't send positions yet.
Do: Activate, then Open Emlid Diagnostics. More
That code doesn't match this receiver. Codes are issued per receiver.
Means: Wrong code, or for another receiver.
Do: Check the code and the receiver. More
Too many attempts — try again in N s
Means: Locked after 5 wrong codes.
Do: Wait for the countdown. More
This receiver's licence has been revoked. Contact sales@ditchassist.com.
· Revoked
Means: Ditch Assist Lite can't run on this receiver.
Do: Email sales@ditchassist.com. More
Remove this receiver? Ditch Assist Lite will stop working with … until its unlock code is entered again.
Means: Removing needs the code to come back.
Do: Only remove it if you have the code. More
Not connected to a Reach
Means: Emlid Diagnostics can't find a receiver.
Do: Join the Reach: hotspot, tap Retry. More
Couldn't open Wi-Fi settings — open them from the tablet's Settings app.
Means: The shortcut didn't open.
Do: Open Wi-Fi from the tablet's Settings app. More
Programming stopped
· The receiver did not accept one of the settings after 3 attempts. Finish this in the Emlid Flow app, then come back to verify.
Means: A group of settings wouldn't stick.
Do: Copy details, finish in Emlid Flow, check again. More
A different receiver answered — the tablet may have joined another Reach hotspot. Nothing was written. Reconnect and try again.
Means: The tablet is on another Reach.
Do: Join the right hotspot, program again. More
Ditch Assist is checked on firmware … and newer. Update this receiver in Emlid Flow.
Means: Older receiver firmware.
Do: Update it in Emlid Flow. More
Programming is disabled on this receiver or firmware — use the Emlid Flow app.
Means: The app can read but not change it.
Do: Set it up in Emlid Flow. More
Stop automatic grading before programming a receiver.
Means: Can't program while grading.
Do: Tap Stop first. More
Closest: Ditch Assist … — N settings differ
Means: The receiver doesn't exactly match a role.
Do: For an exact match, tap Configure, then Program receiver. More
Retrying … (N of 3)…
· Failed …
Means: A setting is being retried, or failed after 3 tries.
Do: Wait; see Programming stopped. More
The app is connected to this receiver. Programming it as a Base / Rover turns off its Wi-Fi position output…
Means: After programming, it won't feed the tablet over Wi-Fi.
Do: Disconnect first, or connect another source after. More
The app is connected to this receiver. The connection will drop for a few seconds while it is programmed, then reconnect.
Means: Lite Rover programming briefly drops GPS.
Do: Nothing to do. More
Radio cannot carry these rates — sending … at 0.5 Hz
· The radio could not carry 1 Hz on every constellation…
Means: Base corrections slowed to fit the LoRa link.
Do: Only check the link if RTK is slow to fix. More
Enter a frequency between … and … MHz
Means: LoRa frequency outside the receiver's band.
Do: Type a frequency in range; same on base and rovers. More
DIG module10 messages · DIG firmware updates and excavation.
Can't reach the DIG module. Check that the tablet is connected to the module's WiFi network, then try again.
Means: The firmware updater can't reach the module.
Do: Join the DIG Wi-Fi, tap Check Again. More
This firmware is too old to connect to the app. Update the module to 1.7 to use it.
Means: Firmware below 1.7 can't connect.
Do: Call Ditch Assist support; they walk you through the update. More
Firmware 1.7 changes the module's WiFi password, so the tablet will probably disconnect from it now…
Means: The 1.7 step changes the password.
Do: Forget the DIG network, rejoin with 12345678, tap Check. More
The module's WiFi password is now 12345678. Rejoin its network from Android WiFi settings.
Means: Shown after the update finishes.
Do: Rejoin with 12345678. More
The module still reports firmware …. It may still be applying the update, or the update did not complete.
Means: The new version hasn't shown yet.
Do: Wait a minute, tap Check; View Module Log if it fails. More
This module reports firmware …, which the app cannot update automatically. Please contact support.
Means: The module has firmware newer than this app knows (for example 1.81).
Do: Nothing to do: the module connects and works normally. Tap Close. More
Could not send the firmware to the module. Check the WiFi connection and try again.
Means: The file didn't reach the module.
Do: Rejoin the DIG Wi-Fi, tap Start Update. More
Clear all marks? This removes every completion-grid mark on the current design.
Means: Excavation progress marks would be erased.
Do: Clear Marks only to start tracking over. More
Apply Depth Offset?
Means: How to use the Depth Below Bucket you typed with the new bucket elevation.
Do: Apply Offset, Use Current Only, or Cancel. More
LiDAR & Mapping20 messages · Unlock, internet, download and processing.
LiDAR & Mapping is for Ditch Assist owners
Means: This install hasn't been unlocked.
Do: Connect once to a control module or DIG, or activate your Ditch Assist Lite receiver. More
Internet Required
· Offline — connect to internet to draw
Means: No internet; you can't draw a boundary.
Do: Switch to farm Wi-Fi or a hotspot, tap Retry. More
Internet Required for LiDAR
· LiDAR DEM download needs internet…
Means: You're on a hotspot with no internet.
Do: Disconnect Controller, join internet, fetch again. More
No 3DEP LiDAR coverage in this area.
Means: No US LiDAR for this field.
Do: In Canada pick Canada (HRDEM); otherwise survey the field. More
No HRDEM LiDAR coverage in this area. HRDEM only covers parts of Canada.
Means: No Canadian LiDAR here.
Do: Survey the field instead. More
No LiDAR coverage in this area.
Means: No public LiDAR found.
Do: Check the boundary; use a survey. More
HRDEM coverage is partial — some areas of Canada have no LiDAR. Coverage is verified after the fetch.
Means: Notice for Canadian fields.
Do: Nothing to do. More
Boundary is N ac; max is 800 ac.
· (over 800 ac limit)
Means: The field is over 800 acres.
Do: Draw smaller, or split the field. More
Polygon edges cross. Adjust your boundary.
Means: The outline crosses itself.
Do: Undo or Clear and redraw. More
Boundary must have at least 3 corners.
· Enter a field name.
Means: Boundary or name missing.
Do: Add corners or a name, tap Generate. More
Enter a name for this LiDAR DEM.
· Select at least one field-prep product.
Means: Something to fill in first.
Do: Type a name or tick a product. More
Could not reach the elevation server. …
· WCS fetch failed after 3 attempts: …
Means: The download failed three times.
Do: Check internet; try again in a minute. More
The elevation server returned an empty raster.
· Could not decode the elevation file.
Means: The server sent nothing usable.
Do: Generate again, try the other source, or draw smaller. More
Processing failed: …
· Job failed (DEM retained)
· Generation failed
Means: Downloaded, but the drainage layers weren't made.
Do: Try once more; then send logs and call. More
Satellite imagery cache failed. LiDAR data was saved.
· Field boundary was saved, but satellite imagery cache failed.
Means: Offline imagery didn't download.
Do: Run Cache Satellite Imagery on good internet. More
Satellite imagery was cached, but LiDAR processing failed: …
Means: Imagery saved; LiDAR not made.
Do: Read the reason; check internet and run again. More
No LiDAR elevation at this point.
Means: That field's saved elevation couldn't be loaded.
Do: Pick another field or generate it again. More
Unavailable — field data missing
Means: A drainage plan's LiDAR field is gone.
Do: Generate the field again or delete the plan. More
Saving layers…
Means: Prepare Field never gets past this step, or My LiDAR Fields is empty: usually Android All files access is denied.
Do: Allow All files access for Ditch Assist (steps on the linked page), then reopen the app. More
Failed to load catalog
· Download failed
Means: The online field list or a layer didn't download.
Do: Check internet and try again. More
Levee & Contour16 messages · Contours, elevation imports and levee jobs (also Contour Tiling and Contour-Guided Terracing).
Contour guidance is for Ditch Assist owners
Means: Generating or following contours needs a control module or activated Reach.
Do: Connect the control module (or activated Reach). More
Generating contours needs a controller or the simulator.
Means: A reminder that always shows in the contour wizard; on its own it is not an error.
Do: Nothing, if you are connected to a control module, an activated Reach or the simulator. Otherwise connect first. More
You can survey a field with a Bluetooth GNSS receiver, but following contours requires a connection to your Ditch Assist control module…
Means: Bluetooth GPS can survey only.
Do: Connect the control module. More
No contours were generated from this surface. Try a different interval or surface.
Means: Zero contours at this interval.
Do: Use a smaller interval or a denser surface. More
Contour generation failed: …
Means: Building contours crashed.
Do: Larger interval or more smoothing; check the boundary. More
Many contours — consider a larger interval.
Means: Lots of lines; slow and cluttered.
Do: Pick a larger interval, or go ahead. More
Boundary crosses itself — undo the crossing edge and try again.
Means: The outline crosses itself.
Do: Undo past the crossing, redraw in order. More
Could not parse GeoTIFF file
· GeoTIFF has no valid elevation data
Means: The GeoTIFF can't be used.
Do: Use an elevation .tif that covers the field. More
This DEM is too large to load (…; limit …). Clip or downsample the DEM to the field boundary and try again.
Means: Over the size limit.
Do: Clip it to the field on a computer. More
Import error: …
Means: Something went wrong reading the GeoTIFF.
Do: Check it finished copying; try again. More
Too few valid points parsed (N)
· File is empty
· Could not read file: …
Means: The point file couldn't be read.
Do: Check delimiter, header and column picks. More
Survey has fewer than 10 points; not enough to interpolate
· Could not load survey
Means: Not enough survey to build a surface.
Do: Survey more or pick another. More
Could not load saved LiDAR DEM: …
Means: The saved LiDAR surface won't load.
Do: Save the field's DEM again online. More
LiDAR import failed: …
Means: The LiDAR download or decode failed. The detail often starts "Bad state:" (no coverage) or "WCS fetch failed" (no internet).
Do: Check internet; with no coverage, survey the field. More
RTK accuracy lost — guidance may be unreliable
Means: Fix dropped while following.
Do: Slow down or stop until RTK returns. More
Could not load job: …
· Discard current work?
Means: Job won't load, or would replace unsaved work.
Do: Save Job first; try another job. More
Settings, logs and controller11 messages · Settings screen and Send Logs.
Settings sent to controller
Means: Your CONTROLLER changes were sent to the module, which saves them.
Do: Stop and start auto grading (the module reads Min / Max Valve DC only when auto starts), then test on flat ground. More
Controller rejected DC values
Means: The module didn't take the Min / Max Valve DC values you sent.
Do: Move a slider so Apply turns green and tap Apply again. Still rejected? Turn the module off and on, reconnect, and try again. More
Send Logs
· I understand what will be sent
Means: First upload needs your consent.
Do: Tick the box, type your name, tap Send. More
Packaging logs...
· Uploading...
· Sent!
Means: Upload progress. Only Sent! means delivered.
Do: Wait for Sent!. More
No internet — the logs were NOT sent. Retry when the tablet has an internet connection.
Means: Nothing left the tablet.
Do: Join internet, tap Retry. More
No internet — the logs could NOT be uploaded to Ditch Assist. The file was handed to another app instead…
Means: Only delivered if you finish sending in that app.
Do: Finish sending, or Retry on internet. More
Clear Logs? Delete all N log file(s) (…)?
Means: Every log file will be deleted.
Do: Send logs first if a problem is open. More
Start-up and safety4 messages · Screens you see when the app opens.
All files access
· Allow access to manage all files
Means: Android asks for file access so the app can save to Documents/DitchAssist.
Do: Turn it on, go back. More
Operator's Manual
· I Agree to Read the Manual Before Use
Means: Shown once until acknowledged.
Do: Read the manual, tap to agree. More
SAFETY WARNING
· I Accept All Risk & Liability
Means: Shown every launch: hydraulics move automatically.
Do: Read it and accept. More
Still not fixed?
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.