Difference between revisions of "Installation"

From bcmeter.org
Jump to navigation Jump to search
(Fix hostname: bcmeter-XXXX.local (last 4 hex chars of MAC))
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Note|1='''Legacy V1 Documentation''' — This page documents software setup for the bcMeter V1. The current V2 bcMeter comes pre-configured and is set up via the [[Setup#Welcome Screen|Welcome Screen]]. These instructions are preserved for V1 users.}}


== Recommended: Use of preconfigured microSD Card image==
== Recommended: Pre-configured microSD Card Image (V1) ==
1. Download the file image [https://bcmeter.org/wp-content/uploads/simple-file-list/bcMeter_latest_img.zip here], unzip it and use [https://www.balena.io/etcher/ Etcher] to copy it to your microSD card. <br>
2. After the process is complete, the bcMeter booted with the newly written microSD-Card is creating a WiFi named "bcMeter" after approx. 2 Minutes.
Log into the Wifi with Password bcMeterbcMeter
Then you can setup the device by accessing it in a Browser by address http://bcmeter.local by default.


== Advanced: Manual headless Set Up the microSD Card ==
=== Step 1: Download and Flash the Image ===


# Download the bcMeter image file [https://bcmeter.org/wp-content/uploads/simple-file-list/bcMeter_latest_img.zip here]
# Unzip the downloaded file
# Use [https://www.balena.io/etcher/ Etcher] to flash the image to your microSD card:
#* Insert your microSD card
#* Open Etcher and select the image
#* Select your microSD card as target
#* Click "Flash!" and wait for completion


Use the [https://www.raspberrypi.com/software/ Raspberry Imager] tool to write Raspberry OS 32bit LITE (very important - '''not''' Desktop!) to your microSD card.
=== Step 2: Boot and Connect ===
Configure the Raspberry Pi Imager tool to configure the image with username and password, for simplicity we use "pi" and "raspberry".<br><br>
Also enable SSH and WiFi in the tool.


After finishing, eject the microSD Card from the PC and put it into the Raspberry Pi.
# Insert the flashed microSD card into the Raspberry Pi
# Power on the device
# Wait approximately 2 minutes for boot
# Connect to the WiFi network "'''bcMeter'''" with password: <code>bcMeterbcMeter</code>


=== Step 3: Configure ===


=== Configuring the Raspberry Pi to be a bcMeter via SSH remote access and WiFi ===
# Open a browser and navigate to <code><nowiki>http://bcmeter-XXXX.local</nowiki></code> (where XXXX are the last 4 hex characters of the MAC address, shown on the device label)
# The bcMeter interface will appear
# Follow on-screen instructions


Put microSD-Card in Raspberry and boot it up (takes up to a minute)
== Advanced: Manual Setup via SSH (V1) ==


Log into the raspberry via terminal on Linux/OSX or cmd.exe on Windows
Use the [https://www.raspberrypi.com/software/ Raspberry Pi Imager] to write '''Raspberry OS 64-bit LITE''' to the microSD card. Do '''not''' install the Desktop variant.
      ssh pi@raspberrypi
or alternatively if connection is refused
      ssh pi@raspberrypi.local


Or to use with dedicated ssh client, like putty:
Configure with username <code>bcmeter</code> and password <code>bcmeter.org</code>. Enable SSH and WiFi.


address: raspberrypi
=== SSH Installation ===


login name: pi
<pre>
ssh bcmeter@bcMeter
# or: ssh bcmeter@bcMeter.local


login passwort: raspberry (or whatever you chose)
# Download and run installer
wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh
</pre>


'''If connections is refused, check connection first and then try to add .local to hostname (raspberry.local)'''
This runs an unattended installation taking a few minutes.


Then just download the bcMeter install script by entering
== Current Platform (V2) ==
      wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh
 
The V2 bcMeter comes with firmware pre-installed. Setup only requires:
 
# Plug in power
# Connect to the "bcMeter" WiFi hotspot
# Open <code><nowiki>http://bcmeter-XXXX.local</nowiki></code> (XXXX = last 4 hex chars of MAC address)
# Follow the [[Setup#Welcome Screen|Welcome Screen]]
 
See [[Setup]] for detailed instructions.

Latest revision as of 20:38, 8 March 2026

Template:Note

Recommended: Pre-configured microSD Card Image (V1)

Step 1: Download and Flash the Image

  1. Download the bcMeter image file here
  2. Unzip the downloaded file
  3. Use Etcher to flash the image to your microSD card:
    • Insert your microSD card
    • Open Etcher and select the image
    • Select your microSD card as target
    • Click "Flash!" and wait for completion

Step 2: Boot and Connect

  1. Insert the flashed microSD card into the Raspberry Pi
  2. Power on the device
  3. Wait approximately 2 minutes for boot
  4. Connect to the WiFi network "bcMeter" with password: bcMeterbcMeter

Step 3: Configure

  1. Open a browser and navigate to http://bcmeter-XXXX.local (where XXXX are the last 4 hex characters of the MAC address, shown on the device label)
  2. The bcMeter interface will appear
  3. Follow on-screen instructions

Advanced: Manual Setup via SSH (V1)

Use the Raspberry Pi Imager to write Raspberry OS 64-bit LITE to the microSD card. Do not install the Desktop variant.

Configure with username bcmeter and password bcmeter.org. Enable SSH and WiFi.

SSH Installation

ssh bcmeter@bcMeter
# or: ssh bcmeter@bcMeter.local

# Download and run installer
wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh

This runs an unattended installation taking a few minutes.

Current Platform (V2)

The V2 bcMeter comes with firmware pre-installed. Setup only requires:

  1. Plug in power
  2. Connect to the "bcMeter" WiFi hotspot
  3. Open http://bcmeter-XXXX.local (XXXX = last 4 hex chars of MAC address)
  4. Follow the Welcome Screen

See Setup for detailed instructions.