Installation - Revision history

Bcmwiki: Fix hostname: bcmeter-XXXX.local (last 4 hex chars of MAC)

2026-03-08T18:38:56Z

Fix hostname: bcmeter-XXXX.local (last 4 hex chars of MAC)

← Older revision		Revision as of 18:38, 8 March 2026
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
Line 50:		Line 50:
	# 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.

Bcmwiki: Update: V1/V2 naming, remove ESP32/Pi distinction

2026-03-08T13:21:09Z

Update: V1/V2 naming, remove ESP32/Pi distinction

← Older revision		Revision as of 13:21, 8 March 2026
Line 1:		Line 1:
	{{Note\|1='''Legacy V1 Documentation''' — This page documents ~~Raspberry Pi~~ software setup for the bcMeter V1. The current ~~ESP32-based~~ bcMeter comes pre-configured and is set up via the [[Setup#Welcome Screen\|Welcome Screen]]. These instructions are preserved for V1 users.}}		{{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: Pre-configured microSD Card Image (V1) ==		== Recommended: Pre-configured microSD Card Image (V1) ==
Line 44:		Line 44:
	This runs an unattended installation taking a few minutes.		This runs an unattended installation taking a few minutes.

	== Current Platform (~~ESP32~~) ==		== Current Platform (V2) ==

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

	# Plug in power		# Plug in power

Bcmwiki: Wiki update: sync with manual and dev docs (2026-03)

2026-03-08T13:10:40Z

Wiki update: sync with manual and dev docs (2026-03)

← Older revision		Revision as of 13:10, 8 March 2026
Line 1:		Line 1:
			{{Note\|1='''Legacy V1 Documentation''' — This page documents Raspberry Pi software setup for the bcMeter V1. The current ESP32-based bcMeter comes pre-configured and is set up via the [[Setup#Welcome Screen\|Welcome Screen]]. These instructions are preserved for V1 users.}}

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

	~~== Recommended: Use of preconfigured microSD Card image ==~~
	=== Step 1: Download and Flash the Image ===		=== 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]		# Download the bcMeter image file [https://bcmeter.org/wp-content/uploads/simple-file-list/bcMeter_latest_img.zip here]
	# Unzip the downloaded file ~~to extract the image~~		# Unzip the downloaded file
	# Use [https://www.balena.io/etcher/ Etcher] to flash the image to your microSD card:		# Use [https://www.balena.io/etcher/ Etcher] to flash the image to your microSD card:
	#* Insert your microSD card ~~into your computer~~		#* Insert your microSD card
	#* Open Etcher and select the ~~extracted~~ image ~~file~~		#* Open Etcher and select the image
	#* Select your microSD card as ~~the~~ target		#* Select your microSD card as target
	#* Click "Flash!" and wait for ~~the process to complete~~		#* Click "Flash!" and wait for completion

	=== Step 2: Boot and Connect ===		=== Step 2: Boot and Connect ===
	# Insert the flashed microSD card into ~~your bcMeter device~~
			# Insert the flashed microSD card into the Raspberry Pi
	# Power on the device		# Power on the device
	# Wait approximately 2 minutes for ~~the device to~~ boot ~~completely~~		# Wait approximately 2 minutes for boot
	# ~~On your computer or mobile device, connect~~ to the WiFi network ~~named~~ "'''bcMeter'''"		# Connect to the WiFi network "'''bcMeter'''" with password: <code>bcMeterbcMeter</code>
	~~#* Use~~ password: ~~'''~~bcMeterbcMeter~~'''~~

	~~=== Step 3: Configure Your Device ===~~
	~~# Open a web browser~~
	~~# Navigate to [http://bcmeter.local bcmeter.local]~~
	~~# The bcMeter configuration interface will appear~~
	~~# Follow the on-screen instructions to complete your device setup~~

	~~=== Troubleshooting ===~~
	* If you cannot connect to the "bcMeter" WiFi network, try rebooting the device
	* If the web interface doesn't load, ensure you're connected to the correct WiFi network

	~~== Advanced: Manual headless Set Up the microSD Card ==~~


	~~Use the [https:~~/~~/www.raspberrypi.com/software/ Raspberry Imager] tool to write Raspberry OS 64bit LITE to the microSD-Card for Raspberry pi 3A+ (32bit LITE only for raspberry 2 - legacy - not suggested)~~
	~~Do '''not''' install the Dyesktop variant.~~

	Configure ~~the Raspberry Pi Imager tool to configure the image with username and password, use "bcmeter" and "bcmeter.org" so the installer script.<br><br>~~		=== Step 3: Configure ===
	~~Also enable SSH and WiFi in the tool.~~

	~~After finishing, eject the microSD Card from the PC~~ and ~~put it into the Raspberry Pi~~.		# Open a browser and navigate to <code><nowiki>http://bcmeter.local</nowiki></code>
			# The bcMeter interface will appear
			# Follow on-screen instructions

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

	~~=== Configuring~~ the Raspberry Pi to ~~be a bcMeter via SSH remote access and WiFi ===~~		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.

	~~Put microSD-Card in Raspberry~~ and ~~boot it up (takes up to a minute)~~		Configure with username <code>bcmeter</code> and password <code>bcmeter.org</code>. Enable SSH and WiFi.

	~~Log into the raspberry via terminal on Linux/OSX or cmd.exe on Windows~~		=== SSH Installation ===
	~~ssh bcmeter@bcMeter~~
	~~or alternatively if connection is refused~~
	~~ssh bcmeter@bcMeter.local~~

	~~Or to use with dedicated~~ ssh ~~client, like putty~~:		<pre>
			ssh bcmeter@bcMeter
			# or: ssh bcmeter@bcMeter.local

	~~address~~: ~~bcMeter~~		# Download and run installer
			wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh
			</pre>

	~~login name: bcmeter~~		This runs an unattended installation taking a few minutes.

	~~login passwort: bcmeter.org~~ (~~or whatever you chose~~)		== Current Platform (ESP32) ==

	~~'''If connections is refused, check connection first and then try to add~~ .~~local to hostname (bcmeter.local)'''~~		The ESP32-based bcMeter comes with firmware pre-installed. Setup only requires:

	~~Then just download~~ the bcMeter ~~install script by entering~~		# Plug in power
	~~wget -N https~~://~~raw.githubusercontent~~.~~com~~/~~bcmeter~~/~~bcmeter/main/install.sh && sudo bash install.sh~~		# Connect to the "bcMeter" WiFi hotspot
			# Open <code><nowiki>http://bcmeter.local</nowiki></code>
			# Follow the [[Setup#Welcome Screen\|Welcome Screen]]

	~~This will take you through a mainly unattended install procedure which will take a few minutes~~		See [[Setup]] for detailed instructions.

Bcmwiki at 10:16, 20 October 2025

2025-10-20T10:16:54Z

← Older revision		Revision as of 10:16, 20 October 2025
Line 56:		Line 56:
	login passwort: bcmeter.org (or whatever you chose)		login passwort: bcmeter.org (or whatever you chose)

	'''If connections is refused, check connection first and then try to add .local to hostname (~~raspberry~~.local)'''		'''If connections is refused, check connection first and then try to add .local to hostname (bcmeter.local)'''

	Then just download the bcMeter install script by entering		Then just download the bcMeter install script by entering

Bcmwiki at 10:13, 20 October 2025

2025-10-20T10:13:06Z

← Older revision		Revision as of 10:13, 20 October 2025
Line 31:		Line 31:

	Use the [https://www.raspberrypi.com/software/ Raspberry Imager] tool to write Raspberry OS 64bit LITE to the microSD-Card for Raspberry pi 3A+ (32bit LITE only for raspberry 2 - legacy - not suggested)		Use the [https://www.raspberrypi.com/software/ Raspberry Imager] tool to write Raspberry OS 64bit LITE to the microSD-Card for Raspberry pi 3A+ (32bit LITE only for raspberry 2 - legacy - not suggested)
	Do - '''not''' install the Dyesktop variant.		Do '''not''' install the Dyesktop variant.

	Configure the Raspberry Pi Imager tool to configure the image with username and password, use "bcmeter" and "bcmeter.org" so the installer script.<br><br>		Configure the Raspberry Pi Imager tool to configure the image with username and password, use "bcmeter" and "bcmeter.org" so the installer script.<br><br>

Bcmwiki at 10:11, 20 October 2025

2025-10-20T10:11:39Z

← Older revision		Revision as of 10:11, 20 October 2025
Line 30:		Line 30:


	Use the [https://www.raspberrypi.com/software/ Raspberry Imager] tool to write Raspberry OS 32bit LITE ~~(very important~~ - '''not''' ~~Desktop!) to your microSD card~~.		Use the [https://www.raspberrypi.com/software/ Raspberry Imager] tool to write Raspberry OS 64bit LITE to the microSD-Card for Raspberry pi 3A+ (32bit LITE only for raspberry 2 - legacy - not suggested)
	Configure the Raspberry Pi Imager tool to configure the image with username and password, ~~for simplicity we~~ use "pi" and "~~raspberry~~".<br><br>		Do - '''not''' install the Dyesktop variant.

			Configure the Raspberry Pi Imager tool to configure the image with username and password, use "bcmeter" and "bcmeter.org" so the installer script.<br><br>
	Also enable SSH and WiFi in the tool.		Also enable SSH and WiFi in the tool.

Line 42:		Line 44:

	Log into the raspberry via terminal on Linux/OSX or cmd.exe on Windows		Log into the raspberry via terminal on Linux/OSX or cmd.exe on Windows
	ssh ~~bcMeter~~@bcMeter		ssh bcmeter@bcMeter
	or alternatively if connection is refused		or alternatively if connection is refused
	ssh ~~bcMeter~~@bcMeter.local		ssh bcmeter@bcMeter.local

	Or to use with dedicated ssh client, like putty:		Or to use with dedicated ssh client, like putty:
Line 50:		Line 52:
	address: bcMeter		address: bcMeter

	login name: ~~bcMeter~~		login name: bcmeter

	login passwort: bcmeter.org (or whatever you chose)		login passwort: bcmeter.org (or whatever you chose)

Bcmwiki at 07:59, 9 October 2025

2025-10-09T07:59:41Z

← Older revision		Revision as of 07:59, 9 October 2025
Line 26:		Line 26:
	* If you cannot connect to the "bcMeter" WiFi network, try rebooting the device		* If you cannot connect to the "bcMeter" WiFi network, try rebooting the device
	* If the web interface doesn't load, ensure you're connected to the correct WiFi network		* If the web interface doesn't load, ensure you're connected to the correct WiFi network
	* For additional help, consult the [https://bcmeter.org/documentation bcMeter documentation]

	== Advanced: Manual headless Set Up the microSD Card ==		== Advanced: Manual headless Set Up the microSD Card ==

Bcmwiki: /* Recommended: Use of preconfigured microSD Card image */

2025-03-11T09:38:30Z

Recommended: Use of preconfigured microSD Card image

← Older revision		Revision as of 09:38, 11 March 2025
Line 1:		Line 1:

	== Recommended: Use of preconfigured microSD Card image==		== Recommended: Use of preconfigured microSD Card image ==
	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>~~		=== Step 1: Download and Flash the Image ===
	~~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.~~		# Download the bcMeter image file [https://bcmeter.org/wp-content/uploads/simple-file-list/bcMeter_latest_img.zip here]
	~~Log into the Wifi with Password~~ bcMeterbcMeter		# Unzip the downloaded file to extract the image
	~~Then you can setup the device by accessing it in~~ a ~~Browser by address~~ http://bcmeter.local ~~by default~~.		# Use [https://www.balena.io/etcher/ Etcher] to flash the image to your microSD card:
	~~For security reasons~~, the ~~hotspot is closed after 10 Minutes without being hooked into a wifi. You can override it in~~ the interface ~~and set the corresponding parameter if~~ you ~~want~~ to ~~run~~ the bcMeter ~~permanently in hotspot mode.~~		#* Insert your microSD card into your computer
			#* Open Etcher and select the extracted image file
			#* Select your microSD card as the target
			#* Click "Flash!" and wait for the process to complete

			=== Step 2: Boot and Connect ===
			# Insert the flashed microSD card into your bcMeter device
			# Power on the device
			# Wait approximately 2 minutes for the device to boot completely
			# On your computer or mobile device, connect to the WiFi network named "'''bcMeter'''"
			#* Use password: '''bcMeterbcMeter'''

			=== Step 3: Configure Your Device ===
			# Open a web browser
			# Navigate to [http://bcmeter.local bcmeter.local]
			# The bcMeter configuration interface will appear
			# Follow the on-screen instructions to complete your device setup

			=== Troubleshooting ===
			* If you cannot connect to the "bcMeter" WiFi network, try rebooting the device
			* If the web interface doesn't load, ensure you're connected to the correct WiFi network
			* For additional help, consult the [https://bcmeter.org/documentation bcMeter documentation]

	== Advanced: Manual headless Set Up the microSD Card ==		== Advanced: Manual headless Set Up the microSD Card ==

Bcmwiki: /* Advanced: Manual headless Set Up the microSD Card */

2025-03-11T09:36:51Z

Advanced: Manual headless Set Up the microSD Card

← Older revision		Revision as of 09:36, 11 March 2025
Line 38:		Line 38:
	Then just download the bcMeter install script by entering		Then just download the bcMeter install script by entering
	wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh		wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh

			This will take you through a mainly unattended install procedure which will take a few minutes

Bcmwiki: /* Configuring the Raspberry Pi to be a bcMeter via SSH remote access and WiFi */

2025-03-11T09:34:34Z

Configuring the Raspberry Pi to be a bcMeter via SSH remote access and WiFi

← Older revision		Revision as of 09:34, 11 March 2025
Line 22:		Line 22:

	Log into the raspberry via terminal on Linux/OSX or cmd.exe on Windows		Log into the raspberry via terminal on Linux/OSX or cmd.exe on Windows
	ssh pi@~~raspberrypi~~		ssh bcMeter@bcMeter
	or alternatively if connection is refused		or alternatively if connection is refused
	ssh pi@~~raspberrypi~~.local		ssh bcMeter@bcMeter.local

	Or to use with dedicated ssh client, like putty:		Or to use with dedicated ssh client, like putty:

	address: ~~raspberrypi~~		address: bcMeter

	login name: pi		login name: bcMeter

	login passwort: ~~raspberry~~ (or whatever you chose)		login passwort: bcmeter.org (or whatever you chose)

	'''If connections is refused, check connection first and then try to add .local to hostname (raspberry.local)'''		'''If connections is refused, check connection first and then try to add .local to hostname (raspberry.local)'''