update README.md

esp8266-bme280
noerw 8 years ago
parent 15b3c2f56c
commit f17b5c4275

2
.gitignore vendored

@ -0,0 +1,2 @@
.vscode
config.h

@ -1,6 +1,6 @@
# mobile-sensebox # mobile-sensebox
This is a modular (but probably overcomplicated) sketch for a mobile sensebox. This is a modular (but probably overcomplicated) sketch for a mobile sensebox, written as a part of my bachelors thesis.
It measures arbitrary phenomena (currently only implemented: WiFi network count), It measures arbitrary phenomena (currently only implemented: WiFi network count),
which are geocoded and uploaded to the [openSenseMap](https://opensensemap.org) upon wifi connection. which are geocoded and uploaded to the [openSenseMap](https://opensensemap.org) upon wifi connection.
@ -13,14 +13,14 @@ Written for a ESP8266 ([Wemos D1 R1](http://www.wemos.cc/Products/d1.html)) with
and based on the [ESP8266 Arduino core](https://github.com/esp8266/Arduino) for Arduino IDE. and based on the [ESP8266 Arduino core](https://github.com/esp8266/Arduino) for Arduino IDE.
The sketch should work with any other ESP variant as well. The sketch should work with any other ESP variant as well.
The GPS module must provide NMEA sentences & be connected via the hardware serial (GPIOs `0` & `1`) The GPS module must provide NMEA sentences & be connected via the hardware serial (Wemos Pins `0` & `1`).
SoftSerial did not work for me but created many issues (random crashes, due to buffer overflows?). `SoftSerial` did not work for me but created many issues (random crashes, due to buffer overflows?).
## software installation ## software installation
- install [Arduino IDE](https://arduino.cc/en/Main/Software) - install [Arduino IDE](https://arduino.cc/en/Main/Software)
- install [ESP8266 Arduino core](https://github.com/esp8266/Arduino#installing-with-boards-manager) - install [ESP8266 Arduino core](https://github.com/esp8266/Arduino#installing-with-boards-manager)
- connect your ESP8266 via USB - connect your ESP8266 via USB
- open the file `mobile-sensebox.ino` in the Arduino IDE - open the file `mobile-sensebox.ino` in Arduino IDE
- change the configuration to your needs in the file `config.h` - change the configuration to your needs in the file `config.h`
- select the board `Wemos D1 (retired)` (or whatever you have) - select the board `Wemos D1 (retired)` (or whatever you have)
- hit upload (the GPS device must not be connected!) - hit upload (the GPS device must not be connected!)
@ -28,6 +28,7 @@ SoftSerial did not work for me but created many issues (random crashes, due to b
## program behaviour ## program behaviour
Once started, the device will idle until a first GPS fix was established. Once started, the device will idle until a first GPS fix was established.
From then on the following procedure runs repeatedly: From then on the following procedure runs repeatedly:
1. **measure** phenomena (wifi scan takes ~1sec) 1. **measure** phenomena (wifi scan takes ~1sec)
2. update GPS **location** (takes 0.5-2sec) 2. update GPS **location** (takes 0.5-2sec)
3. **store** measurements to local filesystem (SPIFFS) 3. **store** measurements to local filesystem (SPIFFS)

Loading…
Cancel
Save