Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jcksnvllxr80/weather-station
Powered by solar, an ESP32-C3-Mini collects data from the rain, wind (speed & direction), humidity, pressure, and temperature sensors then sends it to the Wunderground PWS site and a Telegraf listener via a Wi-Fi connection to my LAN. ☁️ 🌀 ⚡ ☀️ ☔
https://github.com/jcksnvllxr80/weather-station
anemometer esp32 micropython rain-daily rain-hourly rainmeter sensor temperature weather-api weather-status wind-direction wind-gust wind-speed
Last synced: 23 days ago
JSON representation
Powered by solar, an ESP32-C3-Mini collects data from the rain, wind (speed & direction), humidity, pressure, and temperature sensors then sends it to the Wunderground PWS site and a Telegraf listener via a Wi-Fi connection to my LAN. ☁️ 🌀 ⚡ ☀️ ☔
- Host: GitHub
- URL: https://github.com/jcksnvllxr80/weather-station
- Owner: jcksnvllxr80
- Created: 2022-01-02T22:19:17.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-03-29T20:52:11.000Z (over 1 year ago)
- Last Synced: 2023-04-09T20:54:12.638Z (over 1 year ago)
- Topics: anemometer, esp32, micropython, rain-daily, rain-hourly, rainmeter, sensor, temperature, weather-api, weather-status, wind-direction, wind-gust, wind-speed
- Language: Python
- Homepage: https://www.wunderground.com/dashboard/pws/KFLJACKS4049
- Size: 5.6 MB
- Stars: 4
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Solar Powered ESP32-C3-Mini Weather Station with DS18B20
[](lib-release)
[](lib-release)
[](lib-stars)
[](lib-issues)
[](lib-licence)
## Image of project
## Schematic
## Grafana Dashboard
## Description
:cloud: :cyclone: :ocean: :zap: :sunny: :umbrella: :snowman: :foggy:
This project is powered by a solar panel that charges a lithium ion battery through a Sparkfun "solar buddy" board. The code is written in MicroPython on an ESP32-C3-Mini. The microcontroller collects data from the rain, wind (speed & direction), humidity, pressure, and temperature sensors in a variety of ways (i.e. i2c, oneWire, ADC, and electrical pulse interrupts). The data is collected every 5 seconds, then averaged at the end of two minutes and placed into a dictionary data structure. The dictionary is converted to JSON and sent to my Wunderground PWS site where my data and other users data get stored for public consumption. There is a Telegraf listener running in a docker container on my local network (repo for docker telegraf-influxdb-grafana stack -> ) which takes JSON requests via API and converts the data into a protocol that influxDb speaks. There are two Telegraf outputs; one goes to the local influxdb running in docker and the other goes to a Prometheus plugin running in my Grafana Cloud account. Both databases allow me to make beautiful charts and graphs to show and analyze the weather data. All connections to the network are via Wi-Fi connection on my Google Wifi (Mesh) LAN.
## Prerequisites
The following classes (which are all in this repo) must be manually loaded onto the esp32-c3 for this project to work (main.py also necessary):
- conf directory with 'config.json' inside... use the example i provided (will need to use an online converter to base64 encode your ssid and password)
- ``base64.py``
- ``time_utils.py``
- ``http_utils.py``
- ``api_utils.py``
- ``mrequests.py``
- ``weather.py``
- ``am2320.py``
- ``mpl3115a2.py``
## Erase and flash micropython on the ESP32-C3-Mini from windows CMD
- download and unzip
- download the MicroPython firmware (esp32c3-20220618-v1.19.1.bin)
- for the next step I used anaconda prompt (you may have to install dependencies)
- python esptool.py --chip esp32c3 --port COM erase_flash
- python esptool.py --chip esp32c3 --port COM -b 1500000 --baud 460800 write_flash -z 0x0 esp32c3-20220618-v1.19.1.bin
- the above two commands worked for me but here is a helpful link just in case:
## TODO
- add ability to take asynchronous requests over network via API so that local nagios can query weather status
- get a UV sensor
## Weather Vane voltage values and direction table
| Dir | Ri | Vi | Angle | R | Vo | ADC |
| :--- | :----: | :----: | :----: | :----: | :----: | ---: |
| N | 33000 | 3.3 | 0 | 33000 | 1.650 | 2335 |
| N/NE | 33000 | 3.3 | 22.5 | 6570 | 0.548 | 930 |
| NE | 33000 | 3.3 | 45 | 8200 | 0.657 | 925 |
| E/NE | 33000 | 3.3 | 67.5 | 891 | 0.087 | 123 |
| E | 33000 | 3.3 | 90 | 1000 | 0.097 | 140 |
| E/SE | 33000 | 3.3 | 112.5 | 688 | 0.067 | 300 |
| SE | 33000 | 3.3 | 135 | 2200 | 0.206 | 294 |
| S/SE | 33000 | 3.3 | 157.5 | 1410 | 0.135 | 190 |
| S | 33000 | 3.3 | 180 | 3900 | 0.349 | 494 |
| S/SW | 33000 | 3.3 | 202.5 | 3140 | 0.287 | 1516 |
| SW | 33000 | 3.3 | 225 | 16000 | 1.078 | 1525 |
| W/SW | 33000 | 3.3 | 247.5 | 14120 | 0.989 | 1400 |
| W | 33000 | 3.3 | 270 | 120000 | 2.588 | 3706 |
| W/NW | 33000 | 3.3 | 292.5 | 42120 | 1.850 | 2625 |
| NW | 33000 | 3.3 | 315 | 64900 | 2.188 | 3101 |
| N/NW | 33000 | 3.3 | 337.5 | 21880 | 1.316 | 1866 |
## wunderground API call
learn more here:
```text
https://weatherstation.wunderground.com/weatherstation/updateweatherstation.php?ID=KCASANFR5&PASSWORD=XXXXXX&dateutc=2000-01-01+10%3A32%3A35&winddir=230&windspeedmph=12&windgustmph=12&tempf=70&rainin=0&baromin=29.1&dewptf=68.2&humidity=90&weather=&clouds=&softwaretype=vws%20versionxx&action=updateraw
GET parameters
NOT all fields need to be set, the _required_ elements are:
ID
PASSWORD
dateutc
IMPORTANT all fields must be url escaped
reference http://www.w3schools.com/tags/ref_urlencode.asp
example
2001-01-01 10:32:35
becomes
2000-01-01+10%3A32%3A35
if the weather station is not capable of producing a timestamp, our system will accept "now". Example:
dateutc=now
list of fields:
action [action=updateraw] -- always supply this parameter to indicate you are making a weather observation upload
ID [ID as registered by wunderground.com]
PASSWORD [Station Key registered with this PWS ID, case sensitive]
dateutc - [YYYY-MM-DD HH:MM:SS (mysql format)] In Universal Coordinated Time (UTC) Not local time
winddir - [0-360 instantaneous wind direction]
windspeedmph - [mph instantaneous wind speed]
windgustmph - [mph current wind gust, using software specific time period]
windgustdir - [0-360 using software specific time period]
windspdmph_avg2m - [mph 2 minute average wind speed mph]
winddir_avg2m - [0-360 2 minute average wind direction]
windgustmph_10m - [mph past 10 minutes wind gust mph ]
windgustdir_10m - [0-360 past 10 minutes wind gust direction]
humidity - [% outdoor humidity 0-100%]
dewptf- [F outdoor dewpoint F]
tempf - [F outdoor temperature]
* for extra outdoor sensors use temp2f, temp3f, and so on
rainin - [rain inches over the past hour)] -- the accumulated rainfall in the past 60 min
dailyrainin - [rain inches so far today in local time]
mine will look more like this:
https://weatherstation.wunderground.com/weatherstation/updateweatherstation.php?ID=my_id&PASSWORD=my_key&dateutc=now&winddir=230&windspeedmph=12&windgustmph=12&tempf=70&rainin=0&dailyrainin=0&softwaretype=custom&action=updateraw
```
---
## For testing chunks of code on the ESP32-C3-Mini
Use Thonny to write some code to ESP32-C3-Mini: example below where i was testing the temp sensor.
```python
# 1-wire DS18B20
import machine, onewire, ds18x20, time
ds_pin = machine.Pin(19)
ds_sensor = ds18x20.DS18X20(onewire.OneWire(ds_pin))
roms = ds_sensor.scan()
print("Found ds18x20 devices: {}".format(roms))
ds_sensor.convert_temp()
time.sleep_ms(750)
for rom in roms:
print(ds_sensor.read_temp(rom))
```
## Star History
[](https://star-history.com/#jcksnvllxr80/weather-station&Date)