Ansible scripts to setup a Raspberry Pi for boat use, providing access to various data sources on board both via wired and wireless connections. Features include:

• Signal K node server with NMEA0183 and NMEA 2000 support
• wifi hotspot
• (marina) wifi access with routing
• 3/4G Internet connectivity with Huawei e3372
• VPN access
• various dynamic dns providers (inadyn, Route 53)
• read-only root partition

1. Install Ansible on your local computer
2. Initialize a memory card with the latest Raspbian Jessie Lite

• diskutil list
• diskutil unmountDisk /dev/<disk#>
• sudo dd bs=1m if=<your image file>.img of=/dev/<disk#>

1. Enable ssh for Raspbian headless operation

• touch /Volumes/boot/ssh

1. Connect the to-be-provisioned Raspberry Pi to the local network.
2. Run either ./firstrun.sh (uses hostname raspberrypi.local) or ./firstrun.sh <ip-of-your-raspi> (find out the IP address) to copy over your ssh key & do the initial setup (change password for user pi, copy the ssh key, expand the filesystem)
3. When it asks you for SSH password type in raspberry (default password for pi user) and hit return.
4. When asked for a new password what you enter will be the new password for the pi user on the device.
5. Edit configuration in example-boat.yml to match your environment and fill in your hotspot details
6. Run ./provision.sh <ip-of-your-raspi> example-boat.yml to provision the software & configurations for the roles in example-boat.yml.

You define what features you want to provision by adding roles to your playbook.

Installs the Signal K Node server under /opt/signalk. Uses node and node-app roles to install Node.js and run under systemd.

Installs and configures the software needed for the Pi to act as a wifi hotspot. Override variables:

hotspot_ssid: MarinePi
hotspot_channel: 11
hotspot_passphrase: NavigareNecesseEst
hotspot_interface: wlan0

Installs canboat utilities to interface with the NMEA 2000 network.

Installs a cron script that periodically checks your external IP address and updates Amazon's Route 53 name server information to act as dynamic DNS setup. Installs Amazon's command line tools as a dependency.

For minimal priviledges you should create a limited AWS identity for use with this profile and attach the policy AmazonRoute53FullAccess. In your own playbook define variables

aws_access_key_id: 'YOUR_ACCESS_KEY_ID'
aws_secret_access_key: 'YOUR_SECRET_ACCESS_KEY'

with the information for this limited identity.

Installs and configures the software the Pi needs to act as a wifi client. Override variables:

wificlient_interface: wlan1
wificlient_networks:
  - ssid: defaultssid
    psk: defaultpassphrase
    priority: 1
    scan_ssid: 0

You can add multiple networks by repeating the last four lines, if needed.

Installs the pysk console client on the Pi. See: https://github.com/ph1l/pysk

Installs grafana. Override variables:

grafana_admin_password: admin
grafana_secret: SW2YcwTIb9zpOOhoPsMm
grafana_port: 3000

Fork of original project with the intention of continuing work in this repo.