Deploying to gh-pages from @ Klipper3d/klipper@24a1b50e51 🚀

This commit is contained in:
KevinOConnor 2022-07-11 00:03:59 +00:00
parent d1aa82bb16
commit 47a153e677
16 changed files with 229 additions and 229 deletions

View file

@ -1326,7 +1326,7 @@
<p>大多数的 Klipper 设置是由保存在树莓派上的"打印机配置文件"决定的。通常可以在Klipper <a href="https://github.com/Klipper3d/klipper/blob/master/config/">配置文件夹</a>中找到一个以"printer-"前缀开头并与目标打印机相对应的配置文件。Klipper 配置文件包含安装过程中需要的打印机技术信息。</p>
<p>如果 Klipper 配置目录中没有合适的打印机配置文件,请尝试搜索打印机制造商的网站,看看他们是否有合适的 Klipper 配置文件。</p>
<p>如果找不到打印机的配置文件但可以找到打印机控制板的类型则可以查找以“generic-”前缀开头的适当 <a href="https://github.com/Klipper3d/klipper/blob/master/config/">配置文件</a>。这些示例打印机模板文件应该足以成功完成初始安装,但需要进行一些自定义才能获得完整的打印机功能。</p>
<p>It is also possible to define a new printer configuration from scratch. However, this requires significant technical knowledge about the printer and its electronics. It is recommended that most users start with an appropriate configuration file. If creating a new custom printer configuration file, then start with the closest example <a href="https://github.com/Klipper3d/klipper/blob/master/config/">config file</a> and use the Klipper <a href="Config_Reference.html">config reference</a> for further information.</p>
<p>也可以从头开始定义一个新的打印机配置。然而,这需要关于打印机及其电子系统的大量技术知识。建议大多数用户从一个适当的配置文件开始。如果需要创建一个新的自定义打印机配置文件,那么可以先从最接近的<a href="./config/">配置文件</a>的例子开始,并从 Klipper <a href="Config_Reference.html">配置参考文档</a>了解进一步信息。</p>
<h2 id="_2">准备操作系统镜像<a class="headerlink" href="#_2" title="Permanent link">&para;</a></h2>
<p>先在树莓派上安装 <a href="https://github.com/guysoft/OctoPi">OctoPi</a>。请使用OctoPi v0.17.0或更高版本,查看 <a href="https://github.com/guysoft/OctoPi/releases">Octopi 发行版</a>来获取最新发布版本。安装完系统后,请先验证 OctoPi 能正常启动,并且 OctoPrint 网络服务器正常运行。连接到 OctoPrint 网页后,按照提示将 OctoPrint 更新到v1.4.2或更高版本。</p>
<p>在安装 OctoPi 和升级 OctoPrint 后,用 ssh 连接目标设备以运行少量的系统命令。如果使用Linux或MacOS系统那么 "ssh"软件应该已经预装在系统上。有一些免费的ssh客户端可用于其他操作系统例如<a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/">PuTTY</a>。使用ssh工具连接到Raspberry Pissh pi@octopi --密码是 "raspberry"),并运行以下命令:</p>
@ -1341,12 +1341,12 @@
make menuconfig
</code></pre></div>
<p>The comments at the top of the <a href="#obtain-a-klipper-configuration-file">printer configuration file</a> should describe the settings that need to be set during "make menuconfig". Open the file in a web browser or text editor and look for these instructions near the top of the file. Once the appropriate "menuconfig" settings have been configured, press "Q" to exit, and then "Y" to save. Then run:</p>
<p><a href="#obtain-a-klipper-configuration-file">打印机配置文件</a>的顶部注释应该描述了"make menuconfig"期间需要设置的设置。在网络浏览器或文本编辑器中打开该文件,在文件顶部附近寻找这些说明。一旦适当的"menuconfig"设置被配置好了,按"Q"退出,然后按"Y"保存,运行:</p>
<div class="highlight"><pre><span></span><code>make
</code></pre></div>
<p>If the comments at the top of the <a href="#obtain-a-klipper-configuration-file">printer configuration file</a> describe custom steps for "flashing" the final image to the printer control board then follow those steps and then proceed to <a href="#configuring-octoprint-to-use-klipper">configuring OctoPrint</a>.</p>
<p>Otherwise, the following steps are often used to "flash" the printer control board. First, it is necessary to determine the serial port connected to the micro-controller. Run the following:</p>
<p>如果<a href="#obtain-a-klipper-configuration-file">打印机配置文件</a>顶部的注释描述了"flashing"最终固件镜像到打印机控制板的特殊步骤,那么请遵循这些步骤,然后继续进行<a href="#configuring-octoprint-to-use-klipper">配置OctoPrint</a></p>
<p>否则,通常采用以下步骤来"flash"打印机控制板。首先,需要确定连接到微控制器的串行端口。然后,运行以下程序:</p>
<div class="highlight"><pre><span></span><code>ls /dev/serial/by-id/*
</code></pre></div>
@ -1371,14 +1371,14 @@ sudo service klipper start
<p>在主页上,在 "连接 "部分(在页面的左上方),确保 "串行端口 "被设置为"/tmp/printer",然后点击 "连接"。(如果"/tmp/printer "不是一个可用的选择,那么试着重新加载页面)</p>
<p>连接后,导航到 "终端 "选项卡,在命令输入框中输入 "status"(不带引号),然后点击 "发送"。终端窗口可能会报告在打开配置文件时出现了错误--这意味着 OctoPrint 与 Klipper 成功地进行了通信。继续下一部分。</p>
<h2 id="klipper_1">配置 Klipper<a class="headerlink" href="#klipper_1" title="Permanent link">&para;</a></h2>
<p>The next step is to copy the <a href="#obtain-a-klipper-configuration-file">printer configuration file</a> to the Raspberry Pi.</p>
<p>Arguably the easiest way to set the Klipper configuration file is to use a desktop editor that supports editing files over the "scp" and/or "sftp" protocols. There are freely available tools that support this (eg, Notepad++, WinSCP, and Cyberduck). Load the printer config file in the editor and then save it as a file named "printer.cfg" in the home directory of the pi user (ie, /home/pi/printer.cfg).</p>
<p>Alternatively, one can also copy and edit the file directly on the Raspberry Pi via ssh. That may look something like the following (be sure to update the command to use the appropriate printer config filename):</p>
<p>下一步是将<a href="#obtain-a-klipper-configuration-file">打印机配置文件</a>复制到Raspberry Pi。</p>
<p>编写 Klipper 配置文件的最简单方法是使用支持通过“scp”和/或“sftp”协议编辑文件的桌面编辑器。一些免费提供的工具支持这一点例如Notepad ++WinSCP和Cyberduck。在编辑器中加载打印机配置文件然后将其另存为 pi 用户主目录中名为“printer.cfg”的文件即 /home/pi/printer.cfg</p>
<p>另外,也可以通过 ssh 在树莓派上直接复制和编辑该文件。这可能看起来像下面这样(请确保更新命令以使用适当的打印机配置文件):</p>
<div class="highlight"><pre><span></span><code>cp ~/klipper/config/example-cartesian.cfg ~/printer.cfg
nano ~/printer.cfg
</code></pre></div>
<p>It's common for each printer to have its own unique name for the micro-controller. The name may change after flashing Klipper, so rerun these steps again even if they were already done when flashing. Run:</p>
<p>通常每台打印机都有自己独特的微控制器名称。刷写Klipper后名称可能会改变所以即使在闪存时已经完成也要重新运行这些步骤。运行</p>
<div class="highlight"><pre><span></span><code>ls /dev/serial/by-id/*
</code></pre></div>
@ -1386,15 +1386,15 @@ nano ~/printer.cfg
<div class="highlight"><pre><span></span><code>/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0
</code></pre></div>
<p>Then update the config file with the unique name. For example, update the <code>[mcu]</code> section to look something similar to:</p>
<p>然后用这个唯一的名字更新配置文件。例如,更新<code>[mcu]</code>部分,类似于:</p>
<div class="highlight"><pre><span></span><code>[mcu]
serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0
</code></pre></div>
<p>After creating and editing the file it will be necessary to issue a "restart" command in the OctoPrint web terminal to load the config. A "status" command will report the printer is ready if the Klipper config file is successfully read and the micro-controller is successfully found and configured.</p>
<p>When customizing the printer config file, it is not uncommon for Klipper to report a configuration error. If an error occurs, make any necessary corrections to the printer config file and issue "restart" until "status" reports the printer is ready.</p>
<p>在创建和编辑该文件后必须在OctoPrint网络终端发出"restart"命令以加载配置。如果Klipper配置文件被成功读取并且成功找到并配置了微控制器那么"status"命令将报告打印机已准备就绪。</p>
<p>在定制打印机配置文件时Klipper 报告配置错误是很正常的情况。如果发生错误,请对打印机配置文件进行必要的修正,并发出"restart",直到"status"报告打印机已准备就绪。</p>
<p>Klipper通过OctoPrint终端标签报告错误信息。可以使用 "status "命令来重新报告错误信息。默认的Klipper启动脚本也在<strong>/tmp/klippy.log</strong>中放置一个日志,提供更详细的信息。</p>
<p>After Klipper reports that the printer is ready, proceed to the <a href="Config_checks.html">config check document</a> to perform some basic checks on the definitions in the config file. See the main <a href="Overview.html">documentation reference</a> for other information.</p>
<p>在Klipper报告打印机已就绪后继续进入<a href="Config_checks.html">配置检查文件</a>,对配置文件中的定义进行一些基本检查。其他信息见主<a href="Overview.html">文档参考</a></p>
</article>