General Notes on Setup

* Run off microSD instead of via embedded - boot time was about the same.

* The Core Chip = Octavo OSD3358-512M-BAS-XB which is based on the TI AM3358   which says "1-, 4- and 8-Bit MMC, SD, SDIO Modes" and that "Complies With MMC4.3, SD, SDIO 2.0 Specifications". Looking up the 2.0 SD Specs we see 4-bit mode corresponds to 100Mbit/sec (10MByte/sec) transfer rates which is SD-class 10 cards. Tested with a 32 GB SDHD card that was class = UHS1. (the 1 inside the U).  Worked just fine.

* Run "apt-get upgrade/update" on embedded OS anyway - best practices

* POW button kills power instantly.

* Supplied code from image is for BBBlack and won't work on BBBlue

Installation Procedure

1. Connect USB and wait for "Connected to WiredConnection X" (should be given IP=192.168.7.1)
2. SSH to debian@192.168.7.2
3. Connect to internet via wifi to update run:
   debian@beaglebone:~$ connmanctl
   when you get the "connmanctl>" prompt, execute the following commands
   
   connmanctl> enable wifi
   connmanctl> tether wifi disable
   connmanctl> scan wifi
   connmanctl> services
   
   Look for a list of names and to the right a machine name for each AP (you need the machine name) something like

   connmanctl> services    
                         wifi_#######_hidden_managed_psk
   5Gees6Ess             wifi_#######_managed_psk    
   GGGGGSSSSS            wifi_#######_managed_psk    
   NeighborsWifi         wifi_#######_managed_psk    
   FiveGeesSixEs         wifi_#######_managed_psk
   

   
   Note: hidden APs will show up as wifi_########_hidden_managed_psk.  You will be prompted for SSID and passwd if you select these.
   Enable and Connect
   
   connmanctl> agent on
   connmanctl> connect wifi_...._managed_psk
   
   
   Follow prompts. If all is well the Green WIFI LED will light up and stay lit. You will also see a message like this:
    

   	Connected wifi_######_managed_psk
   
   

   
   If this happens then quit from connmanctl.
   
   connmanctl> quit
4. Watch for a green LED marked WIFI to light up. 
   At this point you should have a working internet connection. Test with
   debian@beaglebone:~$ ifconfig wlan0
   debian@beaglebone:~$ ping <insert your favorite upstream site here>
    
5. Run updates and upgrades until all updates are completed (repeat as necessary):
   debian@beaglebone:~$ sudo apt update
   debian@beaglebone:~$ sudo apt upgrade
   debian@beaglebone:~$ sudo apt dist-upgrade
    
6. When you get no more updates to apply
   debian@beaglebone:~$ sudo shutdown -r now
    
7. Now that the onboard drive is updated to it's most recent version, it is time to download and flash a microSD card. Download most recent version of the blue-compatible OS from https://beagleboard.org/latest-images and check the sha256sum.
   (e.g. bone-debian-9.1-lxqt-armhf-2017-08-31-4gb.img.xz )
8. Uncompress the file
   user@localmachine:~$ xz -d bone-debian-9.1-lxqt-armhf-2017-08-31-4gb.img.xz
9. Flash the SD card
   user@localmachine:~$ dd if=bone-debian-9.1-lxqt-armhf-2017-08-31-4gb.img of=<be_careful_to_specify_the_correct_device> status=progress
10. If you've used a SD card larger than 4 GiB then format later partitions for disk storage as ext4
    gparted /dev/XXXX
    (don't format the bits at sectors lower than p0)
11. unmount the SD card from your machine and put it into the BBBlue. Reconnect USB for power and repeat steps 1-5 above
12. generate the ssh private/public key files for the BBBlue
    debian@beaglebone:~$ ssh-keygen
    
    This does more than is necessary but it creates the .ssh directory (which is required for keyaccess) and will be useful later for machine-to-machine communication
     
13. On your machine setup key access
    user@localmachine:~$ ssh-copy-id debian@192.168.7.2
    
    this assumes you have a private/public key pair already setup on your workstation. If not, run ssh-keygen.
     
14. On the BBBlue setup key authentication only for security purposes?
    debian@beaglebone:~$ sudo vi /etc/ssh/sshd_config
    
    and change PasswordAuthentication to no
     
15. Restart SSH and from a DIFFERENT terminal attempt to login
    debian@beaglebone:~$ sudo service ssh reload
    user@localmachine:~$  ssh debian@192.168.7.2
    user@localmachine:~$  ssh should_be_rejected@192.168.7.2
    
    Be careful with this one as you won't be able to login with username/passwords any more after this
     
16. Go to local web services (here you can use beaglebone.local or use the IP address of the BBBlue directly).
    
    http://beaglebone.local/bone101/
    
    http://beaglebone.local:3000/
    
    http://beaglebone.local:1880/