Difference between revisions of "Installation"

From bcmeter.org
Jump to navigation Jump to search
(Update: V1/V2 naming, remove ESP32/Pi distinction)
(Reframe: bcMeter (DIY) / source-available)
 
(One intermediate revision 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.}}
{{Note|1='''bcMeter (DIY)''' — This page documents software setup for the source-available bcMeter (DIY) — the Raspberry-Pi-based design, freely available for private, educational and research use (CC BY-NC 4.0). The assembled bcMeter instruments come pre-configured and are set up via the [[Setup#Welcome Screen|Welcome Screen]].}}


== Recommended: Pre-configured microSD Card Image (V1) ==
== Recommended: Pre-configured microSD Card Image (bcMeter DIY) ==


=== Step 1: Download and Flash the Image ===
=== Step 1: Download and Flash the Image ===
Line 22: Line 22:
=== Step 3: Configure ===
=== Step 3: Configure ===


# Open a browser and navigate to <code><nowiki>http://bcmeter.local</nowiki></code>
# 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
# The bcMeter interface will appear
# Follow on-screen instructions
# Follow on-screen instructions


== Advanced: Manual Setup via SSH (V1) ==
== Advanced: Manual Setup via SSH (bcMeter DIY) ==


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.
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.
Line 44: Line 44:
This runs an unattended installation taking a few minutes.
This runs an unattended installation taking a few minutes.


== Current Platform (V2) ==
== Assembled instruments (Kit/Complete/eBcMeter) ==


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


# Plug in power
# Plug in power
# Connect to the "bcMeter" WiFi hotspot
# Connect to the "bcMeter" WiFi hotspot
# Open <code><nowiki>http://bcmeter.local</nowiki></code>
# Open <code><nowiki>http://bcmeter-XXXX.local</nowiki></code> (XXXX = last 4 hex chars of MAC address)
# Follow the [[Setup#Welcome Screen|Welcome Screen]]
# Follow the [[Setup#Welcome Screen|Welcome Screen]]


See [[Setup]] for detailed instructions.
See [[Setup]] for detailed instructions.

Latest revision as of 12:35, 8 June 2026

Template:Note

Recommended: Pre-configured microSD Card Image (bcMeter DIY)

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 (bcMeter DIY)

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.

Assembled instruments (Kit/Complete/eBcMeter)

The assembled bcMeter instruments come 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.