Skip to content

software

Jump to bottom
Lukas Sigrist edited this page Jun 25, 2018 · 50 revisions

Software Installation Guide

System Image Initial Setup

  • Download the latest console system image of Debian 7.11 (Wheezy) system image (bone-debian-7.11-console-armhf-2016-06-15-2gb.img.xz) from the firmware release repository, or using the get_image.sh bash script found in the software/debian/ folder.
  • Flash this image onto an empty SD card following step 0 of official BeagleBone Getting Started Guide or using the flash_image.sh <image file> <SD card target> bash script found in the same folder.
  • Boot your system and login via ssh as root: ssh root@<device-address> (NOTE: for security reasons, this login will be deactivated by the setup script)
  • Clone this repository on the RocketLogger (install git and ntp first using apt-get install git ntp) or copy the 'software' folder to it
  • Change to the subfolder software/debian/
  • Run the setup script ./setup_beaglebone.sh
  • Confirm to reboot at the end of the installation script or reboot the system manually with reboot

After this initial system setup you will only be able to login as rocketlogger user using the default ssh key. The required settings are

  • SSH port: 2322
  • SSH private key: can be downloaded here, the passphrase to unlock it is available here.
  • The user's password is "beaglebone". However, this is only useful for gaining root privileges once logged in (using sudo). Password only and root logins are blocked.

We highly recommend that you replace the standard key with an ssh key generated yourself (replace both files in the /home/rocketlogger/.ssh/ folder)!

How to generate your of key is explained in the SSH Help at Gitlab.

Device Tree Overlay

  • Change to the subfolder software/device_tree_overlay
  • Compile and install device tree overlay: make and sudo make install

RocketLogger Binary

  • Change to the subfolder software/rocketlogger
  • Build and install software: make and sudo make install
  • Reboot to apply all changes
  • Do a calibration run (see Calibration Guide).

Webserver/Control Interface

This component is optional, but highly recommended for convenient device control.

  • Change to the subfolder software/webserver
  • Run sudo ./setup_web.sh
  • Create password file using the command htpasswd -c /home/rocketlogger/.htpasswd "username". Remember the set password, you will use it later to login to the web interface.

Software Updates

Updating the software is also straight forward. Backup any important measurement data before updating!

Updates to the system configuration or the device tree overlay are not necessary unless otherwise noted in the release notes. You might need to set a new default measurement configuration if the configuration file structure was updated. Calibration is hardware specific and recalibration not necessary when updating the software only.

Clone this wiki locally