Skip to content

Deploying on a Raspberry Pi

Jump to bottom
Paul C. Zimmerman edited this page Jun 30, 2024 · 25 revisions

Why Raspberry Pi?

Raspberry Pi single board computers are popular and inexpensive, and make an excellent platform for running ShootPoints-Web in the field.

Which Models are Supported?

ShootPoints-Web has been used on Raspberry Pi 2 Model B computers on excavations in Iraq. Because of its good balance of small size, reasonable speed, low power consumption, full-sized USB port, and built-in Wi-Fi, I prefer deploying on the Raspberry Pi 3 Model A+, but it will run equally well on any currently-produced model.

What Do These Instructions Do?

The procedure documented below will turn your Raspberry Pi into a headless data collector for use in the field. By following it you will install the latest version of Raspbian OS onto your device, configure it to create a Wi-Fi network called “shootpoints,” and set ShootPoints-Web to run at startup.

Install Rasbian

  1. Download and install the Raspberry Pi Imager app.
  2. Launch Raspberry Pi Imager, and choose the appropriate device. Choose Device
  3. Click the “Choose OS’ button and then “Raspberry Pi OS (other).” Choose OS
  4. Select the appropriate Lite version of the Raspberry Pi OS. (For a Raspberry Pi 3 Model A+ this is “Raspberry Pi OS (Legacy, 64-bit) Lite.”) Choose RPi OS Lite
  5. Choose the storage medium (i.e., the microSD card that you will install in the Raspberry Pi). Choose Storage Medium
  6. You will use OS customisation, so click the “Edit Settings” button. Edit OS customisation settings
  7. Under the OS Customisation “General” tab set the hostname, username, and password all to “shootpoints.” Set hostname, username, and pw
  8. Under the OS Customisation “Services” tab enable SSH with password authentication. Enable ssh
  9. Save the customizations and then write the image to the microSSD, accepting the fact that any existing data on the storage medium will be lost, and entering your password when prompted.

Install ShootPoints-Web

  1. (optional) Connect the Raspberry Pi to an external monitor with HDMI.
  2. Connect the Raspberry Pi to your local network with ethernet and power it on. (Models without an ethernet port will need a USB to ethernet adapter.)
  3. Wait a few minutes for the device to fully configure itself. If it’s connected to a monitor you can wait until the login prompt appears.
  4. Use ssh to connect to the Raspberry Pi from another computer on the same network. (Window users may need to install Putty first.)
    ssh shootpoints@shootpoints.local
  5. Run the installation script.
    curl -s https://raw.githubusercontent.com/Lugal-PCZ/shootpoints-web-rpi-installer/main/install-shootpoints-web.sh | bash
  6. Shut down the Raspberry Pi.
    sudo shutdown -h now

Next Steps

USB-to-Serial Adapter

Plug a USB-to-serial adapter into the Raspberry Pi to connect it to the total station’s serial cable. For my Topcon total station, I use this USB to hirose cable.

Enclosure

3D print an enclosure for your Raspberry Pi.

Status LED

Attach an LED to GPIO 26 and ground for an external indicator of whether or not the Raspberry Pi is running.
raspberry-pi-pinout

QR Code

Print out this QR code and affix it to the Raspberry Pi enclosure so that your field crew can easily connect to ShootPoints-Web and use the software.
QR Code

Clone this wiki locally