README.md

Getting started with Hologram.io Nova on PocketBeagle

/etc/dogtag: BeagleBoard.org Debian Image 2017-08-31

Reference links

• https://beagleboard.org/latest-images
• https://hologram.io/docs/guide/connect/usb-modem/
• https://hologram.io/docs/guide/cloud/spacebridge-tunnel/
• https://wiki.archlinux.org/index.php/Ppp
• https://git.archlinux.org/svntogit/packages.git/tree/trunk/ppp.systemd?h=packages/ppp

Test the modem shows up in the Cloud9 IDE terminal

debian@pocketbeagle:/var/lib/cloud9$ sudo tio /dev/ttyACM0
[tio 01:43:11] tio v1.20
[tio 01:43:11] Press ctrl-t q to quit
[tio 01:43:11] Connected
AT
OK

Download files from each of these locations

• https://packages.debian.org/stretch/armhf/libpcap0.8/download
• https://packages.debian.org/stretch/armhf/ppp/download
• https://packages.debian.org/stretch/armhf/unzip/download
• https://github.com/hologram-io/hologram-tools/archive/master.zip

Upload them using the Cloud9 IDE file upload feature

Execute the following in the Cloud9 IDE terminal

sudo dpkg -i libpcap0.8_1.8.1-3_armhf.deb
sudo dpkg -i ppp_2.4.7-1+4_armhf.deb
sudo dpkg -i unzip_6.0-21_armhf.deb
unzip hologram-tools-master.zip
cd hologram-tools-master
sudo cp ppp/chatscripts/* /etc/chatscripts/
sudo cp ppp/peers/* /etc/ppp/peers/
sudo sed -e "s/USB0/ACM0/" -i /etc/ppp/peers/e303
sudo sh -c "cat <<EOF >/etc/udev/rules.d/72-hologram-nova.rules
SUBSYSTEM=="usb", ATTRS{idProduct}=="1102", ATTRS{idVendor}=="1546", TAG+="systemd"
EOF"
sudo sh -c "cat <<EOF >/lib/systemd/system/ppp@.service
[Unit]
Description=PPP link to %I
Before=network.target
Wants=dev-ttyACM0.device
After=dev-ttyACM0.device

[Service]
ExecStart=/usr/sbin/pppd call %I nodetach nolog

[Install]
WantedBy=multi-user.target
EOF"
sudo systemctl enable ppp@e303.service
sudo systemctl start ppp@e303.service

Setup SpaceBridge and connect via ssh (on remote computer)

Download SpaceBridge from https://hologram.io/docs/downloads/#spacebridge-client

spacebridge --upload-publickey ~/.hologram/spacebridge.key.pub  --apikey XXXX --text-mode --forward YYYY:22:5000
ssh -p 5000 -i ~/.hologram/spacebridge.key debian@127.0.0.1

Optional manual install of Python packages

• https://pypi.python.org/pypi/hjson/2.0.2
• https://pypi.python.org/pypi/py/1.4.29
• https://pypi.python.org/pypi/pytest/3.0.5
• https://pypi.python.org/pypi/python-wifi/0.6.1
• https://pypi.python.org/pypi/pyserial/3.3
• https://pypi.python.org/pypi/python-pppd/1.0.3
• https://pypi.python.org/pypi/pycrypto/2.6.1
• https://pypi.python.org/pypi/python-sdk-auth/0.1.8
• https://pypi.python.org/pypi/six/1.11.0
• https://pypi.python.org/pypi/pyudev/0.21.0
• https://pypi.python.org/pypi/pyusb/1.0.0
• https://pypi.python.org/pypi/psutil/5.3.1
• https://pypi.python.org/pypi/chardet/3.0.4
• https://pypi.python.org/pypi/idna/2.5
• https://pypi.python.org/pypi/urllib3/1.22
• https://pypi.python.org/pypi/certifi/2017.7.27.1
• https://pypi.python.org/pypi/requests/2.18.3
• https://pypi.python.org/pypi/hologram-python/0.6.1

sudo pip install hjson-2.0.2.tar.gz
sudo pip install py-1.4.29.tar.gz
sudo pip install pytest-3.0.5.tar.gz
sudo pip install python-wifi-0.6.1.tar.bz2
sudo pip install pyserial-3.3.tar.gz
sudo pip install python-pppd-1.0.3.tar.gz
sudo pip install pycrypto-2.6.1.tar.gz
sudo pip install python_sdk_auth-0.1.8-py2-none-any.whl
sudo pip install six-1.11.0.tar.gz
sudo pip install pyudev-0.21.0.tar.gz
sudo pip install PyUSB-1.0.0.tar.gz
sudo pip install psutil-5.3.1.tar.gz
sudo pip install chardet-3.0.4.tar.gz
sudo pip install idna-2.5.tar.gz
sudo pip install urllib3-1.22.tar.gz
sudo pip install certifi-2017.7.27.1.tar.gz
sudo pip install requests-2.18.3.tar.gz
sudo pip install hologram-python-0.6.1.tar.gz