diff --git a/docs/build.md b/docs/build.md index 851d33b..7769c53 100644 --- a/docs/build.md +++ b/docs/build.md @@ -97,9 +97,36 @@ the `raspi-config` program. It requires superuser privileges. ``` sudo raspi-config ``` +![1](imgs/raspi-config/1.png) -_TODO: add images and setup walkthrough - Wi-Fi country, Partition expand, SMBus -enable, etc._ +Configure the network hostname to something specific. If setting up multiple +TeraHz machines, make their hostnames unique so you can tell them apart. + +![](imgs/raspi-config/3.png) +![](imgs/raspi-config/4.png) + +Enable SSH and I2C interfaces. +![](imgs/raspi-config/15.png) +![](imgs/raspi-config/5.png) +![](imgs/raspi-config/6.png) +![](imgs/raspi-config/7.png) +![](imgs/raspi-config/19.png) + +Expand the root filesystem along the entire SD card. + +![](imgs/raspi-config/17.png) +![](imgs/raspi-config/8.png) +![](imgs/raspi-config/9.png) + +Set the Wi-Fi country to the country you'll be using TeraHz in. + +![](imgs/raspi-config/10.png) +![](imgs/raspi-config/11.png) +![](imgs/raspi-config/12.png) +![](imgs/raspi-config/13.png) +![](imgs/raspi-config/14.png) + +Save and reboot to enable Wi-Fi ## Installing packages In addition to what's already installed, TeraHz requires the following daemons @@ -114,6 +141,25 @@ They are available from the Raspbian repository. Install it via `apt`. apt install hostapd dnsmasq hostapd ``` +## Configuring daemons +By default, the daemons we installed are disabled and start only manually. To +change that, enable them through systemctl. Hostapd conflicts with +wpa_supplicant, the solution is to disable wpa_supplicant (this will break your +wireless connections, so use wired ethernet). + +``` +sudo systemctl unmask hostapd +sudo systemctl stop wpa_supplicant +sudo systemctl disable wpa_supplicant +sudo systemctl enable dnsmasq hostapd lighttpd +``` + ## Copying configuration files To simplify the process of configuring Raspbian to run TeraHz, sample -configuration file are provided +configuration file are provided in the `etcs` subdirectory of the Git +repository. + +These files have been verified to work, but it's not a brilliant idea to just +copy them into your `/etc` directory. Use them carefully and more as a template +for your own configuration rather than as a _de facto_ way of configuring +TeraHz. diff --git a/docs/imgs/raspi-config/1.png b/docs/imgs/raspi-config/1.png new file mode 100644 index 0000000..70e0d4c Binary files /dev/null and b/docs/imgs/raspi-config/1.png differ diff --git a/docs/imgs/raspi-config/10.png b/docs/imgs/raspi-config/10.png new file mode 100644 index 0000000..565ca86 Binary files /dev/null and b/docs/imgs/raspi-config/10.png differ diff --git a/docs/imgs/raspi-config/11.png b/docs/imgs/raspi-config/11.png new file mode 100644 index 0000000..0af2616 Binary files /dev/null and b/docs/imgs/raspi-config/11.png differ diff --git a/docs/imgs/raspi-config/12.png b/docs/imgs/raspi-config/12.png new file mode 100644 index 0000000..0f8a3ad Binary files /dev/null and b/docs/imgs/raspi-config/12.png differ diff --git a/docs/imgs/raspi-config/14.png b/docs/imgs/raspi-config/14.png new file mode 100644 index 0000000..a2f0505 Binary files /dev/null and b/docs/imgs/raspi-config/14.png differ diff --git a/docs/imgs/raspi-config/15.png b/docs/imgs/raspi-config/15.png new file mode 100644 index 0000000..d4fd3b2 Binary files /dev/null and b/docs/imgs/raspi-config/15.png differ diff --git a/docs/imgs/raspi-config/16.png b/docs/imgs/raspi-config/16.png new file mode 100644 index 0000000..d4fd3b2 Binary files /dev/null and b/docs/imgs/raspi-config/16.png differ diff --git a/docs/imgs/raspi-config/17.png b/docs/imgs/raspi-config/17.png new file mode 100644 index 0000000..99c4e94 Binary files /dev/null and b/docs/imgs/raspi-config/17.png differ diff --git a/docs/imgs/raspi-config/18.png b/docs/imgs/raspi-config/18.png new file mode 100644 index 0000000..a14bcc8 Binary files /dev/null and b/docs/imgs/raspi-config/18.png differ diff --git a/docs/imgs/raspi-config/19.png b/docs/imgs/raspi-config/19.png new file mode 100644 index 0000000..93065d4 Binary files /dev/null and b/docs/imgs/raspi-config/19.png differ diff --git a/docs/imgs/raspi-config/2.png b/docs/imgs/raspi-config/2.png new file mode 100644 index 0000000..1da167f Binary files /dev/null and b/docs/imgs/raspi-config/2.png differ diff --git a/docs/imgs/raspi-config/3.png b/docs/imgs/raspi-config/3.png new file mode 100644 index 0000000..75d4876 Binary files /dev/null and b/docs/imgs/raspi-config/3.png differ diff --git a/docs/imgs/raspi-config/4.png b/docs/imgs/raspi-config/4.png new file mode 100644 index 0000000..00bcfb1 Binary files /dev/null and b/docs/imgs/raspi-config/4.png differ diff --git a/docs/imgs/raspi-config/5.png b/docs/imgs/raspi-config/5.png new file mode 100644 index 0000000..74d255a Binary files /dev/null and b/docs/imgs/raspi-config/5.png differ diff --git a/docs/imgs/raspi-config/6.png b/docs/imgs/raspi-config/6.png new file mode 100644 index 0000000..60571de Binary files /dev/null and b/docs/imgs/raspi-config/6.png differ diff --git a/docs/imgs/raspi-config/7.png b/docs/imgs/raspi-config/7.png new file mode 100644 index 0000000..c7f5b6f Binary files /dev/null and b/docs/imgs/raspi-config/7.png differ diff --git a/docs/imgs/raspi-config/8.png b/docs/imgs/raspi-config/8.png new file mode 100644 index 0000000..1647cb9 Binary files /dev/null and b/docs/imgs/raspi-config/8.png differ diff --git a/docs/imgs/raspi-config/9.png b/docs/imgs/raspi-config/9.png new file mode 100644 index 0000000..5ad2ae1 Binary files /dev/null and b/docs/imgs/raspi-config/9.png differ