Note: Weather Underground announced they were shutting down the weather API in End of Service for the Weather Underground API but seem to continue to support personal weather stations. A user reported that the API endpoint changed, but I can't find any data to confirm that, so you'll have to figure that out yourself. Sorry.
Another Note: If you have an issue with this project, open an issue here. In the past, people have emailed me or posted questions to other forums - the easiest way to get the author (me) to help you is to just ask, here.
This is a Raspberry Pi project that measures weather values (temperature, humidity and pressure) using the Astro Pi Sense HAT then uploads the data to a Weather Underground weather station. The Sense HAT board includes instruments that measure temperature, humidity and barometric pressure plus an 8x8 LED display, a joystick, and an accelerometer. The HAT was created by the folks at Astro Pi; elementary school children were solicited to create experiments using the Sense HAT it that would be executed on the International Space Station. Eventually, many experiments were selected and an astronaut performed them and sent back the results for analysis. I read different articles about this board, so I decided to create a project using it. I'd wanted to install a weather station in my yard and upload the weather data to Weather Underground; the Sense HAT and a Raspberry Pi seemed like a great way to do this.
Note: If you'd like to display one of the measurements on the display instead of the arrows this app uses, take a look at this: http://yaab-arduino.blogspot.co.uk/2016/08/display-two-digits-numbers-on-raspberry.html.
This project is very easy to assemble, all you need is the following 4 parts, and they all connect together:
- Raspberry Pi 3 - I selected this model because it has built in Wi-Fi capabilities. You can use one of the other models, but you'll need to also purchase a Wi-Fi module or run the device on a wired connection.
- Astro Pi Sense HAT. There was a bad batch of Sense HAT device out there, so be careful. See the note below.
- Raspberry Pi case. The only commercial case I could find that supports the Sense HAT is the Zebra Case from C4 Labs with the Official Sense HAT upgrade for Zebra Case. You can also 3D print a case, you can find plans here: http://www.thingiverse.com/thing:1200534.
- Raspberry Pi Power Adapter. I used this one from Amazon.
NOTE: When I started this project (in 2015), there were quite a few companies selling Sense HAT devices, but very few of them had stock available. I finally found I could purchase one of the through Amazon.com, but when I plugged everything together and ran my code, I got results that didn't make sense. After sending that board back and getting another one with the same problem, I discovered it wasn't my code at fault. It turns out that Astro Pi used some faulty components in a batch of them and had to fix that problem before shipping any more. Refer to Defective Astro Pi Sense HAT Boards for more information about the faulty Sense HAT boards.
The project folder contains several files and one folder:
config.py- This is the project's external service configuration file, it provides the weather station with details about your Weather Underground station.LICENSE- The license file for this projectreadme.md- This file.start-station.sh- Shell script to start the weather station process.weather_station.py- The main data collection application for this project. You'll run this application to read the Sense HAT board and post the collected data.
Assembly is easy - mount the Sense HAT on the Raspberry Pi then insert it in the case and plug it into power. All set! No wiring, soldering or anything else required.
NOTE: The Raspberry Pi foundation recommend you mount the Sense HAT to the Raspberry Pi using standoffs and the Sense HAT I purchased included them in the package. Unfortunately, standoffs are incompatible with the C4 Labs Zebra Case and their Official Sense HAT upgrade for Zebra Case. Be sure to omit standoffs if using this case.
Weather Underground (WU) is a public weather service now owned by the Weather Channel; it's most well-known for enabling everyday people to setup weather stations and upload local weather data into the WU weatherbase for public consumption. Point your browser of choice to https://www.wunderground.com/weatherstation/overview.asp to setup your weather station. Once you complete the setup, WU will generate a station ID and access key you'll need to access the service from the project. Be sure to capture those values, you'll need them later.
Download the Raspbian image from raspberrypi.org then burn it to an SD card using the instructions found at Installing Operating System Images. Raspbian should automatically prompt you to select a Wi-Fi network and perform a software update.
When setup completes, you must enable the I2C protocol for the Sense HAT to work correctly. Open the Raspberry menu, select Preferences, then Raspberry Pi Configuration. When the application opens, select the Interfaces tab, enable the I2C protocol and click the OK button to save your changes.
Next, open a terminal window and execute the following command:
sudo apt install sense-hatThis command installs the support packages for the Sense HAT.
NOTE: One user shared the following information: "Execute
sudo nano /boot/config.txt, scroll to the bottom and adddtoverlay=rpi-senseto the end of the file. Then save and exit nano." I didn't need to do this in my testing, but I wanted to share the information.
Assuming the terminal window is pointing to the Pi user's home folder, in open terminal window, execute the following command:
git clone https://github.com/johnwargo/pi_weather_stationThis puts the project files in the current folder's pi_weather_station folder.
To upload weather data to the Weather Underground service, the application requires access to the station ID and station access key you created earlier in this setup process. Open the project's config.py in your editor of choice and populate the STATION_ID and STATION_KEY fields with the appropriate values from your Weather Underground Weather Station:
Config:
# Weather Underground
STATION_ID = ""
STATION_KEY = ""Refer to the Weather Underground Personal Weather Station Network to access these values.
The main application file, weather_station.py has two configuration settings that control how the program operates. Open the file in your favorite text editor and look for the following line near the beginning of the file:
# specifies how often to measure values from the Sense HAT (in minutes)
MEASUREMENT_INTERVAL = 10 # minutesThe MEASUREMENT_INTERVAL variable controls how often the application uses temperature measurements from the Sense HAT. It will read the sensors on the HAT every 5 seconds, but uses this value to configure how frequently it updates the data to the Weather Underground server.
If you’re testing the application and don’t want the weather data uploaded to Weather Underground until you're ready, change the value for WEATHER_UPLOAD to True (case matters, so it has to be True, not true):
# Set to False when testing the code and/or hardware
# Set to True to enable upload of weather data to Weather Underground
WEATHER_UPLOAD = FalseTo execute the data collection application, open a terminal window, navigate to the folder where you copied the project files and execute the following command:
python ./weather_station.pyThe terminal window should quickly sprout the following output:
############################################
# Pi Weather Station (Sense HAT) #
# By John M. Wargo (https://johnwargo.com) #
############################################
2020-07-04 07:02:43 INFO Initializing Weather Underground configuration
2020-07-04 07:02:43 INFO Successfully read Weather Underground configuration
2020-07-04 07:02:43 INFO Station ID: KNCCHARL225
2020-07-04 07:02:43 INFO Initializing the Sense HAT client
2020-07-04 07:02:46 INFO Initialization complete!
2020-07-04 07:02:46 INFO Initial temperature reading: 69.1
2020-07-04 07:02:50 INFO Temp: 69.1F (20.6C), Pressure: 29.4 inHg, Humidity: 39.0%
2020-07-04 07:02:55 INFO Temp: 69.3F (20.7C), Pressure: 29.4 inHg, Humidity: 39.0%
2020-07-04 07:03:00 INFO Temp: 69.5F (20.8C), Pressure: 29.4 inHg, Humidity: 38.0%
If you see something like that, you're golden. If not, figure out what any error messages mean, fix things, then try again. At this point, the application will start collecting data and uploading it to the Weather Underground every 10 minutes on the 10 minute mark (unless you changed the app's configuration to make the application work differently).
There are a few steps you must complete to configure the Raspberry Pi so it executes the project's python application on startup. If you don't already have a terminal window open, open one then navigate to the folder where you extracted the project files. Next, you need to make the project's bash script files executable by executing the following command:
chmod +x start-station.shNext, you'll need to open the pi user's session autostart file; when I first created this project, you would edit the file using the following command:
sudo nano ~/.config/lxsession/LXDE-pi/autostartThey moved the autostart file in later version(s) of Raspbian, so to edit the file, use the following command:
sudo nano /etc/xdg/lxsession/LXDE-pi/autostartAdd the following lines to the end (bottom) of the file:
@lxterminal -e /home/pi/pi_weather_station/start-station.shTo save your changes, press ctrl-o then press the Enter key. Next, press ctrl-x to exit the nano application.
Reboot the Raspberry Pi. When it restarts, both python processes should execute in a terminal window as shown in Figure 4.
Figure 1 - Raspberry Pi Weather Station
- 07-04-2020 - Added the Python Logging library to the project for cleaner and more useful output. Refactored the
mainfunction. - 10/24/2019 - Updated the readme (again) based on another user's feedback.
- 10/01/2019 - Updated the readme file, clarified the GitHub instructions and fixed one typo.
- 09/12/2016 - On recommendation from the Raspberry Pi Foundation, changed the algorithm for guestimating ambient temperature from this article.
You can find information on many different topics on my personal blog. Learn about all of my publications at John Wargo Books.
If you find this code useful and feel like thanking me for providing it, please consider Buying Me a Coffee, or making a purchase from my Amazon Wish List.