Installation

Preconfigured Set Up the microSD Card

1. Download the file image here, unzip it and use Etcher to copy it to your microSD card. 2. After the process is complete, a new drive is visible in Windows Explorer or Mac OS Finder called /boot. Open wpa_supplicant.conf with any notepad application and change the WiFi credentials to your needs. Dont use Word or Office since they might change the quotation marks. 3. Eject the microSD card and put it into the raspberry pi and boot it up. After 1-2 Minutes it should be logged into the WiFi with hostname raspberry

Alternatively, you can do that by commandline as well with dd and nano:

Write the image to microSD on Linux

     sudo dd if=path/to/bcMeter.img of=/dev/diskX bs=8M

Write the image to microSD on OSX

     sudo dd if=path/to/bcMeter.img of=/dev/rdiskX bs=8m

Replace path/to/image with path to image and (r)diskX with deviceaddress of your microSD-card. Drag / drop the icon to the terminal is possible if in desktop environment.

After the transfer is complete, change the WiFi credentials on /boot

     nano wpa_supplicant.conf

Safe the file with ctrl+o and exit with ctrl+x

Manual Set Up the microSD Card

0. Copy Image of Raspberry Pi OS Lite on your microSD card, Documentation for Linux / OSX in this file, for Windows use this method
Make sure to download the Lite and not Desktop / Desktop and recommended software

1. For Linux use the terminal to copy the image to the microSD card by this command:

     dd if=path/to/image of=/dev/diskX bs=8M

Replace path/to/image with path to image and diskX with deviceaddress of your microSD-card. Drag / drop the icon to the terminal is possible if in desktop environment.

Use rdiskX instead of diskX on OSX to accelerate the transfer

Configure the microSD Card for WiFi access

After the above steps, on Windows and OSX a new drive/partition named „boot“ is visible in Explorer or Finder. On Linux you see additionally rootfs, we can ignore this.

2. Create a new and empty file just called „ssh“ on the new boot partition. This is just for enabling ssh as Raspberry OS evaluates this file to enable the ssh configuration. You can simply do that in Linux/OSX by navigating to the /boot partition of the microSD Card and enter

     nano ssh

Then just save the empty file and exit (ctrl+o for save, ctrl+x for exit)

On Windows, open Notepad.exe and save the empty file as ssh on /boot. Double check in file properties that no .txt is added (but hidden)

3. Using the same method as above, put a file called wpa_supplicant.conf in the same partition (/boot). This contains the credentials needed to connect to your WiFi. Add as many Networks as you like.

Be sure to edit the parameter „country“ correctly, else the pi may not be able to connect to your WiFi. Copy / paste the following. Make sure quotes are pasted correctly.

     ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
     country=de
     update_config=1
     
     
     network={
     ssid="YourWiFiName"
     psk="Password"
     }

Save the file and eject the microSD Card from the PC. This file will be removed from this place as soon as the raspberry has read it. If your Raspberry does not connect to your WiFi, you can repeat this process as often as necessary. If the file is still there after an attempted boot, there has something more severe gone wrong.

Configuring the Raspberry Pi to be a bcMeter

4. Put microSD-Card in Raspberry and boot it up (takes up to a minute)

Log into the raspberry via terminal on Linux/OSX

     ssh pi@raspberrypi 

Or any terminal client on Windows (for example Putty) with the following default credentials

address: raspberrypi

login name: pi

login passwort: raspberry

(For some mobile hotspots it is required to add .local to the hostname (e.g. raspberryp.local). Try this first if no connection is possible.)

5. Being logged in, enter

      wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh