Difference between revisions of "Installation"

From bcmeter.org
Jump to navigation Jump to search
 
(6 intermediate revisions by the same user not shown)
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, a new drive is visible in Windows Explorer or Mac OS Finder called '''/boot'''. Here you find '''wpa_supplicant.conf''' - open that file with any notepad application and change the WiFi credentials to your needs. Dont use Word or Office since they might change the quotation marks. Enable plain text mode in OSX Text Edit (SHIFT+COMMAND+T). <br>
# Download the bcMeter image file [https://bcmeter.org/wp-content/uploads/simple-file-list/bcMeter_latest_img.zip here]
'''If it is refused to save the wpa_supplicant directly by the text editor, copy the file over to your PC, edit it there and copy back.'''
# Unzip the downloaded file to extract the image
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 bcMeter or bcMeter.local
# Use [https://www.balena.io/etcher/ Etcher] to flash the image to your microSD card:
#* 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 ==
'''Only continue if you really need and want to setup the system manually!
'''=== Download Image ===


Use the [https://www.raspberrypi.com/software/ Raspberry Imager] tool to write Raspberry OS LITE (very important - not Desktop!) to your card. Configure the tool to work with username pi and choose any password.<br><br>
 
Enable SSH and WiFi in the tool.
Use the [https://www.raspberrypi.com/software/ Raspberry Imager] tool to write Raspberry OS 32bit LITE (very important - '''not''' Desktop!) to your microSD card.  
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.
After finishing, eject the microSD Card from the PC and put it into the Raspberry Pi.
Line 20: Line 42:
Put microSD-Card in Raspberry and boot it up (takes up to a minute)
Put microSD-Card in Raspberry and boot it up (takes up to a minute)


Log into the raspberry via terminal on Linux/OSX
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 any terminal client on Windows (for example Putty) with the following default credentials
address: bcMeter


address: raspberrypi
login name: bcMeter


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


login passwort: raspberry (or whatever you chose)
'''If connections is refused, check connection first and then try to add .local to hostname (raspberry.local)'''


'''(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.)'''
Then just download the bcMeter install script by entering
      wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh


5. Being logged in, enter
This will take you through a mainly unattended install procedure which will take a few minutes
      wget -N https://raw.githubusercontent.com/bcmeter/bcmeter/main/install.sh && sudo bash install.sh

Latest revision as of 11:38, 11 March 2025

Recommended: Use of preconfigured microSD Card image

Step 1: Download and Flash the Image

  1. Download the bcMeter image file here
  2. Unzip the downloaded file to extract the image
  3. Use Etcher to flash the image to your microSD card:
    • 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

  1. Insert the flashed microSD card into your bcMeter device
  2. Power on the device
  3. Wait approximately 2 minutes for the device to boot completely
  4. On your computer or mobile device, connect to the WiFi network named "bcMeter"
    • Use password: bcMeterbcMeter

Step 3: Configure Your Device

  1. Open a web browser
  2. Navigate to bcmeter.local
  3. The bcMeter configuration interface will appear
  4. 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 bcMeter documentation

Advanced: Manual headless Set Up the microSD Card

Use the Raspberry Imager tool to write Raspberry OS 32bit LITE (very important - not Desktop!) to your microSD card. Configure the Raspberry Pi Imager tool to configure the image with username and password, for simplicity we use "pi" and "raspberry".

Also enable SSH and WiFi in the tool.

After finishing, eject the microSD Card from the PC and put it into the Raspberry Pi.


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

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

Log into the raspberry via terminal on Linux/OSX or cmd.exe on Windows 

     ssh bcMeter@bcMeter

or alternatively if connection is refused 

     ssh bcMeter@bcMeter.local

Or to use with dedicated ssh client, like putty:

address: bcMeter

login name: bcMeter

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)

Then just download the bcMeter install script by entering 

      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

Retrieved from "https://bcmeter.org/wiki/index.php?title=Installation&oldid=287"