2017-04-27 15:31:48 -04:00
|
|
|
Welcome to the Klipper documentation. There are two parts to Klipper -
|
|
|
|
|
code that runs on a micro-controller and code that runs on a "host"
|
|
|
|
|
machine. The host code is intended to run on a low-cost
|
|
|
|
|
general-purpose machine such as a Raspberry Pi, while the
|
|
|
|
|
micro-controller code is intended to run on commodity micro-controller
|
|
|
|
|
chips. Read [features](Features.md) for reasons to use Klipper. See
|
2017-12-26 20:16:53 -05:00
|
|
|
[installation](Installation.md) to get started with Klipper. See
|
|
|
|
|
[config checks](Config_checks.md) for a guide to verify basic pin
|
|
|
|
|
settings in the config file.
|
2017-04-19 15:24:57 -04:00
|
|
|
|
2017-04-27 15:31:48 -04:00
|
|
|
The Klipper configuration is stored in a simple text file on the host
|
|
|
|
|
machine. The [config/example.cfg](../config/example.cfg) file serves
|
2018-10-28 10:24:34 -04:00
|
|
|
as a reference for the config file. See the [Slicers](Slicers.md)
|
|
|
|
|
document for information on configuring a slicer with Klipper. See the
|
2018-10-11 00:52:09 -04:00
|
|
|
[Endstop Phase](Endstop_Phase.md) document for information on
|
|
|
|
|
Klipper's "stepper phase adjusted endstop" system. See the
|
2019-02-06 18:49:11 -05:00
|
|
|
[Bed Level](Bed_Level.md) document for information on bed leveling
|
|
|
|
|
with Klipper. See the [Probe Calibrate](Probe_Calibrate.md) document
|
|
|
|
|
for information on calibrating automatic Z probes. See the
|
2018-08-28 22:57:29 -04:00
|
|
|
[Delta Calibrate](Delta_Calibrate.md) document for information on
|
|
|
|
|
calibrating delta printers. The
|
2017-04-27 15:31:48 -04:00
|
|
|
[Pressure Advance](Pressure_Advance.md) document contains information
|
|
|
|
|
on tuning the pressure advance config.
|
2016-05-25 11:37:40 -04:00
|
|
|
|
2017-04-27 15:31:48 -04:00
|
|
|
The [kinematics](Kinematics.md) document provides some technical
|
2017-11-30 15:00:00 -05:00
|
|
|
details on how Klipper implements motion. The [FAQ](FAQ.md) answers
|
2018-03-08 14:06:24 -05:00
|
|
|
some common questions. The [G-Codes](G-Codes.md) document lists
|
|
|
|
|
currently supported run-time commands.
|
2017-04-27 15:31:48 -04:00
|
|
|
|
|
|
|
|
The history of Klipper releases is available at
|
2018-12-27 18:57:17 -05:00
|
|
|
[releases](Releases.md). The [config changes](Config_Changes.md)
|
|
|
|
|
document describes recent software changes that may require users to
|
|
|
|
|
update their printer config file. See [contact](Contact.md) for
|
|
|
|
|
information on bug reporting and general communication with the
|
|
|
|
|
developers.
|
2016-05-25 11:37:40 -04:00
|
|
|
|
2017-04-27 15:31:48 -04:00
|
|
|
Developer Documentation
|
|
|
|
|
=======================
|
|
|
|
|
|
|
|
|
|
There are also several documents available for developers interested
|
|
|
|
|
in understanding how Klipper works. Start with the
|
|
|
|
|
[code overview](Code_Overview.md) document - it provides information
|
2017-12-26 20:16:53 -05:00
|
|
|
on the structure and layout of the Klipper code. See the
|
|
|
|
|
[contributing](CONTRIBUTING.md) document to submit improvements to Klipper.
|
2016-12-23 18:28:09 -05:00
|
|
|
|
2017-04-27 15:31:48 -04:00
|
|
|
See [protocol](Protocol.md) for information on the low-level messaging
|
|
|
|
|
protocol between host and micro-controller. See also
|
2017-04-27 15:14:11 -04:00
|
|
|
[MCU commands](MCU_Commands.md) for a description of low-level
|
|
|
|
|
commands implemented in the micro-controller software.
|
2016-10-15 01:03:56 -04:00
|
|
|
|
2016-12-23 18:28:09 -05:00
|
|
|
See [debugging](Debugging.md) for information on how to test and debug
|
2018-09-20 20:11:04 -04:00
|
|
|
Klipper. See [stm32f1](stm32f1.md) for information on the STM32F1
|
|
|
|
|
micro-controller port. See [bootloaders](Bootloaders.md) for developer
|
|
|
|
|
information on micro-controller flashing.
|
