TFT manual

TFT calibration at first start

When first turned on, you are prompted to calibrate touch screen, for this, press precisely each corner shown on the screen with the stylus provided with TFT.

If you want to redo the calibration, just set the function “#define REPEAT_CAL false” to true (in the Config.h tab of the firmware), do the calibration and return the function to “false” once done.

Info Menu(at starting)

  • Display of the Wpos and Mpos position of the XYZ axes (Wpos: These are coordinates relative to the current marker, Mpos: These are coordinates relative to the zero machine, which is initiated by “Home” command.)
  • Wifi status (disconnected in red, connected in white)
  • Possible error messages at the top, for example “no Nunchuk” if the nunchuk is not connected
  • Setup button to Setup menu
  • Mill button(fraisage) to the Mill menu

Setup menu

  • At the top, local IP address of the TFT (if wifi configured in the TFT firmware)
  • At the top right is the status GRBL (= machine status). If GRBL does not answer (for example because it is in Alarm after activation of the limit switches) the displayed status is “??”
  • Home button (Homing), starts the homing sequence of the 3 axes
  • Move button to the Move menu
  • “Set XYZ button”, to Set XYZ menu (to reset one or more axes to 0)
  • Cmd button, to the Cmd menu that contains the custom icons made by yourself
  • Info button, return to the Info screen
  • Mill button, to the Mill menu
  • Reset and Unlock buttons, if alarm (for example if endstop triggered), disengage the endstop and press Reset ,then Unlock to restart the machine.

Set XYZ Menu

  • Allows you to see the Wpos position of the axes and reset them to 0 independently or all at the same time
  • Setup button, back to the Setup menu
  • Info button, back to Info screen

Mill menu

  • SD card button, allows you to browse files on the SD, select and launch a job from a .gcode file, or select and install a custom button creation file that will go place in the Cmd menu.
  • USB button, allows to connect a computer to GRBL through the USB port of the TFT. To do this, connect the USB port of the ESP32 (TFT) to the USB port of the computer. In the GRBL control software or serial console, select the correct COM port and Baudrate 115200, connect, and then press the USB button on the TFT. The TFT becomes “transparent” and the PC is directly connected to GRBL. You can then see the GRBL log, send commands, view / change the config, launch a job from the computer …
  • Telnet button, can connect a computer to GRBL through the Wifi, for this you need a GRBL console software or series that allows you to specify an IP address, at my place in place of the com com I enter “ socket: //192.168.xx: 23 “(replace the x by your IP address displayed on the TFT), Baudrate 115200. Click on connect, then press the” Telnet “button on the TFT, there the computer has the hand and more the TFT, you can from the computer see the serial log, send commands, but not directly launch a job file from the computer because the wifi via router has too much latency, but it’s possible from your computer to upload a G-code file to the TFT’s SD card and launch it remotely 🙂

Cmd menu

  • This menu is empty (just the icon back to Info menu), it’s here that will be stored custom buttons that you can create in the next section (up to 7 custom buttons)

Create custom buttons

  • On his computer, create a new text file
  • rename it for example Cmd1_Z-Probe.txt; Cmd1_ will be on the top left, Cmd2_ on the right, and so on until Cmd7_; Z-Probe is the name that will be displayed, you can name it as you like, but without space.
  • Then open the file and enter the commands you want the button to execute.
  • Save and put the file in SD card root, which you put in the TFT
  • In Mill menu > SD card, press your button file, nothing happens, it’s normal
  • Restart the machine then go to the Cmd menu, your button is created and active

Examples of buttons:

Cmd1_Z-Probe.txt contains the code:

G91 G21 ;                (Relative position in mm.)
G38.2 Z-30 F100 ;(Search of the probe on 30 mm. speed 100, if not found after 30 mm. Alarm GRBL)
G0 Z1 ;                    (back 1mm.)
G38.2 Z-1 F10 ;     (Searching the probe for 1 mm, slower, speed 10)
G92 Z20 ;    (Adjustment of the Z offset according to the thickness of the probe, 20 mm in this case)
G0 Z3 ;                   (back 3mm.)

Cmd2_Spindle-ON.txt contains the code:


Nunchuk use

To connect the Nunchuk, if you connect it without the TFT cover, check the direction of the contacts on the plug, on one side there are 3 contacts, on the other 2 contacts.

Nunchuk must be plugged in before turning on the power. It is not recognized if it’s plugged in after. It’s not active if you are in USB or Telnet mode (use the pc in this case)

Nunchuk is active when the machine is in Idle or Jog state

To move  X and Y axes, press C button, to move Y backward, push the lever forward and vice versa, to move X right, push the lever to the right and vice versa.

To move the Z axis, press and hold the Z button, when you push the lever forward, Z goes up, and vice versa.


Go to “From DXF to Gcode and first use”