代码收藏家 MKS GEN_L V2.1使用手册
广州谦辉信息科技有限公司
MKS GEN_L V2.1使用说明书
创客基地QQ群：489095605 232237692
邮箱：Huangkaida@makerbase.com.cn
文章目录
一、产品简述
MKS GEN-L V2.1主板是GEN_L V1.0的升级版本，升级支持了TMC2130驱动SPI 模式，TMC2208、TMC2209、TMC2225、TMC2226 UART模式，支持TMC2209、TMC2226无限位归零。
1.1特点优势
1、将2560及ramps1.4集合在一块板子上，解决了Ramps1.4组合接口繁琐、易出故障的问题；
2、用户可自己更换电机驱动，支持4988、8825、8729、TMC2208、TMC2209、TMC2225、TMC2226；
3、预留外接驱动信号，可外接大驱动来驱动57、86电机；
4、采用高质量MOSFET管，散热效果更好，保证长时间工作稳定；
5、采用专用电源芯片，支持12V-24V电源输入，解决Ramps电压转换芯片发热、供电不足问题；
6、稳定可靠的滤波电路大大降低干扰的可能性，最大可能的避免打印过程中出现的死机、乱跑等现象；
7、采用CH340串口芯片，在确保稳定可靠的前提下，降低成本，更是解决了以往16U2难装驱动的问题；
8、可以接受24V输入，同样系统功率下可以把热床电流减小到1/4，有效解决热床MOS管发热问题；
9、使用开源固件Marlin，配置和ramps1.4完全相同，可直接替代Ramps1.4，更加稳定；
10、支持LCD2004、LCD12864、MKS MINI12864 V1.0、MKS MINI12864 V3.0,支持创客开发的TFT24、TFT28、TFT32、TFT35、H43触摸屏；
11、XYZ轴分别采用不同颜色的端子来对应电机和限位开关，方便接线；
12、人性化的设计，用不同颜色的端子区分驱动方向，降低插反的概率，防止因驱动插反而损坏主板；
13、 支持了TMC2130驱动SPI 模式，TMC2208、TMC2209、TMC2225、TMC2226 UART模式，支持TMC2209、TMC2226无限位归零。
1.2主板参数
1.3接线图
1.4尺寸图
二、固件下载、编译、更新
2.1固件下载
MKS GEN_L V2.1适配的固件为Marlin2.X固件,固件可在Marlin 官方Github下载,固件下载地址：
https://github.com/MarlinFirmware/Marlin
2.2 固件编译
2.2.1 Arduino IDE 本地编译
Marlin2.X固件的编译需要Arduino IDE 1.8.8或以上的版本，Arduino IDE 下载链接：https://www.arduino.cc/en/software
2.2.2 Platformio本地编译
Platformio本地编译需要先安装VScode软件 和安装platformio编译插件，安装详情请参考视频教程：https://www.bilibili.com/video/BV1XK4y1C7k5
2.2.3 网页在线编译
在线编译，可登录创客基地百众云网页，上传固件的压缩包,在线编译，编译成功后的固件文件将会发送到你的邮箱，方便快捷，在线编译网址：https://baizhongyun.cn/home/index
网页在线编译教程链接：https://blog.csdn.net/gjy_skyblue/article/details/118763474?spm=1001.2014.3001.5501
2.3固件更新
2.3.1 使用Arduino IDE更新固件
1、首先给电脑安装CH340串口驱动，大部分电脑是能自动识别CH340,系统进行自动安装的，不能识别自动安装的需要手动安装，驱动下载链接：https://github.com/makerbase-mks/Software
文件下载后，双击DRVSETUP64进行安装驱动。
2、 主板与电脑接上USB线，在设备管理中可以查看到安装完成后的COM口。
3、上传marlin固件，烧写固件之前我们先把Arduino 设置为中文，这样更方便操作，点击“File”-“Preferences”，在 Editor language 中找到“简中文”，点击OK，再重新启动Arduino 软件，如果已经是中文的就不用了。
接下来开始上传marlin固件了,打开Arduino，执行“文件”》“打开” 选择要上传的marlin固件，并选择后缀名为***.pde或者***.ino的文件打开。
4、双击打开后，在Arduino软件上工具栏选择板卡类型为Mega 2560，并选择Port的COM口。
5、然后点击“上传”即可，也可先编译，再上传（注：不能接上串口屏进行上传固件，串口屏会占用主板串口，导致固件上传失败）。
6、点击上传后会先编译再下载，下载的时候可以看到主板的指示灯会闪烁，说明正在上传固件，待固件上传完成，指示灯停止闪烁，并且Arduino显示上传成功。
2.3.2 使用VScode 进行更新固件
1、 首先需要确认电脑能识别主板的串口，打开电脑的设备管理器，然后用USB连接主板与电脑，设备管理器中能识别主板的CH340 COM口即可。
2、修改编译环境，在platformin.ini文件，把编译环境改为mega2560
3、点击左下角“→”上传固件，等待上传完成即可。
2.3.3 使用Xloader更新固件
对于用网页进行固件编译的，固件编译成功后会发到网页上所填写的邮箱，编译好的固件为firmware.hex,需要用Xloader进行上传固件到主板。
1、下载Xloader 软件，可以在网上搜索下载一个
2、主板连接电脑，打开Xloader,导入已编译好的firmware.hex文件
3、然后芯片选择为ATMEGA2560,选择COM口，设置波特率
4、点击上传，等待上传完成即可
三、驱动跳线设置
注：主板上给驱动供电的电压是可以通过跳线设置的，可以设置为3.3或者5V，必须设置为其中一个，不设置驱动将无法工作，建议设置为5V，设置为3.3V时，A4988驱动的电压将减半，电流也减半。
3.1 A4988驱动跳线设置
A4988驱动细分跳线方式，驱动下方右边的3个跳线帽都插上是16细分，如下图（X轴为例）：
3.2 TMC2208、TMC2209、TMC2226普通模式跳线设置
TMC2208、TMC2209、TMC2226驱动细分跳线方式，驱动下方右边的2个跳线帽（M0、M1）插上是16细分，如下图（X轴为例）：
3.3TMC2225普通模式跳线设置
TMC2225驱动细分跳线方式，驱动下方右边的第2个跳线帽（M1）插上是16细分，如下图（X轴为例）：
3.4 TMC2208、TMC2209、TMC2225、TMC2226 UART模式跳线设置
TMC2208、TMC2209、TMC2225、TMC2226 UART模式跳线设置都是相同的，驱动下方的左边第3个跳线插上即为uart模式，如下图（X轴为例）：
注：UART 模式可以在屏上设置驱动的电流、工作模式，要实现UART 模式，还需要固件的支持，固件的配置方式详情见4.3.7
3.5 TMC2209、TMC2226 Sensorless(无限位）跳线设置
TMC2209、TMC2226 要实现sensorless功能，首先需要将驱动设置为UART 模式，限位接口不能接限位，然后需要在主板上的DIGA 排针处对应插上跳线帽，如下图（以X轴为例）：
注：1、由于Z轴丝杆阻力较大，容易误触发导致归零的位置不一致，因此不建议Z 轴使用sensorless功能
2、要实现sensorless功能，还需要固件的支持，固件的配置详情见4.3.7
四、Marlin 固件配置
4.1 固件基本配置（必须配置项）
4.1.1板卡配置
在configuration.h文件中将板卡配置为BOARD_MKS_GEN_L_V21
4.1.2 串口配置
在configuration.h文件中将串口设置为0，配置错误会将会导致主板与电脑无法连接。
4.1.3 屏幕配置
（注：LCD屏幕只能使能以下屏幕中的其中之一，同时使能多个会导致编译报错）
1、LCD 2004 配置，在配置文件中使能
#define REPRAP_DISCOUNT_SMART_CONTROLLER
2、LCD12864屏幕配置，在配置文件中使能#define REPRAP_DISCOUNT_FULL_GRAPHIC_SMART_CONTROLLER
3、MKS MINI12864 V1.0屏幕配置
在配置文件中使能#define MKS_MINI_12864
4、MKS MINI12864 V3.0屏幕配置
在配置文件使能MKS MINI12864 V3(注：如果配置文件中没有该配置项，则需要下载最新的Marlin2.X的固件）
在配置文件使能RGB
4.1.4 使能sd卡
在配置文件中使能#define SDSUPPORT
4.1.5 使能eeprom
在配置文件中使能#define EEPROM_SETTINGS
4.2机器参数配置（根据机器参数设置）
4.2.1 挤出头个数配置
MKS GEN_L V2.1最多支持2个挤出头
4.2.2 热敏类型配置
MKS GEN_L V2.1仅支持100K热敏，#define TEMP_SENSOR_0为挤出头1，#define TEMP_SENSOR_1 为挤出头2，#define TEMP_SENSOR_BED 为热床
4.2.3 限位类型配置
限位开关类型的配置（true/false),true为常开型开关，false为常闭型开关。
4.2.4 脉冲设置
在配置文件中的#define DEFAULT_AXIS_STEPS_PER_UNIT {80, 80, 400, 93}分别进行X、Y、Z、E各轴的脉冲设置，脉冲值需要根据机器的实际情况进行计算设置。
4.2.5 归零方向设置
在配置文件中进行归零方向设置，-1为往最小方向，1为往最大方向
4.2.6 打印平台范围设置
4.2.7电机方向设置
电机方向设置，false和true为代表两个转动方向，当移动方向相反，相反配置即可。
4.3高级配置
4.3.1 断电续打
在高级配置configuration_adv.h文件中，使能
#define POWER_LOSS_RECOVERY将 #define PLR_ENABLED_DEFAULT false改为
#define PLR_ENABLED_DEFAULT true
4.3.2 断料检测
在配置文件中使能#define FILAMENT_RUNOUT_SENSOR
在配置文件设置断料检测开关的电平（LOW/HIGH)
在配置文件文件中使能#define NOZZLE_PARK_FEATURE
在高级配置文件中使能#define ADVANCED_PAUSE_FEATURE
在高级配置文件使能#define PARK_HEAD_ON_PAUSE
在pins_MKS_GEN_L_V21.h文件中增加断料检测pin(注：该pin口需要根据断料检测开关所接到的pin进行配置，以断料检测接到X_min的限位为例，X_min限位的pin为D3,）
4.3.5 MKS UPS
在高级配置文件中使能以下配置项
Enable #define POWER_LOSS_RECOVERY
Set #define PLR_ENABLED_DEFAULT true
Enable #define BACKUP_POWER_SUPPLY
Set #define POWER_LOSS_ZRAISE 10 //断电后抬升的高度
Set #define POWER_LOSS_PIN 19 //(断电检测pin,需要根据所接到的pin设置，以pin D19为例）
Set #define POWER_LOSS_STATE HIGH
UPS使用教程：
1、如果屏幕是LCD 屏幕或MKS H43,断电后Z轴会抬升，上电后选择恢复打印即可。
2、如果屏幕是MKS TFT系列，需要在屏幕的配置中选择UPS,然后设置Z轴暂停抬升的高度要与主板配置的一致。
3、UPS与主板接线图
4.3.6 MKS PWC(打完关机模块）
注：打完关机模块的配置分为两种情况：
1、屏幕为LCD屏或MKS H43屏幕：
在配置文件中，使能#define PSU_CONTROL
将#define PSU_ACTIVE_STATE LOW改为 #define PSU_ACTIVE_STATE HIG
在pins_MKS_GEN_L_V21.h中增加以下代码：
#if ENABLED(PSU_CONTROL)
#ifndef PS_ON_PIN
#define PS_ON_PIN 11 //打完关机信号pin,根据自己的模块所接到的pin进行设置，以D11为例
#endif
#ifndef KILL_PIN
#define KILL_PIN 2 //断电检测pin,根据自己的模块所接到的pin进行设置，以D2为例
#endif
#define KILL_PIN_INVERTING true
#endif
要实现打印关机，还需要在Gcode的结束指令中增加结束代码M81
PWC与主板的接线图如下：
2、屏幕为MKS TFT 系列屏幕：
在配置文件中，使能#define PSU_CONTROL
将#define PSU_ACTIVE_STATE LOW改为 #define PSU_ACTIVE_STATE HIG
在pins_MKS_GEN_L_V21.h中增加以下代码：
#if ENABLED(PSU_CONTROL)
#ifndef PS_ON_PIN
#define PS_ON_PIN 11 //打完关机信号pin,根据自己的模块所接到的pin进行设置，以D11为例
#endif
#endif
注：要实现打完自动关机功能，需要在屏上的打印界面中的操作界面选择自动关机。
4.3.7 TMC 2208/TMC 2209/TMC 2225/TMC 2226 uart 模式配置
TMC 驱动 uart模式，需要硬件支持，需要在驱动左下第二个插针插上跳线帽（以X轴为例）。
在配置文件中使能TMC驱动，TMC2208和TMC2225均使能为TMC 2208，TMC 2209和TMC2226均使能为TMC2209。
TMC UART模式驱动电流设置，可在屏上的设置→高级设置→TMC驱动→驱动电流进行设置，也可在固件的高级配置进行设置（注：设置的电流需要乘以1.41才是峰值电流）。
TMC 2209 /TMC2226 sensorless（无限位） 功能配置，sensorless 需要硬件支持，需要在主板上的DIGA 排针处对应插上跳线帽（以X轴为例）
在配置中，将开关类型设置为false（以 X和Y轴为例）
在高级配置文件中使能sensorless_homing和配置阻塞阈值
五、3dtouch自动调平功能
5.1设置传感器触发电平
3dtouch的电平设置为false
5.2设置传感器信号pin
传感器信号pin需要根据主板的接线进行设置，一般情况下接到Z_MAX 限位或Z_MIN限位（注：3Dtouch的信号控制线为2pin线，黑线和白线，白线是信号线，以接到Z_MAX限位为例 D19）。
注：使用z_safe_homin功能,跳过此项配置，详见5.11 z_safe_homing配置
传感器信号线接线方式：
5.3 使能BLTOUCH
5.4设置探针与挤出头之间的偏移
分别为X、Y、Z轴的偏移，X和Y的偏移需要根据实际测量填写，Z_offset可以在调平完后进行测试调整。
5.5设置调平时传感器与打印平台边缘的距离
该数值默认为10（注：该数值不能设置为太小，太小会导致调平时传感器超出平台范围，导致调平失败）
5.6 使能自动调平
在配置文件使能线性自动调平
5.7 设置调平网格点数
在配置文件文件中设置调平点数，默认为3*3 个点
5.8 使能舵机
在配置文件中使能舵机#define NUM_SERVOS 1
5.9 增加自动调平数据调用代码
在G28.cpp文件中增加set_bed_leveling_enabled(true);
5.10 设置舵机pin口
在pins_MKS_GEN_L_V21.h的文件中增加舵机pin(注:该pin需要是没有上拉电阻的空闲pin,可以接到主板的D11或D21，以D11为例）：
#define SERVO0_PIN 11
舵机控制信号pin接线方式：
5.11 z_safe_homing 配置
注：z_safe_homing 是利用3Dtouch 作为Z轴的回零限位，其他配置项均与不使用z_safe_homing配置相同（5.2设置传感器信号pin除外），不使用z_safe_homing功能的，不用进行以下配置。
1、传感器信号pin设置，使用z_safe_homin功能，一般是使用z_min的限位pin，需要确保配置文件使能了#define Z_MIN_PROBE_USES_Z_MIN_ENDSTOP_PIN
2、在配置文件使能z_safe_homing
六、技术支持及保证
发货前会做通电测试，保证可以正式使用才发货。
欢迎各位朋友加入讨论群：232237692
欢迎光临博客交流： https://blog.csdn.net/gjy_skyblue
3D打印机主板定制，联系黄生：13148932315 谭生：15521395023 彭生：13427595835
有问题可联系我们客服或者在群里找技术支持人员，我们将竭诚为您服务
七、FAQ
1、主板无法更新固件如何处理？
答：确认电脑是否识别了主板的com口，电脑的设备管理器能看到CH340 COM口即可；
主板已接上过多负载的情况下，不建议用USB给主板供电来更新固件，这样容易供电不足导致无法更新固件；
主板不能接上串口屏的同时连接电脑进行更新固件，需要把串口屏断开。
2、更新固件后，LCD屏上显示的显示的脉冲、最大速度等参数不对如何处理
答：在屏上进入高级设置界面，初始化eeprom，然后返回到设置界面，保存数据，加载数据
3、主板无法与电脑的上位机连接怎么办？
答：确认配置文件中的主板的串口是否正确，MKS GEN_L V2.1使用的是串口0；
主板连接到电脑后，进入设备管理器查看电脑是否识别了主板的com口，如识别了，可以重启上位机，上位机设置的波特率需要与配置文件设置的一致；如无法识别，检查usb的连接是否接触不良。
4、3Dtouch自动调平效果不好如何处理？
答：⭐可以增加调平点数；
⭐可以在配置文件中使能#define MULTIPLE_PROBING 2，每点重复调平，以获取精度更高的平均值；
⭐可以切换自动调平的方式，#define AUTO_BED_LEVELING_LINEAR适合倾斜的平面平台
#define AUTO_BED_LEVELING_BILINEAR适合弯曲不平的平台和大平台。
5、自动调平失败如何处理？
自动调平失败的原因有很多，我们为此做了一个视频，详情见链接：
https://www.bilibili.com/video/BV1ZB4y1P7LZ?from=search&seid=12028097711066543268
6、屏上出现TMC 报错如何让处理？
答：屏上出现TMC驱动报错是因为主板固件使能了TMC 驱动uart模式，而主板与驱动之间通讯失败。
1、确认主板是否用了TMC驱动（TMC2208、2209、2225、2226），如果没有使用，则需要在配置文件屏蔽TMC驱动
2、使用了TMC驱动，固件配置又是正确的，需要确认硬件是否已设置为uart 模式，就是驱动下方的跳线是否正确，详见3.4
3、如果以上配置都正确，则有可能是存在驱动有问题，可以用上位机发送指令M122查看，显示ok的通讯成功，allow的通讯失败。
