MKS MKS TFT28 User manual

Guangzhou Qian Hui Information Technology Co.,
Ltd
Mail:Shell[email protected]n
Document version: 1.0
Published date: 2017.9.19
MKS TFT28/32 Color touch screen
instruction

Copyright © Guangzhou Qian Hui Information Technology Co., Ltd. All rights reserved.
No part of this document may be reproduced or transmitted in any form or by any means without prior written consent of the
Company.
Trademark statement
Both and Makerbase are the trademarks of Guangzhou Qian Hui Information Technology Co., Ltd.
All other trademarks or registered trademarks mentioned in this document are owned by their respective owners.
Notice
The products, services or features you purchase, etc., shall be subject to the commercial contract and terms of the Guangzhou
Qian Hui Information Technology Co., Ltd., all of which are described in this document or part of the product, service or feature
may not be within your purchase or use. Unless otherwise agreed by the contract, Guangzhou Qian Hui Information Technology
Co., Ltd. does not make any express or implied claim or warranties with respect to the contents of this document. Due to product
version upgrade or for other reasons, this document is updated from time to time. Unless otherwise agreed, this document is
provided as guidance only, all statements in this document, information and the recommendation does not constitute any express
or implied warranties.
Firmware version update
Version
Modification
time
Modification content
V1.1.3
2016.5
1.Fixed the problem that TFT can't communicate with controller board after
firmware or baud rate updates.
2.Fixed error bug of More Menu .
V1.1.4
2016.6
1.Available to set the Max temp of extruder and bed on config.
2.Available to set value to trigger filament monitoring(high/low leveling).
3.Fixed U dish frozen BUG.
4.Bed leveling icon does not display by default.
V1.1.5
2016.8
Available to set 'Auto Off After Printing Finishes' function on config and display it
inside 'More' interface.
V1.2.0
2016.11
1.Improved display speed and screen touching, faster and more sensitive.
2.Available to switch title languages, including simplified Chinese,Chinese
traditional,English.
3.Fixed info error of wifi display.
4.Fixed display error that can't find sd card or u disk after reboots.
5.Support manual leveling and filament change.
6.Added "More" icon on printing operation interface for user-defined.
7.Deleted screen calibration function.
V2.0.0
2017.2
1.Updated screen interface, added 3 different home pages for 3 different
firmwares.
2.Added 'print from breakpoint' function.(Continue button)
3.Deleted Baud Rate 'connect' button,but available to set it on config.
4.Updated leveling interface.
5.Fixed E position error after printing pause and filament change.
6.Available to see the z axis' height when moving or printing.
V2.0.1
2017.5
1.Fixed the socket of “auto-off after printing”.
2.Available to choose “manual leveling” or “auto-leveling”.
3.Compatible with “MKS TFT WIFI” , “MKS HLK-WIFI” and the latest version
phone APP “MKSCloud”.
4.Added “cloud service” and “mobile transfer files” functions.
5.Added Windows style.
V3.0.0
2017.9
1.Added multi-language, available to switch 5 languages on line.
2.Fixed “WIFI transfer” problems.
3. Optimized the “filament replacement” function.

Contents
I. Overview ......................................................................................................................................4
II. Main Features ..............................................................................................................................4
III. Connection and Dimension ..........................................................................................................4
IV. Function Instruction......................................................................................................................7
V. Special Function Button Customization......................................................................................21
VI. Themes Interface Display...........................................................................................................22
VII. Booting Logo and Button Pictures Customization Fuction .........................................................24
VIII. Assurance ..................................................................................................................................32

I. Overview
MKS-TFT28/32 is color touch screen, researched and developed by Makerbase developers, which is suitable for open sourced
3D printers. It can work with MKS Base, MKS Gen, MKS Sbase and so on. Compared to TFT32, TFT28 supports external DC
12V and works with Ramps1.4.
II. Main Features
Support 5 languages online switching.
2.8/3.2-inch color touch screen , support U disk and SD card.
Reserve wifi interface,support wifi function by adding wifi module.
Three themes, two styles, provide the users with more choices.
Allowed to self-design the interface of booting logo and all buttons.
Allowed to add at most 13 customized function buttons.
Update the configuration and firmware by SD card, easily operate.
Work with MKS series controller board developed by Makerbase, TFT28 can work with Ramps 1.4 too.
Support “print from breakpoint”, “print from power outage”and “filament outage detection”function.
Support “auto off after printing finishes”function with MKS PWC module.
III. Connection and Dimension
1.MKS TFT28/32 Physical Map

2.MKS TFT28 Installation Dimensional Drawing
3. MKS TFT32 Installation Dimensional Drawin
4. MKS TFT28 Interface Diagram
SD expandor
interface
Board
interfac
e
B0 power outage detection
module interface
B1 filament outage
detection module interface
Power
interface
Power option
jumper
WIFI module
interface
B4 MKS PWC
module interface
U disk
interface
SD card
interface

5. MKS TFT32 Interface Diagram
6. Hardware Connection Instruction
6.1 Connect to Ramps 1.4, only TFT28 can work with Ramps 1.4.
6.1.1. Connect the TFT display to the Aux-1 of Ramps 1.4;
6.1.2. The power option jumps to 12V.
6.1.3. The power of TFT display inputs 12V.
6.2. Connect to MKS Gen
Connect the TFT display to the Aux-1 of MKS Gen. The TFT display is not necessary to connect external 12V power supply
B4 MKS PWC
module interface
块接口
WIFI module
interface
U disk
interface
SD card
interface
SD expandor
interface
Board
interface
B0 power outage detection
module interface
B1 filament outage
detection module interface

6.3. Connect to MKS Base,MKS GEN-L, MKS MINI and MKS Base
Connect the TFT display to the Aux-1 of MKS series controller board. The TFT display is not necessary to connect external
12V power supply.
IV. Function Instruction
1. The way to get the latest firmware
1.1. Ask the customer services for the latest firmware.
1.2. Login this website to download: https://github.com/makerbase-mks/MKS-TFT
2. The ways to upgrate the TFT firmware
2.1. Copy the latest program to the the root directory of the SD card, including:
Notice: Do not change the file name.
2.2. Plug the SD card, power up again. The screen will show the upgrating progress when hearing a short sound “didi~”, then
the upgrating is finish after about 30 seconds.
2.3. View the current firmware version through clicking “Set>About”.
2.4. Suggest deleting the picture file to avoid uograting the picture again when booting next time.
Notice: when using Ramps 1.4, you must connect external 12V power supply to the TFT display before upgrating the firmware.
3. Boot Settings
It’s necessary to set the printer type when getting the configuration.

Notice:
3.1. For communicaion, the baud rate of the TFT display must be same as the controller board.
3.2. To avoid the conflict with the USB interface, it is not advisable to connect the USB and TFT display at the same time.
3.3. Click “set>File Sys>U disk” when using U disk, only on this way can the TFT display show U disk file.
4. Multiple language Settings
Support 5 different languages :
1: Chinese
2:Traditional Chinese
3:English
4:Russian
5:Spanish
It’s available to set whether enable multiple language.
4.1.Disable multiple language: the use is the same as before. The words are on the pictures, so the shown language is achieved
by flashing the pictures.
4.2.Enable multiple language: It’s available to set whether enable multiple language.
5. Automatic Leveling and Manual Leveling
5.1. It’s available to choose auto leveling function if the printers are equipped with the leveling device. You just need to click
“set>Leveling” on the UI interface.
Notice: If you use the controller board running smoothieware firmware, you should choose G32 on config.
5.2. Manual leveling can be used to the common printers, such as MB and I3. You just need to set the three points, four points or
five points that are needed to level on the heated bed in the TFT config.As shown below,
6. Filament Replacing Function
Filament replacement function helps easily replace the filament, moreover, users can replace the filament by clicking “Pause”
#multi-language(enable:1, disable:0)
>cfg_multiple_language:1
#languages setting (simplified Chinese:1; traditional Chinese:2; English:3; Russian:4; Spanish:5). This
configuration is valid when "cfg_multiple_language" is disabled.
>cfg_language_type:1

9
during the printing. Users can set the extruder unload speed and min temperature of “filament replacement process” on the config.
7. Print from the Breakpoint Function
Undoubtedly, you must feel crazywhen you mistake the operation to stop the printing. Take it easy, the printing from the breakpoint
function would help you save your beloved model . The operations are as followed,
7.1. Click “pre-heat , set the target temperature of the extruder and heated bed . (picture1, picture2)
(No heated bed, you can ignore the target temperature of the heated bed. )
7.2. Click “Home” when the temperature reaches to the target temperature, let every axis go back to the zero point. (picture 3)
7.3. After every axis goes back to the zero point, move the nozzle to the layer where stops printing. (picture4, picture5) As shown
below,
7.4. Click “Set”, then click the printing from the breakpoint, choose the file that print from the breakpoint.( picture6, picture7)
7.5. After choosing the file, just wait to print. (picture8) (After choosing the file, the larger and more complicated the model is,
the longer time you need to wait.)
8. Power Outage to Save
The printer is allowed to directly turn off if it suddenly enters the pause state while printing. The printing will be continued from the
pause when restarting next time.( Remember to delete the upgrated file from the SD card to avoid upgrating firmware again when
booting next time, otherwise, it can’t print from the power outage point.)
9. Power Outage to Continue(only above MKS TFT28 V1.1 can support this function)
9.1. Don’t connect UPS power supply
The printer will continue printing from the pause when restarting, if it suddenly powers out.( The motor can not be driven due to
#the speed to extrude filament(mm/min)
>cfg_filament_load_speed:1200
#the lenght to extrude filament (mm)
>cfg_filament_load_length:200
#the speed to retract filament(mm/min)
>cfg_filament_unload_speed:1200
#the lenght to retract filament(mm)
>cfg_filament_unload_length:200
#It is the minimum temperature for filament change.It will auto heat up if the current temp doesn't
reach the target.
>cfg_filament_limit_temperature:200

10
power failure, so the extruder still stay on the model, which may cause defects on the model. If you need a more complete way
to deal with such situation, a power outage detection module and UPS is necessary).
9.2. Connect UPS
9.2.1 S connects to PB0, negative and positive connects “-“ and “+” of PB0 .
9.2.2 Power outage detection module will inform the TFT display to enter the printing pause state when the system powers out,
then the UPS will provide the power for the extruder to leave the model.
10. Filament Outage Detection function(only above MKS TFT28 V1.1 can support the function)
One end of MKS DET connects to the PB1, another end connects to the “-“ or “+” of the PB1.( If Low Level effective, it connects
to “-“, if High Level effective, it connects “+”.) Choose the Low Level effective or High Level effective in the configuration.
B1
-
+

11
11. Auto-off after Printing Finishes Function (only above MKS TFT28 V1.1 can support the function)
With MKS PWC module, enable the auto-off after printing finishes function on config.
（Note that do not reverse the zero wire and FireWire ）
L
(AC
)N
-V
–V
-V
+V
+V
+V
grey cable
power supply
220V
reset switch

12
V. Web-Print Manual
MKS WIFI Module Connection (only above MKS TFT28 V1.1 can support the function)
MKS TFT can support MKS WIFI module, which can be modified in the configuration:
Both MKS TFT28 and MKS TFT32 can use “network printing” function with MKS TFT-WIFI.
1.Web-Print Mode Introduction
1.1 Cloud Print Mode
It is recommended when router is available to Internet. Printer is ability to connect Cloud after
successfully configure network parameters of WIFI module. That you can powerful control your
printers by APP or MKS Cloud platform from anywhere around the world. Certainly, it is capable to
monitor printers by LAN on host-software, such as Printrun, proterface.
1.2 LAN Print Mode
If WIFI router can ‘t access to the Internet or at a slow speed, recommend this mode. You can
remote monitor of all your 3D printers. Start, stop, pause or edit prints, etc.
1.3 AP Mode
This mode will activate under following network environment.
a. Without wifi router.
b. WIFI is unconfigured.
c. WIFI is configuered, but unable to connect .
Then, the WIFI will generates a open hotspot “MKSWIFI-XXXX” which enter freely without password.
Support to control printers by APP, Web, Host-software.

13
2.Cloud Mode
2.1 WIFI Config
2.1.1 MKS TFT-WIFI
Please configure wifi firmware as follow:
mks_config.txt
Tip
#wifi type(0: MKS TFT-WIFI 1:MKS HLK-
WIFI
>cfg_wifi_type:0
Select : MKS TFT-WIFI
#wifi mode(0:sta;1:ap)
>cfg_wifi_mode:0
Select : STA
#wifi name
>cfg_wifi_ap_name:TP-LINK_C944
Set the WIFI name as the same
as the router required.
#wifi password
>cfg_wifi_key_code:makerbase
Set the password as the same
as the router required.
#cloud services(0:disable;1:enable)
>cfg_cloud_enable:1
#cloud ip
>cfg_wifi_cloud_host:www.baizhongyun.cn
# cloud services port
>cfg_cloud_port:10086
# dynamic IP
>cfg_ip_dhcp_flag:1
#IP/mask/gateway
>cfg_ip_address:192.168.3.100
>cfg_ip_mask:255.255.255.0
>cfg_ip_gate:192.168.3.1
Not require to edit.

14
2.2 Firmware Upgrade
2.2.1 Copy latest firmware to root of SD card, include:
MksWiFi.bin
mkstft28.bin
mks_config.txt
mks_pic
2.2.2Notes on Upgrade
a. Document names are not allowed to edit. Or will fail to upgrade.
b. The document names will get changed after update successfully.
c. Available to check current version inAbout interface.
2.2.3 Greatly, it is able to upgrade WIFI firmware by WEB. At same LAN, enter IP on PC, then go into web. As
follow:
MKS TFT
1.Select WIFI
2.Click update
Select WIFI
mode
1.STA:Router name and
password

15
2.3MKS APP

16
3.LAN Print Mode
3.1 WIFI Config
3.1.1 MKS TFT-WIFI
mks_config.txt
Tip
#wifi type(0: MKS TFT-WIFI 1:MKS HLK-
WIFI)
>cfg_wifi_type:0
Select : MKS TFT-WIFI
#wifi Mode(0:sta;1:ap)
>cfg_wifi_mode:0
Select : STA
#wifi name
>cfg_wifi_ap_name:TP-LINK_C944
Set the WIFI name as the same
as the router required.
#wifi password
>cfg_wifi_key_code:makerbase
Set the password as the same
as the router required.
# cloud services(0:disable;1:enable)
>cfg_cloud_enable:0
# cloud ip
>cfg_wifi_cloud_host:www.baizhongyun.cn
# cloud services port
>cfg_cloud_port:10086
# dynamic IP
>cfg_ip_dhcp_flag:1
# IP/mask/gateway
>cfg_ip_address:192.168.3.100
>cfg_ip_mask:255.255.255.0
>cfg_ip_gate:192.168.3.1
Disabled cloud services is
recommended when control via
LAN.

17
4.1 Software Upgrade
4.2.1 Copy latest firmware to root of SD card, includes:
MksWiFi.bin
mkstft28.bin
mks_config.txt
mks_pic
Notes on Upgrade
a. Document names are not allowed to edit. Or will fail to upgrade.
b. The document names will get changed after update successfully.
c. Available to check current version in About interface.
4.2.2 Greatly, it is able to upgrade WIFI firmware by WEB. At same LAN, enter IP on PC, then go into web. As follow:
Greatly, it is able to upgrade WIFI firmware by WEB.At same LAN, enter IP on PC, then go into web. As follow:
MKS
TFT

18
4.3 APP
4.AP Print Mode

19
Feature: The WIFI will generate a open hotspot “MKSWIFI-XXXX” which is no password required, can be
connected directly.
4.1 WIFI
4.1.1MKS TFT-WIFI
mks_config.txt
Tip
#wifi type(0: MKS TFT-WIFI 1:MKS HLK-
WIFI
>cfg_wifi_type:0
Select : MKS TFT-WIFI
#wifi mode(0:sta;1:ap)
>cfg_wifi_mode:1
Select AP mode, and take WIFI
module as a hotspot.
#wifi name
>cfg_wifi_ap_name:TEST-WIFI
Set name freely.
#wifipassword
>cfg_wifi_key_code:makerbase
Set wifi password freely.
#Cloud(0:disable;1:enable)
>cfg_cloud_enable:0
# cloud ip
>cfg_wifi_cloud_host:www.baizhongyun.cn
# cloud services port
>cfg_cloud_port:10086
# dynamic IP
>cfg_ip_dhcp_flag:1
# IP/mask/gateway
>cfg_ip_address:192.168.3.100
>cfg_ip_mask:255.255.255.0
>cfg_ip_gate:192.168.3.1
Disabled cloud services is
recommended when select AP
mode.
4.2 Software Upgrade
Upload the latest firmware to wifi module.
4.3 Notes on Upgrade
a. Document names are not allowed to edit. Or will fail to upgrade.
b. The document names will get changed after update successfully.
c. Available to check current version inAbout interface.

20
4.4APP
4.5 Printrun
①Here is “IP+:8080”,which is essy to find in WIFI setting.