From bc3a748140b391bec562d73c0d518dcf60840859 Mon Sep 17 00:00:00 2001
From: Dmitry Kovalev <dkovalev@google.com>
Date: Mon, 11 Nov 2019 17:51:51 -0800
Subject: [PATCH] Update hacking instructions

Change-Id: I381c3f2f7cdf5753a5fe496f9c896f09877da18a
---
 HACKING.md | 50 +++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 47 insertions(+), 3 deletions(-)

diff --git a/HACKING.md b/HACKING.md
index 38e1dfff..27de5981 100644
--- a/HACKING.md
+++ b/HACKING.md
@@ -32,13 +32,13 @@ Before you start, be sure you have the latest version of [Raspbian][raspbian].
 Add AIY package repo:
 
 ```bash
-echo "deb https://packages.cloud.google.com/apt aiyprojects-stable main" | tee /etc/apt/sources.list.d/aiyprojects.list
+echo "deb https://packages.cloud.google.com/apt aiyprojects-stable main" | sudo tee /etc/apt/sources.list.d/aiyprojects.list
 ```
 
 Add Google package keys:
 
 ```bash
-curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key add -
+curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
 ```
 
 Update and install the latest system updates (including kernel):
@@ -56,6 +56,8 @@ sudo reboot
 
 ### 2. Install optional packages
 
+#### RGB Button Driver
+
 This package is needed only if you're using the light-up RGB button that's included with
 the Vision/Voice Bonnet:
 
@@ -63,12 +65,26 @@ the Vision/Voice Bonnet:
 sudo apt-get install -y leds-ktd202x-dkms
 ```
 
+Run `sudo modprobe leds_ktd202x` to load the driver and `sudo modprobe -r leds_ktd202x` to
+unload it. Vision/Voice Bonnet does this automatically via built-in device tree overlay
+saved in the board's EEPROM.
+
+#### Piezo Buzzer Driver
+
 This package is needed only if you're using the piezo buzzer included with the Vision Bonnet:
 
 ```bash
 sudo apt-get install -y pwm-soft-dkms
 ```
 
+#### Pi Zero Ethernet-over-USB
+
+This package is needed only if you're using Ethernet-over-USB on Pi Zero:
+```bash
+sudo apt-get install -y aiy-usb-gadget
+```
+Default Pi IP address is `192.168.11.2`, host IP address will be assigned automatically.
+
 ### 3. Install required packages
 
 Use the following commands to install packages for either the
@@ -95,6 +111,16 @@ Install the optimized `protobuf` library for better performance:
 sudo apt-get install -y aiy-python-wheels
 ```
 
+Enable camera module:
+```bash
+echo "start_x=1" | sudo tee -a /boot/config.txt
+```
+
+Set GPU memory to 128MB:
+```bash
+echo "gpu_mem=128" | sudo tee -a /boot/config.txt
+```
+
 Reboot:
 
 ```bash
@@ -107,6 +133,17 @@ Then verify that `dmesg` output contains `Myriad ready` message:
 dmesg | grep -i "Myriad ready"
 ```
 
+You can also verify that camera is working fine by watching video on the
+connected monitor:
+```bash
+raspivid -t 0
+```
+
+Or use `ffplay` to get video output on the host machine:
+```bash
+ssh pi@raspberrypi.local "raspivid --nopreview --timeout 0 -o -" | ffplay -loglevel panic -
+```
+
 #### Install Voice Bonnet/HAT packages
 
 Install the bonnet/HAT drivers:
@@ -115,6 +152,12 @@ Install the bonnet/HAT drivers:
 sudo apt-get install -y aiy-voicebonnet-soundcard-dkms
 ```
 
+Disable built-in audio:
+
+```bash
+sudo sed -i -e "s/^dtparam=audio=on/#\0/" /boot/config.txt
+```
+
 Install PulseAudio:
 
 ```bash
@@ -123,7 +166,8 @@ sudo mkdir -p /etc/pulse/daemon.conf.d/
 echo "default-sample-rate = 48000" | sudo tee /etc/pulse/daemon.conf.d/aiy.conf
 ```
 
-Install the Raspberry-Pi-compatible `google-assistant-library`:
+If you want to use Google Assistant, install the Raspberry-Pi-compatible
+`google-assistant-library` python library:
 
 ```bash
 sudo apt-get install -y aiy-python-wheels