Configurations/config/examples/BIQU/Hurakan/README.md
2024-02-01 15:27:09 -06:00

127 lines
3.4 KiB
Markdown

# BIQU Hurakan Configuration
> [!NOTE]
> Early Hurakan printers have a raised bed power switch, so enable (uncomment) `#define PROBING_MARGIN_BACK` in `Configuration_adv.h` to prevent the hotend from potentially colliding with the switch assembly while probing.
>
> MicroProbe V2 is assumed.
The BIQU Hurakan ships with a BigTreeTech Manta M4P motherboard which includes an integrated BigTreeTech CB1 single board computer running Klipper. See below for instructions on how to update the CB1 to run OctoPrint.
# Table of Contents
- [Update Hurakan CB1 Image Defaults](#update-hurakan-cb1-image-defaults)
* [SSH into to the CB1](#ssh-into-to-the-cb1)
* [Update Timezone](#update-timezone)
* [Update NTP Server](#update-ntp-server)
+ [Reboot](#reboot)
* [SSH into to the CB1](#ssh-into-to-the-cb1-1)
* [Update APT](#update-apt)
- [Install OctoPrint via KIAUH](#install-octoprint-via-kiauh)
* [Update PIP](#update-pip)
+ [Reboot](#reboot-1)
* [Access OctoPrint via Web Browser](#access-octoprint-via-web-browser)
# Update Hurakan CB1 Image Defaults
> [!IMPORTANT]
> Start with the latest `CB1_Debian11_Klipper_kernel*.img.xz` (full) image from [bigtreetech/CB1/releases](https://github.com/bigtreetech/CB1/releases).
## SSH into to the CB1
```shell
ssh biqu@<ip address>
```
Password: `biqu`
## Update Timezone
> [!NOTE]
> See [Wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) or run `timedatectl list-timezones` for list of valid time zone names. `America/Los_Angeles` is used in the example below.
```shell
sudo timedatectl set-timezone America/Los_Angeles
```
## Update NTP Server
```shell
sudo nano /etc/scripts/init.sh
```
<img width="843" alt="image" src="https://user-images.githubusercontent.com/13375512/202753004-aebf01c5-4110-4598-9f28-fbaa82afc320.png">
Change:
`# sudo ntpdate stdtime.gov.hk`
To:
`# sudo ntpdate pool.ntp.org`
Press `CTRL`+`X` to exit
Press `Y` to save
### Reboot
```shell
sudo reboot
```
## SSH into to the CB1
```shell
ssh biqu@<ip address>
```
Password: `biqu`
## Update APT
```shell
sudo apt update
sudo apt upgrade
```
# Install OctoPrint via KIAUH
```shell
cd ~
git clone https://github.com/dw-0/kiauh.git
./kiauh/kiauh.sh
```
> [!NOTE]
> Klipper, Moonraker, Mainsail, and KlipperScreen come preinstalled on the Hurakan image.
Type 1 to install an app:
<img width="403" alt="image" src="https://user-images.githubusercontent.com/13375512/201934192-eb1ebdb4-bdcd-4b68-b5e7-2c794dc5966a.png">
Type 6 to install OctoPrint:
<img width="402" alt="image" src="https://user-images.githubusercontent.com/13375512/201934496-c55a04dc-37e9-4691-b29c-a4c60f9d669c.png">
## Update PIP
```shell
/home/biqu/.KlipperScreen-env/bin/python -m pip install --upgrade pip
```
### Reboot
```shell
sudo reboot
```
## Access OctoPrint via Web Browser
OctoPrint is now running at `<ip address>:5000`
After running the first time setup wizard, select `/dev/ttyACM0` as the serial port.
## Enable the `shutdown` Action Command in OctoPrint
To enable a graceful shutdown of OctoPrint from the LCD, open OctoPrint in your browser and go to Settings -> Serial Connection -> Firmware & protocol and scroll down to Action commands. Tick the "Enable the `shutdown` action command" box and reboot OctoPrint for the feature to be enabled.
<img width="691" alt="image" src="https://user-images.githubusercontent.com/13375512/205521020-1b1e64de-7326-4019-9bde-5ed05450e468.png">