Heirloom BT pairing setup

Procedure used to prime Novena Heirloom laptops

This is run on the Novena Heirloom laptops prior to shipping to pair the BT keyboard.

1. Extract the heirloom hardware kit, and assemble the hardware for booting.
   1. Pull out motherboard, long flex cable, PCIe card, hard drive. Return other items to box.
   2. Use ESD bag to line workspace.
   3. Attach PCIe card using a temporary screw.
   4. Label PCIe card with box number.
   5. Attach front panel board with matching numbered board
   6. Attach fan to front panel board
   7. Attach temporary speakers to front panel board
   8. Attach LCD panel adapter
   9. Label BT keyboard with corresponding box number
   10. Label hard drive with corresponding box number
   11. Attach hard drive
2. Boot into temporary environment using external SD image (to avoid spoiling the first boot experience primed on the SSD)
   1. Insert SD card for heirloom init
   2. Short across the P_EXT header
   3. Attach temporary battery board. This should power on the system.
   4. It should boot to a login screen, and not a blue screen with a text menu on it
   5. Plug in a USB keyboard to the front panel board
   6. Type in 'root' and 'kosagi' to log in
3. Configure BT in the temporary boot environment with the new keyboard
   1. Start a terminal window
   2. type 'bluetoothctl'. You will now be in the bluetooth shell. Here, you will pair and trust the keyboard.
      1. In the BT shell, type 'power on'
      2. In the BT shell, type 'agent KeyboardOnly'
      3. In the BT shell, type 'default-agent'
      4. In the BT shell, type 'pairable on'
      5. In the BT shell, type 'scan on'. At this point, flick the switch on the right hand side of the BT keyboard. You should see within a few seconds the keyboard show up, with an MAC ID starting with 90:...
      6. In the BT shell, type 'pair 90:' and hit tab. This should tab-complete the whole BT keyboard MAC ID.
      7. Follow the instructions (e.g. typing into BT keyboard the 6-digit PIN followed by enter key). If there is no prompt to pair using a PIN code, allow the pairing to abort, and try again. Do not proceed with next steps until you've been prompted to enter a PIN code.
      8. After typing in the PIN, the system should indicate the keyboard is paired.
      9. In the BT shell, type 'trust 90:' and hit tab.
      10. In the BT shell, type 'connect 90:' and hit tab.
      11. In the BT shell, type 'quit'
4. You should now be back in the main terminal window environment.
5. Copy the BT configuration from the temporary boot environment onto the permanent SSD environment
   1. Mount the SSD with 'mount /dev/sda3 /mnt'
   2. Install BT firmware with 'dpkg –root=/mnt -i Downloads/firmware-atheros_0.43_all.deb'
   3. Copy BT configuration with 'cp -a /var/lib/bluetooth /mnt/var/lib'
6. Update the firmware on the target
   1. Insert the USB drive with firmware update into the front panel board
   2. mount the USB drive to 'mount /dev/sdb1 /mnt2'
   3. go to the drive directory with 'cd /mnt2'
   4. run update using 'dpkg --root=/mnt -i *.deb'
   5. manually install /boot contents because you can't do that on a /mnt environment
      1. run 'mount /dev/sda1 /boot'
      2. cp novena.dtb /boot; cp zimage /boot
      3. umount /boot
   6. test audio by playing a song. 'mplayer -ao pulse::1 test.mp3'. You will need to unmute audio using alsamixer. Run 'alsamixer', select the imx audio device using F6, and unmute any channels that are muted.
   7. unmount USB drive wtih 'umount /mnt2'
7. Set the hardware EEPROM with heirloom flag
   1. use novena-eeprom to update the heirloom flag: 'novena-eeprom -f es8328,senoko,edp,pcie,gbit,hdmi,eepromoops,sataroot,heirloom -w'. A script called eeprom-cmd.sh was created for convenience.
   2. Unmount SSD with 'umount /mnt'
8. Test the suspend function
   1. Select suspend from the power menu
   2. Use the wake-up switch to power the system back on again. Verify the BT keyboard still talks to the system.
9. Remove bluetooth config on the temporary boot environment
   1. type 'systemctl stop bluetooth'
   2. type 'rm -rf /var/lib/bluetooth'
10. Test the configuration
    1. Shutdown the system with 'shutdown -h now'
    2. Power off the system, so that the orange light on the mainboard is off. Use the power button to do this, to confirm the power button is functional
    3. Remove the SD card from the external SD card slot
    4. Reboot the system. It should go to a blue screen with a text menu on it.
    5. Flick the right switch on the BT keyboard to re-initiate pairing.
    6. Hit the space bar on the bluetooth keyboard. It should automatically associate, and you can tell it's working by using the up/down arrow keys to navigate the menu.
11. Turn the system off. You are now done