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. 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 to the front panel board
   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. reboot the system using 'reboot'. If you aren't doing a cold boot, the system will automatically reboot from the SD heirloom init environment.
4. 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)
      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/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'
7. 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 -i *.deb'
   5. test audio by playing a song. 'mplayer *.mp3'. You will need to unmute audio using alsamixer to hear anything.
   6. unmount USB drive wtih 'umount /mnt2'
8. 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'
   2. Unmount SSD with 'umount /mnt'
9. 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.
10. Turn the system off. You are now done