Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
HeaterMeter 4.x Software
Clone this wiki locally
The easiest method is to download the firmware image from the official HeaterMeter Downloads site. Be sure to download the firmware appropriate for the Raspberry Pi model you are using. Images are not compatible between device models, but the configuration is. Wifi client credentials can also be automatically configured using this facility, preventing any need for editing the configuration files to get the HeaterMeter on your network.
Instructions for Windows:
Download and unzip Win32 Disk Imager (binary)
Insert your SD card into your computer, launch Win32 Disk Imager, select the SD card drive, browse for the HeaterMeter IMG file (not the ZIP if you downloaded that!), and hit the "Write" button. Writing to the SD card should take only a few seconds.
Instructions for Apple OSX:
Download and install ApplePi-Baker
Insert your SD card into your computer, launch ApplePi-Baker, select the SD card on the left, under "Pi-Crust", on the right side, click on the empty box to the right of "IMG file" and browse for the openwrt IMG file and click on the "Restore Backup" button. Writing to the SD card should take only a few seconds.
Instructions for Linux:
Download the openwrt-rpi.gz file from the OpenWrt firmware image link a at the top of the page.
gzcat /path/to/openwrt-rpi.gz > /dev/sdX
Replace /dev/sdX with the real path to your SD card.
If you already have a supported USB wifi adapter, you can pre-configure your wifi settings by following the instructions below, otherwise go ahead and insert the SD card into the Raspberry Pi and power it up using either the 12V barrel jack on the HeaterMeter board or the rPi micro USB power input. Do not hook up both at the same time! For the first boot, using the rPi micro USB power input is preferred to verify the operation of your assembled HeaterMeter board without the chance of subjecting the rPi to 12V which will definitely fry components on it.
If this is the first time you've booted the rPi using the prepared SD card, the HeaterMeter firmware will be installed automatically onto the ATmega328. Within 30 seconds of booting, the LCD should light up and display -No Pit Probe-. If you've built the thermocouple version, you will see a reported temp of around 4F-19F instead of "-No Pit Probe-". You will need to change the Probe 0 type to Thermocouple in the web config. If you don't see anything on the LCD, but it lights up, try adjusting the contrast potentiometer with a small screwdriver.
Once the device boots, if it has internet access, simply use a browser to navigate to http://heatermeter.com/devices/ and your HeaterMeter should be listed automatically. For more information about device registration see HeaterMeter Device Registration. If registration is not successful, continue reading.
By default the rPi's ethernet is set to both the IP address 192.168.200.1 and DHCP. If the device gets a DHCP address from your network, it will be displayed for 20 seconds on the HeaterMeter LCD. The configuration website is available at http://192.168.200.1/ (or the DHCP address) username "root" with no password. A monitor and keyboard can also be connected. If editing configuration via the console, network configuration is in /etc/config/network
The stock image includes drivers for any rtl8192cu-based and RT5370 USB wifi adapters, and the wifi device integrated on Raspberry Pi 3 and Zero W. See Wireless Adapters for a more complete listing. The adapter should be recognized if inserted before booting and be shown in the System -> Network -> Wifi web configuration pages. Both AP and client mode are supported, and starting with LinkMeter v12 the device will be configured as an open Access Point with the name (SSID) "heatermeter", on IP address http://192.168.201.1/ or http://OpenWrt.local/ (only if connecting through the wifi!)
Wireless Client Setup
Note The absolute easiest way to configure wifi on your HeaterMeter is to go to the top of this page and follow the instructions to download a pre-built image with your wifi credentials already added.
Wireless Client Setup via config files
Step 1: Insert your SD card back into your card writer / computer and edit the config.txt file located in the top level folder of the card. At the bottom of that file there's now a
## wifi configuration section.
## ## wifi configuration ## # SSID (network name) -- Case-sensitive! #wifi_ssid=heatermeter # Password for encryption -- Case-sensitive! #wifi_password=password # Encryption mode psk2 (WPA2-PSK default), psk, wep, none #wifi_encryption=psk2 # Mode ap (Access Point) or sta (Client mode, default). Must be lowercase! #wifi_mode=ap # wifi channel, only used in AP mode #wifi_channel=6 # wifi band 5 GHz (5) or 2.4 GHz (2), only required in AP mode #wifi_band=2
Regular wifi client mode with WPA2 security (most common):
Just uncomment out (remove the # at the beginning of the line) for the wifi_ssid and wifi_password entries.
# SSID (network name) wifi_ssid=MyHomeWireless # Password for encryption wifi_password=MyWirelessPassword
Step 2: Save the file, eject the SD card and insert it back into the Raspberry Pi
Step 3: Plug your USB wifi dongle into the Raspberry Pi
Step 4: Power up your HeaterMeter
The configuration takes place at the end of boot, after the network has already been initialized, so you'll see it pop up in the original mode first, then switch to the desired mode. This is because it needs to take place after the configuration restore has occurred (if it is going to). Once the wifi settings are loaded, it will automatically comment out all the wifi values in config.txt so it won't reset them again.
Note: If your wifi SSID or password contains quotes (single ' or double ") then you're going to experience a nightmare trying to get this to work. E.g. your SSID is
"Bryan's Wifi" = a bad time.
USB Mass Storage wifi configuration
A USB mass storage device (USB stick) can also be used to configure the wifi on bootup. The boot process looks for a config.txt file on the USB stick with the same format as above. Copy / paste the example above, edit it to match your network settings, and save it to your USB stick as config.txt. Insert the USB stick into the Pi and boot. Compared to the normal config.txt processing, the configuration here is not disabled after use so the same USB stick can be used over and over. This is also an easy way to switch between AP mode and client mode without needing to access the microsd card.