Deploying to gh-pages from @ Klipper3d/klipper@383b83d788 🚀

This commit is contained in:
KevinOConnor
2024-12-17 00:05:20 +00:00
parent 3e7a2cc3cd
commit b4c563aa19
27 changed files with 422 additions and 422 deletions

View File

@@ -1217,15 +1217,15 @@
</li>
<li class="md-nav__item">
<a href="#installing-octoprint" class="md-nav__link">
Installing Octoprint
<a href="#octoprint" class="md-nav__link">
安装 Octoprint
</a>
</li>
<li class="md-nav__item">
<a href="#building-the-beaglebone-pru-micro-controller-code-pru-firmware" class="md-nav__link">
Building the BeagleBone PRU micro-controller code (PRU firmware)
<a href="#beaglebone-pru-pru" class="md-nav__link">
构建 BeagleBone PRU 微控制器代码PRU 固件)
</a>
</li>
@@ -1448,15 +1448,15 @@
</li>
<li class="md-nav__item">
<a href="#installing-octoprint" class="md-nav__link">
Installing Octoprint
<a href="#octoprint" class="md-nav__link">
安装 Octoprint
</a>
</li>
<li class="md-nav__item">
<a href="#building-the-beaglebone-pru-micro-controller-code-pru-firmware" class="md-nav__link">
Building the BeagleBone PRU micro-controller code (PRU firmware)
<a href="#beaglebone-pru-pru" class="md-nav__link">
构建 BeagleBone PRU 微控制器代码PRU 固件)
</a>
</li>
@@ -1537,36 +1537,36 @@
<h1 id="beaglebone">Beaglebone<a class="headerlink" href="#beaglebone" title="Permanent link">&para;</a></h1>
<p>本文档描述了在 Beaglebone 可编程实时单元上运行 Klipper 的过程。</p>
<h2 id="_1">构建一个操作系统镜像<a class="headerlink" href="#_1" title="Permanent link">&para;</a></h2>
<p>Start by installing the <a href="https://beagleboard.org/latest-images">Debian 11.7 2023-09-02 4GB microSD IoT</a> image. One may run the image from either a micro-SD card or from builtin eMMC. If using the eMMC, install it to eMMC now by following the instructions from the above link.</p>
<p>Then ssh into the Beaglebone machine (<code>ssh debian@beaglebone</code> -- password is <code>temppwd</code>).</p>
<p>Before start installing Klipper you need to free-up additional space. there are 3 options to do that:</p>
<p>首先安装 [Debian 11.7 2023-09-02 4GB microSD IoT]<a href="https://beagleboard.org/latest-images">https://beagleboard.org/latest-images</a> 镜像。可以从 micro-SD 卡或内置 eMMC 运行映像。如果使用 eMMC请按照上述链接中的说明立即将其安装到 eMMC。</p>
<p>然后 ssh 进入 Beaglebone 机器(<code>ssh debian@beaglebone</code> -- password is <code>temppwd</code>).</p>
<p>开始之前安装Klipper你需要腾出额外空间。 有3个选项中做到这一点</p>
<ol>
<li>remove some BeagleBone "Demo" resources</li>
<li>if you did boot from SD-Card, and it's bigger than 4Gb - you can expand current filesystem to take whole card space</li>
<li>do option #1 and #2 together.</li>
<li>删除一些 BeagleBoneDemo”资源</li>
<li>如果你确实从 SD 卡启动,并且它大于 4Gb - 你可以扩展当前文件系统以占用整个卡空间</li>
<li>同时执行选项 #1 和 #2。</li>
</ol>
<p>To remove some BeagleBone "Demo" resources execute these commands</p>
<p>要删除一些 BeagleBoneDemo”资源,请执行以下命令</p>
<div class="highlight"><pre><span></span><code>sudo apt remove bb-node-red-installer
sudo apt remove bb-code-server
</code></pre></div>
<p>To expand filesystem to full size of your SD-Card execute this command, reboot is not required.</p>
<p>要将文件系统扩展至 SD 卡的全部大小,请执行此命令,无需重新启动。</p>
<div class="highlight"><pre><span></span><code>sudo growpart /dev/mmcblk0 1
sudo resize2fs /dev/mmcblk0p1
</code></pre></div>
<p>Install Klipper by running the following commands:</p>
<p>通过运行以下命令安装 Klipper</p>
<div class="highlight"><pre><span></span><code>git clone https://github.com/Klipper3d/klipper.git
./klipper/scripts/install-beaglebone.sh
</code></pre></div>
<p>After installing Klipper you need to decide what kind of deployment do you need, but take a note that BeagleBone is 3.3v based hardware and in most cases you can't directly connect pins to 5v or 12v based hardware without conversion boards.</p>
<p>As Klipper have multimodule architecture on BeagleBone you can achieve many different use cases, but general ones are following:</p>
<p>Use case 1: Use BeagleBone only as a host system to run Klipper and additional software like OctoPrint/Fluidd + Moonraker/... and this configuration will be driving external micro-controllers via serial/usb/canbus connections.</p>
<p>Use case 2: Use BeagleBone with extension board (cape) like CRAMPS board. in this configuration BeagleBone will host Klipper + additional software, and it will drive extension board with BeagleBone PRU cores (2 additional cores 200Mh, 32Bit).</p>
<p>Use case 3: It's same as "Use case 1" but additionally you want to drive BeagleBone GPIOs with high speed by utilizing PRU cores to offload main CPU.</p>
<h2 id="installing-octoprint">Installing Octoprint<a class="headerlink" href="#installing-octoprint" title="Permanent link">&para;</a></h2>
<p>One may then install Octoprint or fully skip this section if desired other software:</p>
<p>安装 Klipper 后,您需要决定需要什么样的部署,但请注意,BeagleBone 是基于 3.3v 的硬件,在大多数情况下,如果没有转换板,您不能直接将引脚连接到基于 5v 12v 的硬件。</p>
<p>由于 Klipper 在 BeagleBone 上具有多模块架构,因此您可以实现许多不同的用例,但一般用例如下:</p>
<p>用例 1仅使用 BeagleBone 作为主机系统来运行 Klipper 和其他软件,如 OctoPrint/Fluidd + Moonraker/...,并且此配置将通过串行/usb/canbus 连接驱动外部微控制器。</p>
<p>用例 2将 BeagleBone 与 CRAMPS 板等扩展板cape一起使用。在此配置下BeagleBone 将托管 Klipper + 附加软件,并使用 BeagleBone PRU 内核2 个附加内核 200Mh32Bit)驱动扩展板。</p>
<p>用例 3它与“用例 1”相同但此外您还想利用 PRU 核心卸载主 CPU以高速驱动 BeagleBone GPIO。</p>
<h2 id="octoprint">安装 Octoprint<a class="headerlink" href="#octoprint" title="Permanent link">&para;</a></h2>
<p>然后可以安装 Octoprint或者如果需要其他软件可以完全跳过此部分</p>
<div class="highlight"><pre><span></span><code>git clone https://github.com/foosel/OctoPrint.git
cd OctoPrint/
virtualenv venv
@@ -1588,14 +1588,14 @@ sudo update-rc.d octoprint defaults
<div class="highlight"><pre><span></span><code>sudo systemctl start octoprint
</code></pre></div>
<p>Wait 1-2 minutes and make sure the OctoPrint web server is accessible - it should be at: <a href="http://beaglebone:5000/">http://beaglebone:5000/</a></p>
<h2 id="building-the-beaglebone-pru-micro-controller-code-pru-firmware">Building the BeagleBone PRU micro-controller code (PRU firmware)<a class="headerlink" href="#building-the-beaglebone-pru-micro-controller-code-pru-firmware" title="Permanent link">&para;</a></h2>
<p>This section is required for "Use case 2" and "Use case 3" mentioned above, you should skip it for "Use case 1".</p>
<p>Check that required devices are present</p>
<p>等待 1-2 分钟,确保 OctoPrint 网络服务器可访问 - 它应该位于:<a href="http://beaglebone:5000/">http://beaglebone:5000/</a></p>
<h2 id="beaglebone-pru-pru">构建 BeagleBone PRU 微控制器代码PRU 固件)<a class="headerlink" href="#beaglebone-pru-pru" title="Permanent link">&para;</a></h2>
<p>此部分对于上面提到的“用例 2”和“用例 3”是必需的对于“用例 1”则应跳过此部分。</p>
<p>检查是否存在所需设备</p>
<div class="highlight"><pre><span></span><code>sudo beagle-version
</code></pre></div>
<p>You should check that output contains successful "remoteproc" drivers loading and presence of PRU cores, in Kernel 5.10 they should be "remoteproc1" and "remoteproc2" (4a334000.pru, 4a338000.pru) Also check that many GPIOs are loaded they will look like "Allocated GPIO id=0 name='P8_03'" Usually everything is fine and no hardware configuration is required. If something is missing - try to play with "uboot overlays" options or with cape-overlays Just for reference some output of working BeagleBone Black configuration with CRAMPS board:</p>
<p>您应该检查输出是否包含成功的“remoteproc”驱动程序加载和 PRU 核心的存在,在内核 5.10 中,它们应该是“remoteproc1”和“remoteproc2”(4a334000.pru4a338000.pru)还应检查是否加载了许多 GPIO它们看起来像“分配的 GPIO id=0 name='P8_03'”通常一切都很好,不需要硬件配置。如果缺少某些东西 - 尝试使用“uboot overlays”选项或 cape-overlays 仅供参考,使用 CRAMPS 板工作的 BeagleBone Black 配置的一些输出:</p>
<div class="highlight"><pre><span></span><code>model:[TI_AM335x_BeagleBone_Black]
UBOOT: Booted Device-Tree:[am335x-boneblack-uboot-univ.dts]
UBOOT: Loaded Overlay:[BB-ADC-00A0.bb.org-overlays]