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.
2. Boot into configuration environment using external SD image
   1. Insert SD card for heirloom init
   2. Short across the P_EXT header
   3. Power on the system. It should boot to a login screen, and not a blue screen with a text menu on it
   4. Plug in a USB keyboard
   5. Type in 'root' and 'kosagi' to log in
3. Remove any former bluetooth config on the temporary boot environment
   1. Start a terminal window.
   2. type 'systemctl stop bluetooth'
   3. type 'rm -rf /var/lib/bluetooth'
4. Configure BT in the temporary boot environment with the new keyboard
   1. type 'systemctl start bluetooth'
   2. type 'bluetoothctl'. You will now be in the bluetooth shell.
      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)
      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'
5. You should now be back in the main terminal window environment.
6. Copy the BT configuration from the temporary boot environment onto the permanent SSD environment
   1. Mount the SSD with 'mount /dev/sdb3 /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'
   4. Unmount SSD with 'umount /mnt'
7. 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. This may require you to press and hold the power button for a few seconds
   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. 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.
8. Turn the system off. You are now done