TouchBLUE tablet manual

Software version 1.3.5 · Updated 20 November 2026 · For BlueCarve machines with a FluidNC controller and the TouchBLUE tablet

This is the user manual for the TouchBLUE touch-screen tablet that runs BlueCarve machines with a FluidNC controller. The same manual is built into the tablet: open the tablet’s web page from a computer on the BLUECARVE WiFi and choose Manual.

Video tutorial

A narrated walk-through of TouchBLUE 1.3.5: every screen, a first carve, and the five most common alarms.

Watch it at https://bluecarve.com.au/wp-content/uploads/2026/11/TouchBLUE-1.3.5-Tutorial.mp4

Read this first: safety

A CNC machine can cause serious injury. The TouchBLUE tablet makes the machine easy to control, but it does not make it safe by itself. Please read and follow these points every time you use the machine.

  • Know where the machine’s emergency stop (E-stop) is and be able to reach it at all times while the machine is moving. The STOP button on the tablet ends a job and returns the machine to idle, but it is not an emergency stop and does not cut power.
  • Never leave a running machine unattended.
  • Wear eye and hearing protection and use dust extraction. Keep long hair, loose sleeves and jewellery well away from the cutter.
  • Clamp the material securely before every job. Keep your hands clear of the cutter and gantry while the machine is powered.
  • Check the cutter, collet and spindle before starting, and use only cutters rated for the spindle speed and the material.
  • Keep children and pets away from the machine.
  • If anything looks, sounds or smells wrong, press the E-stop first, then work out the cause.
About this manualThis manual covers TouchBLUE software version 1.3.5 on BlueCarve machines. It has four parts: 1. Getting started (for first-time users), 2. Your first carve (an overview of the whole workflow, then step by step), 3. Troubleshooting and 4. The web page (sending files and the Tools from a computer: surfacing, DXF → G-code with holding tabs, V-carve, nesting, laser image engraving, 3D relief, the G-code checker, feeds and speeds, and project files).
The screen pictures are illustrations that follow the tablet’s layout. Machine names, file names and positions on your own tablet will differ.

1. Getting started

This section is for first-time users. It explains what TouchBLUE is, how to switch on and connect, what each screen does, and the handful of ideas you need before your first carve: homing, jogging and setting zero.

1.1 What TouchBLUE does

TouchBLUE is a touch-screen controller for your BlueCarve machine. The tablet talks to the machine’s controller over WiFi. You use it to:

  • move the cutter around (jogging) and send the machine to its reference position (homing);
  • tell the machine where your job starts (setting zero), by hand or with a touch probe;
  • choose, preview and run job files, and watch them carve;
  • pause or stop a job, and adjust speeds while it runs;
  • see alarms and errors explained in plain English.

1.2 Switching on and connecting

  1. Switch on the machine’s own power (the controller must have power, not just a USB connection).
  2. Power the tablet with its USB-C power lead. The TouchBLUE logo appears, then the main screen.
  3. Wait for the connection. The tablet joins the machine’s WiFi network by itself. Look at the bar at the bottom of the screen: when the word at the left changes from a red OFFLINE to a green IDLE, you are connected.
  4. If the bar shows ALARM in red, a message explains why. Tap Clear Alarm, or see section 3.
Preset connection details
Machine WiFi network nameBLUECARVE
WiFi passwordbluecarve
Controller address192.168.0.1
Tablet web page (send files, Tools, this manual)Normally http://192.168.0.2. The exact address is shown on Settings > Machine.
TipYou can send job files to the machine from a computer on the BLUECARVE WiFi, and make spoilboard-surfacing and DXF jobs there too. See section 4.

1.3 Finding your way around

The row of tabs along the top is the main menu. The bar along the bottom is always visible and shows the machine state and position.

TabWhat it is for
StatusThe live view: state, positions, feed and spindle speed, input and fault lamps, messages and the Alarms button. Also holds the Spindle Mode / Laser Mode buttons. While a job runs it shows Pause and STOP.
ControlEverything for moving the machine. It has five pages down the left: Actions (unlock, home, zero), Jog (step buttons), Dial (handwheel dials), Probe (touch-probe routines) and Overrides (change speed during a job).
FilesThe files on the machine’s SD card. Each file has a delete, preview (eye) and play button.
PreviewA drawing of the toolpath for the file you chose, with the job size in millimetres.
MacrosButtons for saved sequences of commands.
TerminalAdvanced: type commands to the controller and read its replies. You do not need this for normal use.
SettingsTablet settings: General, Backup, Power, Jog, Probe, WCS and Machine.
The Status tab
Figure 1: The Status tab

1.4 Reading the machine state

The machine state appears in large letters at the bottom left of every screen, and on the Status tab.

StateColourWhat it means
IDLEGreenReady. You can jog, set zero or start a job.
RUNCyanA job is running.
JOGCyanA jog move is in progress.
HOMEBlueThe homing cycle is running.
HOLDYellowPaused. Press Resume to carry on.
ALARMRedThe machine has stopped for a reason. A message explains it. Fix the cause, then clear the alarm. See section 3.4.
OFFLINERedThe tablet is not connected to the machine. See section 3.2.

The bottom bar also shows WPos (work position, relative to your job zero) and MPos (machine position), with the machine name and WiFi network at the right.

1.5 A few words you will see

WordMeaning
Home / homingSending the machine to its limit switches so it knows where it is. Do this after every power-on, before jogging to your job.
JogMoving the machine by hand with the tablet, as opposed to running a job file.
Machine position (MPos)Where the cutter is measured from the machine’s home corner. It does not change when you set zero.
Work position (WPos)Where the cutter is measured from your job’s zero point. Job files use this.
Zero (work zero)The point on your material that the job treats as X0 Y0 Z0. You set it each time you place new material.
G-codeThe instructions in a job file (usually ending .nc or .gcode), produced by your CAM software.
Spindle / Laser modeWhich tool the machine is set to use. See section 1.9.
Feed rateHow fast the cutter moves through the material, in millimetres per minute.
ProbeA touch plate or block that lets the machine find the top (and sides) of your material automatically.
WCSWork coordinate system – a stored zero point (G54 is the default). The tablet normally uses G54.
SpoilboardThe sacrificial board on the machine bed that you cut into slightly. Surfacing it (section 4.2) makes it flat and parallel to the cutter.

1.6 Homing the machine

Home the machine each time you switch it on. This lets the controller know where the cutter is, which it needs to keep the cutter inside the machine’s travel limits.

  1. Make sure the cutter is clear of the material, clamps and anything on the bed, and that the path to the home corner is clear.
  2. Go to Control > Actions.
  3. If the state is ALARM, tap Unlock first.
  4. Tap Home All. The state shows HOME while the machine moves to its limit switches, then returns to IDLE.
Control > Actions
Figure 2: Control > Actions
ImportantThe machine moves on its own while homing. Stand clear, keep a hand near the E-stop, and make sure nothing is in the way. If homing fails with an alarm, see the alarm table in section 3.4.

1.7 Moving the cutter: Jog and Dial

There are two ways to move the cutter by hand. Both are on the Control tab.

Jog: step buttons

  1. Open Control > Jog.
  2. Pick a step size from the column on the left (X/Y) or right (Z). 100 mm moves a long way; 0.1 mm is for fine adjustment.
  3. Tap an arrow. The cutter moves by exactly one step. The corner arrows move X and Y together.
  4. The S: and F: figures in the middle show the current step and feed rate. Use the −1000 / −100 / +100 / +1000 buttons to change the feed.
  5. Tap STOP to cancel a move that is still in progress.
Control > Jog
Figure 3: Control > Jog

Dial: handwheel-style jogging

The Dial page has one dial for each axis (X, Y and Z, plus A if your machine has a rotary axis). Put a finger on a dial and turn it:

  • Clockwise moves the axis in the plus direction; anticlockwise moves it in the minus direction.
  • Every notch you turn (15 degrees) moves the axis by one step. Turn faster to move further.
  • Tap the centre of a dial to change its step size (the choices come from Settings > Jog).
  • While you turn, the figure under the dial shows how far you have moved. STOP cancels any move still queued.
Control > Dial
Figure 4: Control > Dial
TipUse the Jog page to get close to the start point with big steps, then switch to a dial with a small step (0.1 mm or 1 mm) for the final adjustment.

1.8 Setting zero (where your job starts)

Your job file measures everything from a zero point. Before each job you tell the machine where that point is on your material. The zero is set for X and Y (usually a corner or the centre of the work) and for Z (usually the top surface of the material, or the spoilboard, depending on how your CAM file was set up). Check how your file was prepared – the zero in the tablet must match the zero in your CAM software.

By hand

  1. Jog the cutter to the XY point that is your job’s zero (for example the front-left corner of the material).
  2. On Control > Actions, tap Zero X and Zero Y (or Zero All to include Z).
  3. Jog the cutter down until it just touches the Z reference (for example the top of the material, or a sheet of paper that just drags). Tap Zero Z.
  4. Check the WPos values on the Status tab: the axes you zeroed should read 0.000.
If zero will not setThe tablet will not set zero while the machine is in ALARM, still moving from a jog, or paused. A message tells you which; press Unlock, wait for the move to finish, or press Resume, then try again.

With the probe

The Probe page does the touching for you.

  • Z Probe lowers the cutter onto the Z plate and sets Z zero. Set the plate on the material under the cutter and attach the probe clip to the cutter first.
  • XYZ Probe uses the probe block to find the top and two sides of the block and sets X, Y and Z zero. Enter the cutter diameter in Tool Dia first.
  • Parameters opens the probe settings (plate and block sizes and probe speeds). The factory values are a 15 mm Z plate and a 9 mm tall probe block; change them only if your probe is different.
  • The Probe result box shows progress and any error.
Control > Probe
Figure 5: Control > Probe
ImportantBefore probing, check the probe lead is connected and the clip is touching the cutter (not the plate). The machine moves automatically and slowly during probing; keep your hand near the E-stop.

1.9 Spindle Mode and Laser Mode

If your machine has both a spindle and a laser, the tablet needs to know which one the job is for. Use the two buttons at the top of the Status tab. The selected mode is solid; the other is an outline. The buttons are hidden while a job is running.

Laser Mode selected
Figure 6: Laser Mode selected

Each tool has a tool number: normally T0 for the spindle and T1 for the laser. Before a job starts, the tablet reads the file and checks its tool numbers against the mode you have selected. If they do not match it stops and tells you, which prevents (for example) a spindle job being run in laser mode.

Changing the tool numbers

Open Settings > General. Under MODE there is a Spindle and a Laser row. Tap − or + to choose Auto (the tablet reads the number from the machine’s configuration) or a fixed tool number from T0 to T99. The change applies straight away. If both are set to the same number, both rows turn amber and read “clash” – change one of them.

Settings > General
Figure 7: Settings > General
NoteSimple Mode (also under MODE) adds a guided Carve tab and hides Status, Macros and Terminal for operators who only need to run jobs. This manual describes the standard screens; Simple Mode is switched on and off with the same switch.

1.10 Getting job files onto the machine

Job files are made in your CAM software and saved as G-code (.nc or .gcode). Make sure the file was made with the correct post-processor for your machine. A spindle job should use tool T0 (or no tool number); a laser job should use T1.

Option A: SD card

Copy the file onto the machine controller’s SD card on your computer, put the card back in the controller, and open the Files tab. Choose FluidNC SD in the list at the top left, then tap Refresh. Use a card of 32 GB or less, formatted FAT32.

Option B: WiFi from your computer

  1. Connect your computer (Windows, Mac or Linux) to the BLUECARVE WiFi network (password bluecarve).
  2. Open a web browser and go to the tablet’s address (normally http://192.168.0.2; the exact address is on Settings > Machine). The Send a file page opens.
  3. Drag your file onto the page, or tap to choose it. A progress bar shows the upload.
  4. If a job is running, or the machine is not ready, the page does not take the file and says why. Send it again when the tablet shows IDLE.
  5. On the tablet, open Files and tap Refresh. The new file appears in the list.

The tablet checks that the whole file arrived on the SD card. If the file name has spaces or other unusual characters they are changed to _, and the page shows the name it was saved as. If an upload is interrupted, the partial file is deleted – just send it again. If the file is refused before it is sent (for example no SD card, or not enough space), a file already on the card with the same name is kept.

The Files tab. Delete (red), Preview (blue eye) and Play (green).
Figure 8: The Files tab. Delete (red), Preview (blue eye) and Play (green).
No CAM software?The same web page has a Tools section that makes two common jobs for you without any CAM software: surfacing the spoilboard and cutting a DXF drawing. See section 4.

1.11 Previewing a file

Before running a new file, look at it. On the Files tab tap the blue eye next to the file. The Preview tab opens and draws the toolpath. Check that the shape and size look right.

The Preview tab
Figure 9: The Preview tab

Large files take a few seconds to load; the page shows progress. If the file is very long the preview may show only the first part and the information line says so. This does not affect the job itself.

1.12 Other settings

PageWhat you can change
GeneralFolders on top in the file list, A-axis (rotary) on/off, rotate the display 180 degrees, Simple Mode, and the Spindle and Laser tool numbers.
BackupExport the tablet’s settings to its SD card, or clear all settings.
PowerScreen dimming and sleep times.
JogDefault jog steps and feed rates for each axis, and the step lists shown on the Jog and Dial pages.
ProbeProbe plate and block sizes and probe speeds.
WCSNames and locks for the stored zero points (G54 to G59).
MachineA summary read from the controller: axes, travel, spindle and laser, plus software versions and the tablet’s web address.
Settings > Jog
Figure 10: Settings > Jog

2. Your first carve

This section takes you through a complete job from switching on to finished part. First comes the overview, so you can see the whole flow; then each step is explained.

2.1 Overview: the workflow at a glance

#WhereWhat you doYou will know it worked when
1Machine + tabletSwitch on the machine, then the tablet. Wait for the connection.The bottom bar shows green IDLE and BLUECARVE.
2Control > ActionsHome All (clear the bed first).The state goes HOME, then back to IDLE.
3On the machineFit the cutter, clamp the material, check clearances.The material cannot move and nothing is in the cutter’s way.
4StatusChoose Spindle Mode (or Laser Mode).The correct mode button is solid.
5Files + PreviewGet the file on the machine, then preview it.The preview shape and size are what you expect.
6Control > Jog / DialMove the cutter to the start point of the job.The cutter is exactly over your chosen X/Y zero.
7Control > ActionsSet X and Y zero.WPos X and Y read 0.000.
8Control > Probe or ActionsSet Z zero (probe or by hand).WPos Z reads 0.000 at your Z reference.
9FilesDo the final checks, then tap Play.The tablet checks the tool numbers and the Status tab shows RUN.
10StatusWatch the carve. Pause, adjust or stop if needed.The state returns to IDLE when the job is finished.
11On the machineRemove the part and clean up.The machine is idle and the bed is clear.
TipThe first time, run a short test file on scrap material with the cutter well above the work (for example with Z zero set 20 mm higher than normal) so you can watch the machine move without cutting.

2.2 Step 1: Power on and check the connection

  1. Switch on the machine, then power the tablet.
  2. Wait until the bottom bar shows IDLE in green.
  3. If it shows ALARM, tap Clear Alarm (or Control > Actions > Unlock). If it still shows OFFLINE after about 30 seconds, go to section 3.2.

2.3 Step 2: Home the machine

Clear the bed, then go to Control > Actions and tap Home All (see section 1.6). Wait until the state returns to IDLE.

2.4 Step 3: Prepare the machine

  • Fit the correct cutter and tighten the collet properly.
  • Clamp the material securely. Keep clamps well away from the toolpath.
  • Check that the toolpath fits on the material and inside the machine’s travel.
  • Turn on dust extraction.

2.5 Step 4: Choose the mode

On the Status tab tap Spindle Mode (for a router or plasma job) or Laser Mode. The selected button turns solid. The tablet sends the change to the machine; wait a moment until the button stops looking faded.

2.6 Step 5: Choose and preview your file

  1. Open the Files tab. Choose FluidNC SD and tap Refresh if you have just added a file.
  2. Tap the eye next to your file. The Preview tab opens and draws the job.
  3. Check the size shown under the picture. If it is wrong, the file was probably made with the wrong units or size – fix it in your CAM software before going on.

2.7 Step 6: Move to the start point

Use Control > Jog to bring the cutter over the point that will be your job’s X/Y zero. Use big steps to get close, then the Dial page with a 0.1 mm or 1 mm step for the last adjustment.

ImportantRaise the cutter well above the material before moving across it. Use Z+ on the Jog page.

2.8 Step 7: Set X and Y zero

On Control > Actions tap Zero X and Zero Y. On the Status tab, the work position X and Y now read 0.000.

2.9 Step 8: Set Z zero

With the probe: place the Z plate under the cutter, attach the clip, open Control > Probe and tap Z Probe. By hand: lower the cutter slowly until it just touches your Z reference and tap Zero Z. Then raise the cutter a few millimetres.

Check WPos Z on the Status tab, and that the Preview’s Z range makes sense for your job (for example, cut depths below zero).

2.10 Step 9: Final checks and Play

Before you press Play, run through this checklist:

✓Check
☐Machine homed; state is IDLE.
☐Material clamped; clamps clear of the toolpath.
☐Correct cutter fitted; dust extraction on.
☐Correct mode selected (Spindle or Laser).
☐X, Y and Z zero set; the cutter is above the material.
☐Preview checked; the job fits the material.
☐You are standing next to the machine with the E-stop in reach.

Then open the Files tab and tap the green Play button next to your file (or tap Run on the Preview tab). The tablet briefly shows “Checking job tool numbers…”, then starts the job and switches to the Status tab.

If you see the Tool / mode mismatch message, the job has not started. Either switch mode on the Status tab, or fix the file’s tool number in your CAM software, then press Play again.

The tablet stops a job if its tool number does not match the selected mode
Figure 11: The tablet stops a job if its tool number does not match the selected mode

2.11 Step 10: While the machine carves

The Status tab shows the job progress, the live positions and the speed. While a job runs the Spindle/Laser buttons are replaced by two buttons:

  • Pause holds the machine; the state shows HOLD. The button changes to Resume – tap it to carry on.
  • STOP ends the job. The tablet waits until the machine has come to a complete stop, then clears the alarm that a stop leaves behind, so you can jog or run another file straight away. If the machine was still moving when it was reset (ALARM 3), the tablet leaves it locked and asks you to home it – tap Home All before carrying on. If the WiFi link drops during a stop, the tablet shows Connection lost during STOP – check the machine has stopped. For an emergency, use the machine’s E-stop.

To adjust speed while the job runs, open Control > Overrides. Feed changes how fast the machine moves, Rapid changes the speed of non-cutting moves, and Spindle changes the spindle speed. 100% is the speed in the file. The tablet will not raise the spindle override if that would take the spindle above its maximum speed.

Control > Overrides
Figure 12: Control > Overrides

2.12 Step 11: Finish up

  1. When the state returns to IDLE, the job is done and the spindle has stopped.
  2. Raise the cutter with Z+ (or Home Z), then remove the part and clean the machine.
  3. To carve another copy, set zero again only if you moved the material. To carve a different file, go back to Step 5.

2.13 Doing the same with Simple Mode

With Simple Mode switched on, the Carve tab guides you through the same job one screen at a time: choose a file, fit the cutter, set X/Y zero, set Z zero, confirm, then start. The safety checks, tool check and STOP behave the same way. Switch Simple Mode on or off in Settings > General.

3. Troubleshooting

Start with section 3.1. If your problem involves an alarm message, see 3.4. The tablet shows alarms and errors in plain English, so read the message first – it usually says what to do.

3.1 First things to try

  1. Read the message on the screen (and tap Alarms on the Status tab to see recent alarms and errors).
  2. If the machine is in alarm, fix the cause, then tap Clear Alarm or Control > Actions > Unlock.
  3. If the tablet is acting strangely, switch the tablet off and on again (power lead out and back in).
  4. If the machine does not answer at all, switch the machine off and on again, wait for the tablet to show IDLE, then home.
  5. Make sure the machine’s own power is on. The controller needs its power supply as well as USB.

3.2 Connection problems

ProblemWhat to check
The bar shows OFFLINE and does not connectIs the machine switched on (its own power, not just USB)? Wait about 30 seconds after power-on. Restart the tablet. Make sure the tablet is within a few metres of the machine’s controller.
It connects, then drops outMove the tablet closer to the controller. Metal enclosures and cabinets block WiFi. Check that no other computer is trying to take over the connection to the machine.
A Disconnected or Connection failed pop-up appearsTap the connect/restart button on the pop-up. If it keeps failing, restart the machine, then the tablet.
The WiFi name or password was changed on the controllerThe tablet is set for BLUECARVE / bluecarve. If the controller was set up with different details, contact support.
The web page will not open on the computerJoin the BLUECARVE WiFi first. Use the address on Settings > Machine and type it with http://, not https. Use Chrome, Edge or Firefox on a computer – the page is for computers only.
The web page says Files can be sent when it is Idle or A job is runningFiles are only accepted while nothing is running. Wait for the job to finish (or clear the alarm), then send the file again.
Connection lost during STOP appears after pressing STOPThe WiFi link dropped while the machine was stopping, so the tablet cannot confirm it stopped. Look at the machine: if anything is still moving, press the E-stop. Then reconnect, check the state and home before carrying on.
The web page shows OFFLINE at the top rightThe page can reach the tablet but the tablet is not connected to the machine. Check the machine is on and the tablet’s bottom bar shows IDLE.

3.3 Common problems

ProblemWhat to do
Jog buttons or dials do nothingCheck the state. In ALARM the machine will not move: clear the alarm first. If the state is HOLD, press Resume. If a previous move is still running, tap STOP on the Jog page.
The machine moves the wrong wayOn the Dial page, clockwise is plus and anticlockwise is minus. If the machine moves opposite to the arrows on the Jog page, contact support (the axis direction is a machine setting).
Zero will not set: “Machine in ALARM”, “Still moving” or “Machine paused”Press Unlock, wait for the movement to finish, or press Resume, then tap the zero button again.
Zero not set pop-upThe controller refused the command. The pop-up gives the reason; fix it and try again. Restart the machine if it keeps happening.
Probing fails or the probe does not triggerCheck the probe lead is plugged in and the clip is on the cutter. Make sure the clip is not touching the plate before you start, and start close enough to the plate. See alarms 4 and 5 in section 3.4.
Tool / mode mismatch – the job will not startThe file asks for a different tool from the selected mode. Switch mode on the Status tab, or re-post the file from your CAM software with the correct tool number (T0 for spindle, T1 for laser).
Tool check unavailableThe tablet could not read the file to check it (for example the SD card was busy). Wait a moment and try again, or choose Run anyway only if you are sure the mode is right.
Controller busyA probe routine or mode change is still running. Wait until it finishes.
Mode change failedThe machine did not accept the tool change. Make sure it is idle and not in alarm, then try again.
Spindle limit – the spindle override will not go upIncreasing the speed by 10% would exceed the spindle’s maximum RPM, so the tablet blocked it. Lower the speed in the file if you need more room.
The Files list is empty or says the file system is not accessibleCheck the SD card is fully inserted in the controller and the machine power is on. Use a FAT32 card of 32 GB or less. Tap Refresh. If it still fails, power the machine off and on with the card inserted.
A new file does not appear in FilesTap Refresh. Check that you chose FluidNC SD at the top left, and that the file name ends in .nc or .gcode.
Preview is blank or slowLarge files can take several seconds. If the information line says the preview is truncated, only the first part is drawn; the job is unaffected. Tap the refresh button on the Preview tab to try again.
The touch screen does not respond or touches land in the wrong placeSwitch the tablet off and on. Check the screen is clean and dry and that no case or screen protector is pressing on it. If it persists, contact support.
The screen is upside downSettings > General > Rotate 180°, then Save Settings and restart the tablet.
The Spindle and Laser rows in Settings are amber and say “clash”Both are set to the same tool number. Change one of them (usually Spindle = T0, Laser = T1).
After STOP the tablet says to home the machineThe machine was still moving when it was reset (ALARM 3), so its position may be lost. The tablet does not unlock it. Clear the bed, tap Home All, then set your zero again before the next job.
A job will not start: “file arriving”, “busy” or “not Idle”A job cannot start while a file is being sent from the web page, while a probe or STOP is running, while another job runs, or unless the machine is IDLE. The tablet checks again at the moment the job starts. Wait, then press Play again.
The job stops by itself with ALARMRead the alarm message (see section 3.4). Common causes are a limit switch hit, the E-stop pressed, or a motor driver fault.
Save to SD or Save & Run on the web page failsThe tablet must be connected to the machine (IDLE on the tablet) with the SD card in. “The tablet is busy” means a probe or another upload is running – wait and try again. “The machine is Alarm/Run…” means it is not idle; clear the alarm or wait for the job.

3.4 Alarm messages

When the machine stops with an alarm, a red ALARM box appears with an explanation and a Clear Alarm button. Recent alarms are also listed under Alarms on the Status tab.

An alarm pop-up
Figure 13: An alarm pop-up
No.AlarmWhat it means and what to do
1Hard limitA limit switch was hit while moving. Machine position is lost. Check for a crash or a false trigger, then re-home.
2Soft limitA move would go past the machine’s travel. Check the job and your work zero fit inside the bed, and home the machine so positions are correct.
3Reset while movingThe controller was reset while the machine was still moving, so the position may be lost. The tablet’s STOP waits for the machine to stop to avoid this. If it happens, tap Home All before continuing.
4Probe already triggeredThe probe read as touching before probing started. Make sure the clip or magnet is not touching the plate and the probe lead is not shorted.
5Probe did not touchThe probe travelled the full distance without contact. Start closer to the plate, check the clip is on the bit, or increase the seek distance.
6Homing resetThe homing cycle was stopped before it finished. Home again.
7Homing: door openThe safety door was opened during homing. Close it and home again.
8Homing: pull-off failedA limit switch was still triggered after backing off. Check the switch and wiring.
9Homing: switch not foundA limit switch was not reached within the axis travel. Check the switch, its connector and cable, and that the axis moves freely.
10Spindle controlThe spindle or VFD did not respond as expected. Check VFD power and wiring.
11Control input activeUsually the E-stop is pressed or a motor driver reports a fault. Release the E-stop, check the drivers, then clear the alarm.
12Homing: switch already onA limit switch was already triggered when homing started. Jog the axis off the switch, then home.
13Hard stopMotion was stopped instantly. Position may be lost, so re-home.
14Not homedThis machine must be homed before moving. Run Home All.
15Startup / config problemThe controller found a problem during start-up. Contact support.

3.5 Error messages from the controller

These appear in the Alarms list or in a pop-up. The most common ones are:

No.MessageWhat to do
9Locked by alarm or jogG-code is blocked while the machine is in ALARM or jogging. Clear the alarm or wait for the jog to finish.
15Jog past travelThe jog would go past the machine limits and was ignored. Jog in the other direction, or re-home.
20Unsupported G-codeThe job contains a command the controller does not support. Re-post the file with the correct post-processor.
22Feed rate not setA cutting move has no F feed rate. Check the post-processor, or add an F value.
60–67SD card errorsThe card could not be mounted, read or opened, or is busy. Re-seat the card, make sure the machine power is on, and do not remove the card while a job is running.
65File not foundThe file is no longer on the card. Refresh the Files list.
152Config invalidThe controller’s configuration file has a problem. Contact support.

3.6 Updating the software

Updates for the tablet are published on the TouchBLUE Updater web page: https://touchblue.pages.dev (it shows the latest version and has this manual to download). This updates the tablet only. Do not try to change the machine controller’s software yourself; if you think the controller needs an update, contact support.

  1. Use a computer with Google Chrome or Microsoft Edge and a good-quality USB data cable (not a charge-only cable). Plug the cable directly into the computer, not a USB hub.
  2. Open the installer page and click Install TouchBLUE, then choose the tablet’s port from the list.
  3. Follow the prompts. Do not unplug the cable until it says it has finished – it can take up to about 3 minutes.
  4. When the update finishes, switch the device off and on again.
If the update failsIf you see “Invalid head of packet (0xff)”, the USB connection dropped out. Try a different cable and a different USB port on the computer, avoid hubs, and try again. It is safe to repeat the update.
Updating the tablet does not erase its settings.

3.7 Getting help

If you cannot solve a problem, contact BlueCarve support and have these details ready:

  • the TouchBLUE version and FluidNC version (shown on Settings > Machine);
  • the exact message or alarm shown, and what you were doing when it appeared;
  • a photo of the screen, and of the machine if it is a hardware problem.

4. The web page: files, Tools and this manual

The tablet has its own small web page, reachable from a computer on the BLUECARVE WiFi at http://192.168.0.2 (the exact address is on Settings > Machine). Nothing needs installing and no internet is needed. It has three parts, shown across the top:

PageWhat it does
Send a fileDrop a G-code file from your computer; it goes straight to the machine’s SD card (section 1.10, Option B).
ToolsSurface (spoilboard surfacing), DXF → G-code (profile cuts with holding tabs), V-carve, Nest / array, Laser image, 3D relief, Viewer & checker and Feeds & speeds. Each shows the result first, then saves the job to the SD card, starts it or downloads it. The buttons under the Tools menu save and open projects.
ManualThis manual, stored on the tablet.

The top right of every page shows the machine state as the tablet sees it (IDLE, RUN, ALARM, OFFLINE …). The Tools pages remember what you typed last time on that computer.

Starting a job from the web pageSave to SD only stores the file; you then run it from the tablet’s Files tab as usual. Save & Run stores it and starts it straight away after you confirm – the tablet must show IDLE, and the same safety rules as any job apply (section 2, step 9). The job then shows on the tablet’s Status tab, where Pause and STOP work as normal.

4.1 Surfacing the spoilboard

Surfacing skims the top of the spoilboard flat and parallel to the cutter’s travel. Do it when a new spoilboard is fitted, when it is scarred from earlier jobs, or whenever parts come out with uneven depth. You need a large flat-bottomed cutter (a surfacing or “fly” cutter, typically 22–50 mm).

Before you start

  1. Fit the surfacing cutter and remove clamps, fences and anything else from the area to be surfaced.
  2. Home the machine (section 1.6).
  3. Jog the cutter to the front-left corner of the area you want to surface and set X and Y zero there (section 1.8).
  4. Lower the cutter until it just touches the highest point of the board (paper test or Z probe) and set Z zero. The surfacing cut goes below this by the depth you choose.

Making the job

Open Tools > Surface on the web page and fill in the boxes. Sensible starting values are already there.

SettingMeaning
Width (X), Length (Y)Size of the area, measured from the X0 Y0 corner you set.
Tool diameterThe surfacing cutter’s diameter, in mm.
StepoverHow far each row moves across, as a percentage of the diameter. 40–50% gives a smooth finish; smaller is smoother and slower.
Depth per pass, PassesHow deep each pass cuts and how many passes. 0.5 mm × 1 is a light skim; use 2–3 passes to take more off a badly scarred board.
Feed, Plunge, SpindleCutting speed, downward speed and spindle rpm. Use your cutter maker’s figures for MDF.
Safe ZHeight the cutter lifts to for rapid moves.
Cut along X or YDirection of the rows. Choose the long side.
ZigzagOn: cuts in both directions (fastest). Off: cuts one way only and rapids back, for a more even finish.
Return to X0 Y0Goes back to the start corner when finished.

The Result box shows the file name, number of rows, total depth and a time estimate, and the picture shows the area and the rows. Then tap Save to SD (run it later from the Files tab), Save & Run (start now) or Download (keep the .nc file on the computer).

ImportantThe cutter is half outside the board at the edges of the area – keep hands, clamps and the dust shoe clear. Stand by the machine with the E-stop in reach for the whole job.

4.2 DXF → G-code

This turns a 2D DXF drawing (from CAD, Inkscape, LightBurn, Fusion 360, AutoCAD and most others – save as ASCII DXF, R12 or 2000) into a profile-cutting job: the cutter follows each line, circle, arc or curve in the drawing. It is meant for parts – outlines, holes, slots, signs. For lettering and logos use V-carve, and for 3D carving use 3D relief.

DXF → G-code with holding tabs (orange marks)
Figure 14: DXF → G-code with holding tabs (orange marks)

Steps

  1. Open Tools > DXF → G-code and click Open DXF. Choose the drawing on your computer. The page lists how many shapes it found and the drawing’s units; the toolpath appears on the right.
  2. If the drawing has layers, tap a layer name to leave it out (for example a dimensions layer).
  3. Choose where the drawing sits on the machine under Origin: Bottom-left → X0 Y0 (most common), Centre → X0 Y0, or As drawn (the drawing’s own coordinates).
  4. Check Units. Most drawings say which they use; if the size shown looks 25 times too big or small, switch between mm and inch.
  5. Choose the Mode: Spindle cuts to a depth in passes; Laser traces the lines with the laser at a set power.
  6. Choose the Cut side and enter the Tool diameter (see below), then the depth, speeds and safe height.
  7. Check the picture: the dotted outline is your drawing, the solid line is where the centre of the cutter will travel, and the white dots show where each shape starts. The box under it gives the finished size.
  8. Tap Save to SD, Save & Run or Download, as for surfacing.

Cut side and tool diameter

A cutter has width, so the machine must run beside the line, not on it, for the part to come out the right size. The page offsets the path by half the tool diameter:

Cut sideUse it for
On lineThe cutter centre follows the drawing exactly. Engraving, V-carving a centre line, or when your CAD already drew the cutter path.
OutsideCutting a part out: the cutter runs outside the shape, so the part is the drawn size.
InsideCutting a hole or window: the cutter runs inside the shape, so the hole is the drawn size.
AutoOuter shapes are cut outside and any shape drawn inside another (holes) is cut inside. Right for most parts with holes in them.

Shapes too small for the cutter (for example a 4 mm hole with a 6 mm cutter) are skipped and the page says so. Small shapes are cut before big ones so holes are finished before the part comes free. Offset cuts run in the climb direction (outside clockwise, inside anticlockwise). Open lines that do not form a closed shape are always cut on the line.

Final pass offset

For a cleaner edge, enter a Final pass offset such as 0.3 mm. Every roughing pass then leaves that much extra material, and one more pass at full depth removes it in a single light cut. Leave it at 0 to switch this off.

Depth and passes

Total depth is how far below Z zero to cut – set Z zero on the top of the material and make the total depth the material thickness plus about 0.2–0.5 mm to cut into the spoilboard. Depth per pass sets how much each pass takes; the page works out the number of passes.

Holding tabs

Without tabs, a part comes free on the last pass and can be thrown by the cutter. Holding tabs leave small bridges of material that hold the part in the sheet; cut them afterwards with a knife or saw and sand them flush.

  1. Set Cut side to Outside, Inside or Auto (tabs are only used on closed shapes cut beside the line).
  2. Turn Tabs on. Enter Tabs per shape (for example 4), or set it to 0 and enter a spacing (for example one every 150 mm).
  3. Enter the Tab width (the material left along the cut, for example 5 mm) and the Tab height (how thick the bridge is, for example 2 mm). Leave Ramped edges on so the cutter rolls over each tab instead of stepping up and down.
  4. Check the picture: orange squares mark the tabs. The page keeps them away from sharp corners.

Passes above the tab top cut straight through; only the deeper passes lift over each tab. Shapes too small for two tabs are cut without tabs, and the result box says so – hold those with tape or screws. Tabs are also left on the final pass.

Holding the partTabs hold the part in the sheet, not the sheet to the bed: clamp or screw the sheet down well outside the toolpath. Keep the E-stop in reach.
Checking before cuttingSave the job to the SD card, then open it with the blue eye on the tablet’s Files tab: the Preview tab shows exactly what the machine will do, with the size in millimetres. Run the first part in scrap or with Z zero set well above the material.

What the DXF may contain

Lines, polylines (with rounded corners), circles, arcs, ellipses, splines and blocks (grouped shapes, including nested, scaled and rotated ones) are all used. Text, dimensions, hatching and images are ignored – convert text to outlines in your drawing program if you want it cut. Lines whose ends touch are joined into one shape automatically.

4.3 V-carve

V-carving cuts lettering and logos with a V-shaped bit. The cutter goes deeper where the shape is wide and shallower where it is narrow, so letters get sharp corners and clean walls. It uses the DXF opened in DXF → G-code (with the same units, layers and origin), or open one here with Open DXF. Only closed shapes are carved, so convert text to outlines (curves) in your drawing program first.

V-carve: depth map of a two-tool carving
Figure 15: V-carve: depth map of a two-tool carving
  1. Open Tools > V-carve and check the drawing name at the top.
  2. Enter the V-bit Angle (60°, 90° …) and Tip diameter (0 for a pointed bit).
  3. Enter a Max depth (for example 3 mm). Wide areas that would go deeper are cleared flat at this depth. 0 means no limit.
  4. Choose the Output: V-bit only · 1 file, or Two tools · 2 files (see below).
  5. Check the picture. Depth map shows the finished carving shaded; 3D and Top show the toolpath.
  6. Tap Save to SD, Save & Run or Download.
OutputWhat happens
V-bit only · 1 fileOne tool, one file. The V-bit cuts the walls and also clears any wide flat floors at max depth. Simple, but wide floors are slow and show small ridges; a smaller Flat stepover makes them smoother.
Two tools · 2 filesFile 1 uses a flat end mill to clear the wide floors quickly. File 2 uses the V-bit for the walls and the corners the end mill can’t reach. Run file 1 first, then fit the V-bit, set Z zero on the same surface again, and run file 2.
Two filesSave to SD puts both files on the card. Save & Run starts file 1; when it finishes, change the tool, re-zero Z and start file 2 from the tablet’s Files tab. The file names start with _1_ and _2_ so the order is clear.

4.4 Nest / array

Nesting fits many copies of your parts onto one sheet, so you cut a full sheet in one job. The parts come from the DXF opened in DXF → G-code: each outer shape is one part, with its holes and any lines inside it.

Nest / array: parts nested on a sheet
Figure 16: Nest / array: parts nested on a sheet
  1. Open Tools > Nest / array. Each part is listed with its size; enter how many copies of each you want.
  2. Choose Nest on sheet and enter the sheet size, the margin around the edge and the gap between parts. Make the gap at least the cutter diameter (plus a little), or the cutter will cut into the next part. Allow rotation lets parts turn to fit better.
  3. Or choose Grid array to repeat the whole drawing in columns and rows with a set gap.
  4. Tap Arrange and check the picture and the result (how many fit, and how much of the sheet is used).
  5. Tap Use layout. DXF → G-code and V-carve now work on the whole sheet, with the cut side, tabs and depths you set there. Clear layout goes back to the single drawing.

If not every part fits, the page says how many were left out: use a bigger sheet, a smaller gap, or cut a second sheet.

4.5 Laser image

This engraves a photo or logo with the laser, line by line, with the power following how dark each point is. Open a PNG or JPG with Open image.

SettingWhat it does
WidthThe engraved width in mm; the height keeps the picture’s shape. X0 Y0 is the bottom-left corner.
Line intervalDistance between lines. 0.1–0.2 mm is typical; smaller is finer but slower.
ModeGreyscale varies the power; Dither uses dots, good for photos on wood; Black/white cuts everything darker than the Threshold, best for logos.
Brightness, Contrast, GammaAdjust the picture before engraving. Invert engraves the light areas instead.
Max / Min power (S)The laser power for black and for the lightest engraved grey. Max is usually your laser’s full power (the controller’s S range, often 1000).
OverscanExtra travel at each end of a line so the laser is moving at full speed while it burns. Leave a few mm.

The picture shows the engraving as it will burn, and the result gives the size and an estimated time. Focus the laser on the material and use the laser’s safety glasses and extraction.

4.6 3D relief

A 3D relief turns a greyscale picture (a heightmap) into a carving: white is the top surface and black is the deepest point. Heightmaps come from relief software, 3D programs or online libraries.

3D relief: finishing path with a tapered ball nose
Figure 17: 3D relief: finishing path with a tapered ball nose
  1. Open Tools > 3D relief and click Open image.
  2. Enter the Width and the Depth of the carving. Smoothing softens a noisy picture; Resolution sets how fine the model is (higher is finer and slower to calculate).
  3. Choose the Passes (see below) and the finishing tool: Ball nose (enter its diameter) or Tapered ball nose (enter the tip diameter, the taper in degrees per side and the shank diameter).
  4. Enter the Stepover. For a ball nose 8–12% of the diameter gives a smooth finish; for a fine tapered tip 25–40% of the tip is typical.
  5. Tap Make G-code. Reliefs take a few seconds to calculate. Check the picture (Depth map shows the model) and the result: file names, time and the scallop height (the small ridges between passes).
  6. Tap Save to SD, Save & Run or Download.
PassesWhat happens
Rough + finish · 2 filesFile 1: a flat end mill removes most of the material in steps, leaving a small allowance (for example 0.5 mm). File 2: the ball nose or tapered ball nose follows the surface. Run file 1, change the tool, set Z zero on the top of the stock again, run file 2. Fastest for deep reliefs.
Finishing only · 1 fileOne tool, no tool change. The finishing tool cuts down in depth passes (Stepdown, for example 2 mm) and the last pass follows the surface. Good for shallow reliefs and fine detail.
Fine toolsA tapered ball nose has a very small tip. Keep the stepdown small (the page warns above twice the tip diameter) and the feed moderate. Finishing jobs can take hours – check the time estimate before you start.

4.7 Viewer & checker

This shows any G-code file in 3D and checks it before it goes near the machine: open a file from the computer with Open G-code, or tap 🔍 Check under any tool to check what it just made. Drag to turn the view, shift-drag or right-drag to move it, and scroll to zoom. Cuts are coloured by depth and rapid moves are dashed; Simulate progress shows how far the job has got at any point.

Viewer & checker: a file with problems found
Figure 18: Viewer & checker: a file with problems found

Choose your machine model and stock thickness. The checker then warns about:

  • rapid (G0) moves below the material surface, which would crash the cutter;
  • cutting with the spindle off, or before a feed rate is set;
  • a job bigger than the machine’s travel, or cutting deep into the spoilboard;
  • codes FluidNC does not support (such as cutter compensation G41/G42) and tool changes (M6).

It also works out the run time (allowing for the machine’s acceleration) and a job cost: enter your machine rate per hour, setup time, material and tool wear, the quantity and your markup to get a price.

4.8 Feeds & speeds

This gives starting feeds and speeds for solid-carbide router bits. Choose the material and bit type, enter the diameter, flutes and spindle speed; the page shows the RPM, feed, plunge rate, depth per pass and chip load, limited to what the machine can do (it lowers the RPM if the feed would be faster than the machine allows). The table underneath shows the same bit in other materials. Use in DXF → G-code copies the values into the DXF tool.

Feeds & speeds
Figure 19: Feeds & speeds
Fine-tuningThese are starting points. Make a test cut: a steady hum and clean chips are right; squealing or dust means the feed is too low or the RPM too high; a labouring spindle means too deep or too fast.

4.9 Saving projects and settings

The buttons at the bottom of the Tools menu save your work as a file on the computer, so you can open it again later or on another computer.

ButtonWhat it does
Save projectSaves every setting in every tool plus the DXF drawing, the nested layout, the laser and relief pictures and the file in the checker. Opening it puts everything back as it was, on the tool you were using.
Save settingsSaves only your machine, tool and cutting settings (no drawings or pictures). Use it to keep your workshop defaults, or to set up another computer the same way.
Open projectOpens a saved project or settings file (.touchblue).

Files are saved to the computer’s Downloads folder (or the browser asks where to save them, if it is set to). The page also remembers your last settings in this browser, but a saved file is the safe copy.

0
0
Quote Request
Your cart is emptyReturn to Shop