FluidNC Set Up and First Job

Version 1.3 · Updated 21 November 2026 · Screens from TouchBLUE 1.3.5 · For BlueCarve machines with a FluidNC controller and TouchBLUE tablet
Back to all instructions

This guide is for every BlueCarve machine with a FluidNC controller (it has a FluidNC sticker on the black controller box) and the 7″ TouchBLUE tablet.

Before you startAssemble and connect your machine first, using its set-up guide (Turbo and AXE or Trax). If you are fitting a FluidNC upgrade kit to an older machine, swap the controller first using the conversion guide. Read the router safe operating procedure before you switch on.

1. How it works: CAD, CAM, Control

Every job goes through the same three steps. The first two happen on a computer. The third happens at the machine, on the tablet.

1. CADDesignDraw your part on a computer: Easel, Fusion, Inkscape, or any program that makes a DXF or SVG drawing. Compare CAD programs
2. CAMToolpathsChoose the bit, depths and speeds, then export a G-code file (.nc or .gcode). Use Easel, Fusion, or the Tools page on the tablet’s own web page. Compare CAM programs
3. ControlRun it on the TouchBLUE tabletPut the file on the controller (microSD card, or WiFi upload to http://192.168.0.2), then home, zero, run, pause and stop from the tablet.

Which programs to use, what they cost, how hard they are to learn and how to save G-code for FluidNC from each one: see Making G-code for your FluidNC CNC.

All control is done from the tabletThe tablet talks to the FluidNC controller over the machine’s own WiFi network (BLUECARVE). The USB port on the controller is a service port for BlueCarve support only. Don’t connect a computer to it to run the machine, and don’t try to drive a FluidNC machine from Easel, UGS or any other sender program.
Powering the tabletThe tablet has no battery. Power it from any USB wall adaptor (a phone charger is fine) with any USB-C cable, or from a USB power bank. You can unplug it at any time: when it has power again it reconnects to the machine by itself. Keep it powered while a job runs, because Pause and STOP are on the tablet. The emergency stop on the machine always works.

2. Check your tablet is up to date

  1. Turn on the tablet. The version number shows on the first screen.
    TouchBLUE start-up screen with the TouchBLUE logo, the words CNC Touch Controller and Version: 1.3.5
    The start-up screen shows the version (here 1.3.5).
  2. If your tablet shows a lower version number than 1.3.5, update it to the latest version: click Update the tablet below. If it shows the same number, it is up to date: go to section 3.
Update the tablet to version 1.3.5
  1. Use Chrome or Edge on a computer (Windows, Mac or Linux). Safari, Firefox and phones can’t do this.
  2. Connect the tablet’s USB-C port to the computer with a USB-C data cable (some cables only charge). The cable powers the tablet too.
  3. Close any other program that might be using the tablet’s USB connection.
  4. Click the button, pick the tablet’s port from the list, then choose Install.
This browser can’t update the tablet. Open this page in Chrome or Edge on a computer.The updater needs a secure (https) page. Use touchblue.pages.dev instead.
  • It takes two to three minutes. Don’t unplug the cable or close this page until it says it has finished. The tablet restarts by itself, and your settings stay as they are.
  • The tablet isn’t in the port list, or it fails? Try another cable and another USB port (no hubs). On Windows the tablet may need its USB driver (CH340 or CP210x). It is safe to run the update again.
  • The button doesn’t appear? Use the updater page at touchblue.pages.dev instead.

3. First-time set up

  1. Check the emergency stop is connected to the controller and released (twist it to release).
  2. Connect power to the controller using the 24 V power pack.
  3. If you intend to use them, connect and power the VFD (spindle) and the laser.
  4. Power the tablet (any USB wall adaptor and USB-C cable).
  5. The start-up screen shows for a few seconds, then the main screen opens and the tablet connects to the machine by itself. There is nothing to select.
  6. When the word at the bottom left changes from a red OFFLINE to a green IDLE, the tablet is connected (this can take up to 30 seconds).
    • If an ALARM message appears, tap Clear Alarm.
    • If a gantry is resting against a sensor, the next steps will fail. Turn off the controller, push the gantry back off the sensor by hand, then power up again.
    TouchBLUE Status tab showing IDLE, work and machine positions, and the INPUTS lamps PROBE, LIMIT X, LIMIT Y and LIMIT Z
    The Status tab. IDLE means connected and ready. Under INPUTS, the PROBE and LIMIT X, Y and Z lamps light up when that sensor is triggered.
  7. Test the limit sensors. Hold a metal object against each sensor in turn. On the Status tab, the matching LIMIT X, LIMIT Y or LIMIT Z lamp under INPUTS should light up. If one doesn't light up, power off and check that sensor's connection.
    Inductive limit sensor at the end of a Y axis
    Y axis sensor
    Inductive limit sensor on the X axis
    X axis sensor
    Inductive limit sensor on the Z axis
    Z axis sensor
  8. Test the Z probe. Connect the probe and touch the clip to the probe plate. The PROBE lamp under INPUTS should light up.
    Z probe plate and clip being touched together to test the probe
    Touch the clip to the plate: the PROBE lamp lights up.
  9. Home the machine. Clear the bed, go to Control > Actions and tap Home All. The state shows HOME while the machine moves to its sensors, then returns to IDLE.
    TouchBLUE Control tab, Actions page, with Pause, Unlock, Soft Reset and STOP, the Home X, Y, Z and Home All buttons, and the Zero buttons
    Control > Actions: Home All is in the middle column.

That completes the commissioning of your CNC. Next, make your first job file in Easel.

4. Your first job in Easel

Because Easel is free, let's carve something simple step by step: a name plaque, 180 x 100 mm, cut from 12 mm plywood. The name is engraved 2 mm deep, then the plaque is cut out with small holding tabs. It takes about 7 minutes on the machine, with one 3.175 mm (1/8") flat end mill.

You design in Easel on a computer, save the job as a G-code file, and run it from the tablet. Easel doesn't drive a FluidNC machine. Prefer another program? Making G-code for your FluidNC CNC compares Vectric, MillMage, Fusion, the tablet's Tools page and free options.

4.1 Create your Easel account

  1. Go to easel.com in Chrome or Edge and sign up with your email address.
  2. Easel emails you a confirmation link. Click it, then sign in.
What's freeA new account starts with a 14-day Easel Pro trial. After that the free Basic plan lets you design as much as you like, but save (export) only one G-code file a week. Features marked PRO, including most fonts, V-carving and 3D, need a paid plan. This plaque uses only free features.

4.2 Set up your machine in Easel (once)

  1. On the Getting Started page click Set up my CNC machine, then Start Machine Setup. (Later you'll find this under Machine > Set up new machine.)
    Easel Getting Started page with buttons Set up my CNC machine, Take a guided tour and Start a new project
    Easel's Getting Started page.
  2. Choose Blue Carve as the manufacturer.
    Easel Choose CNC Manufacturer page with Blue Carve among the manufacturers
    Blue Carve is in Easel's manufacturer list.
  3. Choose Other (bottom right). Don't pick the Turbo, Trax or Bluey pictures: those profiles make Easel run the machine over USB, which is for the older Arduino controllers.
    Easel Choose CNC Model page listing BlueCarve Full Sheet Trax, Turbo sizes, Bluey v2 sizes and Other
    For a FluidNC machine, choose Other.
  4. Fill in the details, then click Next:
    ModelAny name, for example Turbo 1x1 FluidNC
    Motion ControlOther. Not "FluidNC (Beta)": that option is for Easel driving the machine over USB, and your machine is run from the tablet.
    Work Area X and Y (mm)Your machine's work area (table below)
    Spindle ControlAutomatic
    MachineSizeWork area XWork area Y
    Turbo1 x 1800800
    Turbo1 x 1.58001300
    Turbo1.5 x 11300800
    Turbo1.5 x 1.513001300
    Trax1.5 x 3.012702770

    For other sizes, enter the furthest distance your machine can travel in X and Y.

    Easel Enter Model Details filled in: Make Blue Carve, Model Turbo 1x1 FluidNC, Motion Control Other, work area 800 by 800, Spindle Control Automatic, with the note that Easel will not provide machine control and you can export g-code
    Easel confirms it won't control the machine and that you can export G-code. That's what you want.
  5. Click Return to Projects.

4.3 Design the plaque

  1. Click Start a new project, type a name (for example "Name plaque") and click Create.
  2. Switch Easel to millimetres: click the mm switch at the bottom left of the drawing.
  3. Material. Click Material (top right), keep Birch Plywood, and set the size to 200 x 120 x 12 mm (measure your own board). Leave Work Zero on Front-left: on the machine you'll set zero at the front-left corner of the board, on top.
    Easel material panel with Birch Plywood, 200 by 120 by 12 mm, and Work Zero set to Front-left
    Material 200 x 120 x 12 mm, Work Zero Front-left.
  4. Bit and speeds. Click Bit. Keep the 1/8 in straight end mill (3.175 mm) and set the cut settings: feed rate 1200 mm/min, plunge rate 300 mm/min, depth per pass 1.5 mm, spindle speed 16000 RPM. These are gentle starting values for plywood. feeds.endmill.com.au gives values for other bits and materials.
    Easel bit panel with the 1/8 inch end mill and cut settings: feed 1200, plunge 300, depth per pass 1.5, spindle 16000
    Cut settings for this job.
  5. The outline. Click the Shapes tool (top of the left toolbar) and choose Square. In the Shape tab set width 180, height 100, X 10, Y 10 and corner radius 10 (X and Y). Then in the Cut tab:
    • Depth: 12 mm (all the way through).
    • Cut Path: Cut outside shape path.
    • Use Tabs stays ticked: 4 tabs, height 3 mm. The tabs hold the plaque in the board until the end.
    Easel drawing of a 180 by 100 mm rounded rectangle with four tabs, Cut tab showing depth 12 mm, Cut outside shape path, tabs 3 mm high
    Outline: cut outside, 12 mm deep, 4 tabs (the yellow marks).
  6. The name. Click the Aa (Text) tool and pick a font without a PRO badge, for example Bebas. Double-click the word TEXT on the drawing and type your name. In the Shape tab set width 140, height 53, X 30, Y 33.5 to centre it. In the Cut tab set depth 2 mm and keep Clear out a pocket.
    Easel drawing with BLUECARVE text centred in the plaque, Cut tab showing depth 2 mm and Clear out a pocket
    Text pocketed 2 mm deep.
  7. Check it. Click Simulate (right side) and play it, or drag the slider to the end. Blue lines are cuts; red lines are moves between cuts. This job takes about 6 minutes 40 seconds.
    Easel 3D preview of the plaque with the toolpaths in blue and moves between cuts in red, simulation time 6:41
    The simulation shows the finished plaque before you cut anything.

4.4 Save the G-code

  1. Click the green Export… button (top right). Easel downloads the file straight away, named after the project, for example Name plaque.nc, into your Downloads folder. (Project > Download > Download g-code does the same.) On the free plan this uses your export for the week.
    Easel top bar with the green Export button
    With a FluidNC ("Other") profile, Easel shows Export instead of Carve.
  2. Copy the file to the microSD card with the card reader and put the card back in the controller. Or send it over WiFi: join the computer to the BLUECARVE network, open http://192.168.0.2 and drop the file on the page.

Easel's file works on the tablet as it is: it's in millimetres, turns the spindle on at 16000 RPM and has no tool number, so the tablet's job check passes in Spindle Mode.

4.5 Carve it

  1. Clamp the board on the machine. Keep the clamps outside the plaque outline: Easel lifts the bit only about 4 mm between cuts, so it won't clear a tall clamp.
  2. Fit the 1/8" (3.175 mm) end mill.
  3. On the tablet: Home All, make sure Spindle Mode is selected, then jog to the front-left corner of the board and tap Zero X and Zero Y.
  4. Probe the top of the board: Control > Probe > Z Probe (see section 5). Remove the clip and plate.
  5. Open Files, tap Refresh, preview Name plaque.nc with the blue eye, then press the green play button. Stay by the machine with the emergency stop in reach.
  6. When it finishes, cut through the 4 tabs with a sharp chisel or knife and sand the edges.

Easel's own help covers designing and exporting G-code.

5. Running a job from the tablet

The full tablet instructions are in the TouchBLUE tablet manual. The basic steps for every job:

  1. Turn on the CNC and connect the tablet (tap BLUECARVE).
  2. Insert the microSD card with your job into the controller.
  3. Home the machine: Control > Actions > Home All.
  4. Secure your material.
  5. Jog to your start position: Control > Jog (pick a step size and tap the arrows) or Control > Dial (turn a dial like a handwheel).
  6. Zero the axes: Control > Actions > Zero All (or each axis).
  7. Probe the top surface: attach the black clip to the bit, place the probe plate under the bit on the material, then go to Control > Probe and tap Z Probe. The machine lowers the bit onto the plate and sets Z zero, allowing for the 15 mm plate. Remove the clip and plate before you start.
  8. Start the job from the Files tab with the green play button. The tablet checks the file, then switches to the Status tab, which shows the progress.
STOP is not an emergency stopWhile a job runs, the Status tab shows Pause and STOP. Pause holds the machine (tap Resume to carry on). STOP ends the job: the tablet waits until the machine has stopped moving, then returns it to IDLE. In an emergency, press the emergency stop button on the machine.

Machine states

StateMeaning
IDLE (green)Ready for commands
RUN (cyan)Running a job
JOG (cyan)Jogging
HOLD (yellow)Paused
ALARM (red)Error: needs clearing
HOME (blue)Homing

Clearing an alarm

  1. When the ALARM popup appears, tap Clear Alarm and wait for IDLE.
  2. Or go to Control > Actions and tap Unlock. If needed, tap Soft Reset.

6. Keeping the tablet up to date

BlueCarve releases tablet updates from time to time. Every few months, turn on the tablet and check the version number on its first screen. If it is lower than the latest version (1.3.5), update the tablet with the updater in section 2. The TouchBLUE tablet manual has the full instructions for the tablet.

7. Troubleshooting

ProblemCheck
Tablet screen is blankThe tablet has no battery: check the USB adaptor is switched on, and try another USB-C cable.
The tablet stays OFFLINE (red)Make sure the controller is powered (not just plugged in by USB) and wait about 30 seconds. Keep the tablet within a few metres of the controller. Restart the tablet.
"Machine was moving when it was stopped" or ALARM 3 after STOPThe position may be lost. Clear the bed, tap Home All, then set your zero again.
Status shows ALARMTap Clear Alarm, or Control > Actions > Unlock.
Homing fails straight awayA gantry may be resting on a sensor. Turn off the controller, push the gantry off the sensor, then try again.
A sensor light doesn't turn greenPower off and check that sensor's cable is fully plugged in at both ends.
The PROBE lamp doesn't light when you test the probeCheck the probe cable is plugged into the controller and the clip is clean.
Job file isn't listedCheck the microSD card is fully inserted in the controller and the file was exported as G-code.
All motors stop at onceA closed-loop motor fault. Find and clear the cause, then turn the controller off and on.
Need help?
Email adam@bluecarve.com.au with your machine model, size and a photo or short video of the problem. Owners also help each other in the BlueCarve owners group on Facebook.
0
0
Quote Request
Your cart is emptyReturn to Shop