FREQUENTLY ASKED QUESTIONS
FREQUENTLY ASKED QUESTIONS
What is this project about?
Visit the General Questions section to find out who we are, what the project is about and what we measure.
What exactly is the sensor?
General information about the sensor – what it is, the data it broadcasts, the connectivity in your house in the “About your station – General” section.
How can I participate?
To find out about the different ways of participating and how this works, visit the “About Your Participation” section.
Technical questions about the station
Only for the advanced – if you want to find out about the software code and more, check in the “About Your Station – Technical” section.
GENERAL QUESTIONS
Who are you?
The AirBG.info project was launched on April 5, 2017, founded by Nikolay Luchev and Stefan Dimitrov and is part of the global project Luftdaten.info, which started in Stuttgart in 2015.
What is this project about? What are its aims?
This is an independent civil project aimed at bringing more light to these :
– gasification of settlements;
– excessive contamination with PM;
– missing or insufficient measurement of air quality by the authorities;
– insufficient measures taken by the legislative, municipal and executive authorities.How is this project financed?
Only and exclusively with own funds, donations and voluntary work of the participants as follows:
– sensors, controllers and materials are purchased from the Luftdaten.info headquarters team to avoid import procedures in the EU and to give our colleagues more negotiating power;
– transport to Bulgaria is free of charge from our friends at a logistics company;
– the programming of controllers is done by volunteers
– the assembly of the stations is carried out by the adopters or again by voluntary work of the adopters
– the payment is made by the adopters, it is only for the parts of the particular sensor. We keep notes and keep the receipts for every penny spent, and the cost of one sensor reflects the average cost of the parts for it at the moment of its adoption;
– the transportation of the assembled stations is free of charge thanks to two courier companies;
– sometimes we associate adopters who want to subsidize part of a station with those who can not afford the full cost of a station;Can my organization / company buy more sensors and install them on its sites?
You may, but in order to comply with the requirements of the Law, the organization / company should itself acquire the parts for the sensors. The shopping instructions are posted in the “Adopt a Sensor” section. You could also visit our meetings with adopters to help you assemble your sensors. If you find this complicated, show interest as individuals – adopters.
Will there be other projects?
Yes, there will be. Please follow this website in the “News” and “About the project” sections.
What are these sensors?
As of April 2017, the sensor stations were made with:
– NodeMCU ESP8266, CPU / WLAN controller
– FPM sensor for NodeMCU ESP8266, CPU / WLAN
– Atmospheric pressure, temperature and humidity sensor BME280
These parts are connected and placed in two “Marley Silent HT-Bogen” sewer pipesWhat do these sensors measure today?
They measure PM10 и PM2.5, atmospheric pressure, temperature and humidity.
What do PM10 and PM2.5 mean?
Get to know this Wikipedia page: https://en.wikipedia.org/wiki/Particulates
What are the PM10 and PM2.5 standards?
European PM standarts: http://ec.europa.eu/environment/air/quality/standards.htm
How reliable are the sensor results?
We are aware that the results can not be identical to those of the professional measuring sensors, which cost hundreds of thousands of euros, but the data from these sensors are believed to be sufficiently reliable by the German media as well as the legislative, municipal and executive Power in Germany. We expect this data to be used and recognized by the scientific community and the authorities in your country.
How do I view data from all sensors on a geographic map?
You can access the world map on: http://maps.luftdaten.info/
How do I access data from all the sensors?
– You can find the data on all stations in * .csv format on http://archive.luftdaten.info/
– We provide data from the registered stations as JSON files, which are updated every minute.
– All sensor values in the last 5 minutes -> http://api.luftdaten.info/static/v1/data.json
– Values from the last 5 minutes of a particular sensor -> http://api.luftdaten.info/v1/sensor/sensorid/
– For FHEM there is a module (“Beta”), on which you can read you own sensor’s data: https://forum.fhem.de/index.php/topic,66674.msg615105.html#msg615105
What are the sensors planned to measure in the future?
– CO (Carbon monoxide) https://en.wikipedia.org/wiki/Carbon_monoxide
– NO2 (Nitrogen dioxide) https://en.wikipedia.org/wiki/Nitrogen_dioxide
– SO2 (Sulfur dioxide) https://en.wikipedia.org/wiki/Sulfur_dioxideHow can I help this project?
– Becoming a adopter of a sensor station, please fill in the form “Claim your interest”
– Becoming an Apostle (expect a special form soon)
– As a donor (expect a special form soon)How can I become an Apostle of this project?
By requesting and confirming your interest via a special form (coming soon)
ABOUT YOUR PARTICIPATION
How can I become an adopter of a sensor station?
– Please fill out the “Claim interest” form;
– Please wait patiently for your turn;
– Depending on the order:
– you will get it assembled, by courier, install it and send us a completed assembly form;
– – you will assemble it yourself, install it and send us a completed assembly form.How do I register / subscribe for a sensor station adoption?
On this page, in the “claim interest” form.How much does a sensor station cost?
Approximately 40 euro for the standard configuration – as of April 2017. The price varies depending on:
– the dollar exchange rate;
– the agreed price of our luftdaten.info partners for the batch.Includes the price for sensors, controllers and stationary materials. The rest is voluntary work and delivery.
How do I pay for the sensor station?
– When recieving the sensor from the courier.
– In cash, if you have a confirmed order number, in return of a receipt with your two names.How can I get the sensor station?
You can get it by courier.
What data is required to show my sensor station on the map?
The data that you will send us claiming interest, as well as the additional data once you install the station.
Can I order parts myself and assemble my own sensor station?
You can order them yourself from the links in the “Make Your Station” section. You should know that paying the trader and import formalities in the EU will be your concern and risk. You can then assemble it yourself according to the instructions on this page and then send us the completed assembly form. If you have done everything right, your sensor station will show up on the map. ни изпратите при заявка на интерес, както и допълнителните данни, след като инсталирате станцията.
Why shouldn’t I give my information beyond the official registration form of this page?
The privacy of your personal data is of big importance. We advise you not to state anywhere else your sensor station’s address, your email address, and your phone number as well as your two names, except in the official form.
I have another kind of measuring station. How do I get involved in the project?
Unfortunately, our partners at Luftdaten.info do not have such a technical possibility. We encourage you to look for a project where it can be included or start your own.
Why don’t you accept sensor stations made with other technologies, sensors or other software codes?
Unfortunately, our partners at Luftdaten.info have no technical option to include them.
ABOUT YOUR SENSOR – GENERAL
Какви сензори и What sensors do you use?
– NodeMCU ESP8266 controller, CPU/WLAN
– PM sensor NodeMCU ESP8266, CPU/WLAN
– Atmospheric pressure, temperature and humidity sensor BMЕ280How much electricity does the sensor spend?
1W x 24 hours x 365 days / 1000 = 8,76 kWh
How much WiFi internet traffic goes into the station?
The ESP8266 controller sends very little data in text format (sensor ID, time, and 4 sensor data types), in total – up to a few megabytes per year.
Why should the sensor station be constantly connected to WiFi?
WiFi should be plugged in with an internet connection at any time because NodeMCU ESP8266, CPU / WLAN does not have a RAM. If you disconnect the WiFi connection, your sensor data will not be transmitted, displayed, and saved.
ABOUT YOUR SENSOR – TECHNICAL
How do I get into the station controller and manage / change the settings?
If the sensor has established a Wi-Fi connection, you can only connect through the network. As an address, you can use the IP address of the sensor that you will find by logging into your home router.
Alternatively, the sensor supports access to http://feinstaubsensor-{sensorID}.local/. Where sensorID is your individual number with which you registered your sensor with us.
This address is not supported by any operating system without additional software! It should work seamlessly under MacOS, Linux (via Avahi service) and current versions of Windows 10. If Apple iTunes or Skype are installed, it also works under Windows 7. With Apple’s https://support.apple.com/kb/DL999?locale=de_DE , you install only one 5MB file and then you can access the address.
How do I see the program code of the controller, API server, and map?
The sensor’s Firmware: https://github.com/opendata-stuttgart/sensors-software/
You can find the API software at: api.luftdaten.info: https://github.com/opendata-stuttgart/feinstaub-api
The software on the map can be found on: maps.luftdaten.info: https://github.com/opendata-stuttgart/feinstaub-map
How can I access other data from my sensor station?
Data from the last 5 minutes of a particular sensor -> http://api.luftdaten.info/v1/sensor/sensorid/ , where sensorID = the individual sensor station number you got when submitting confirmation from us
How can I access other data from all stations?
You can find the data from all the sensor stations in * .csv format at https://archive.sensor.community/
How do I mount the station?
Make sure the station:
– is fixed and stable;
– it is not installed in a closed room;
– is not exposed to direct sunlight;
– is not on the inside of the balcony and has enough free space below it;
– do not smoke nearby, do not prepare a grill nearby;
– no close incidental household pollutants.How to register the station?
After you assemble your adopted station in one of the labs, we will give you an address to register it with. If you have purchased parts yourself and assembled your station, you will need to send us its ID, coordinates and installation photos at hq@airbg.info.
You can also register your station directly at the following address – https://devices.sensor.community/. Beforehand, make sure your station is operational and meets the assembly and installation requirements.
Troubleshooting Guide
Important requirements:
- Never press the Reset and Flash buttons on the controller. This may delete the controller’s pre-recorded firmware.
- Do not apply force to the pins of the controller. Their distortion or breakage will make the station unusable
- You received a broken station by courier.
– Shoot a broken station
– Send by courier back to the foundation, remembering to note the shipment number you received the station with and the station ID. - After initially turning on, you do not see the station, despite the urgent search and scan for available networks. – Possible cause and remedy:
– Malfunctioning power supply unit – Replace with an available power supply or battery with a USB output and a power rating of at least 1A. After connecting the station to the network, make sure that there is a hum from the fan rotation of the PM sensor. If the buzz is heard, the station should be visible.
– Malfunctioning power cord – Replace the power cord with the available USB port and micro USB port. After connecting the station to the network, make sure that there is a hum from the fan rotation of the PM sensor. If the buzz is heard, the station should be visible.
– There is a fault in the controller – open the station (when off) and check that the blue diode of the controller flashes 3 times when switched on and then goes out. If it does not flash and you have checked everything described above, the fault is in the controller. If it is blinking, then the controller may flash.
– The station has already connected to a previously entered network – Check at the following addresses whether the station is broadcasting.
https://www.madavi.de/sensor/graph.php?sensor=esp8266- NUMBER-bme280
https://www.madavi.de/sensor/graph.php?sensor=esp8266- NUMBER-sds011
(Replace the NUMBER with your station ID.)Wait for 3 minutes, then check that there are values in the charts of the specified addresses. If there are values, it is likely that the station has connected to any available network that was previously introduced. If there are no values, the station does not broadcast.
3. After connecting the station to the home network, one of the sensors at one of the following addresses is not visible:
https://www.madavi.de/sensor/graph.php?sensor=esp8266- NUMBER-bme280
https://www.madavi.de/sensor/graph.php?sensor=esp8266- NUMBER-sds011
(Replace the NUMBER with your station ID.)Possible cause and remedy:
– Sensor cable connections disconnected – check that no sensor or controller cable has been disconnected. If necessary, remove and re-insert the cables into the pins of the sensor and controller.
– Sensor cable connections broken – If the cable connections are pulled out when shaking any of the controller or sensor pins, then rotate the cable 90 g or replace it with a new one.
– Incorrect station configuration – Enter station settings and check for ticks in front of both SDS011 and BME280 sensors. There should be no ticks in front of the other sensors.
– Sensor cold soldering – Inspect the BME280 sensor for possible cold soldering. If possible, remove it.4. The PMS sensor – SDS011 shows very high values. – Possible cause and remedy:
A. Clogging the sensor from dust or other particles – remove the hose and try blowing the sensor with air. If the sensor’s operating mode does not change then, it may be necessary to replace the sensor.
B. Defective or poorly calibrated sensor. – Sensor replacement required.5. PMS Sensor – SDS011 shows very low values. – Possible cause and remedy:
A. Clogging of the sensor by bugs, solid objects, etc. Remove the sensor hose and flush it. Check the airflow of the sensor for a bug or particle to block the fan and the airflow.
B. Defective or poorly calibrated sensor. – Sensor replacement required.6. The BME280 atmospheric sensor does not display normal values. – Possible cause and remedy:
A. Sensor cold soldering – Inspect the BME280 sensor for possible cold soldering. If possible, remove it.
B. Defective or poorly calibrated sensor. – Sensor replacement required.7. Connection after entering the wrong password on the home WIFI network.
A. Turn off the station.
B. Turn off the router to which the password is incorrect.
C. Make your second Hotspot (WIFI hotspot) with an elementary password. For Android, HotSpot is about the features of “providing connections and networks.” Remember the password.
D. Turn on the station again. It will start broadcasting the Feinstaubsensor-NUMBER (because the last router is missing).
E. Connect using the first telephone to the Hotspot station – Observe point I of this instruction. When the second phone shows that a device is already tied to it, stop it (the second phone)!
F. Turn on the router again.
G. Restart the station. It will remember the Hotspot, but it is gone because you stopped the second phone8. How to perform annual station maintenance:
Usually the annual maintenance of the station is carried out before the start of the heating season. See in detail the procedure for performing it.9. How to check / diagnose the station?
1. Online check
- Do they see data online (madavi API)?
- https://www.madavi.de/sensor/graph.php?sensor=esp8266-[ID]-[sensortyp]
- You can also search for [ID] in the text at https://www.madavi.de/sensor/graph.php or here: https://stats.sensor.community/scripts/firmware_versions.php
- Is the sensor registered at https://devices.sensor.community/ and sending data to the main API (map visibility)?
- See if the WiFi signal level was a little low / desirable to be above 30%:
- Here’s the server-side log: https://www.madavi.de/sensor/signal.php?sensor=esp8266- [ID]
- https://www.madavi.de/sensor/graph.php?sensor=esp8266-[ID]-[sensortyp]
2. USB Cable Check – Advanced only!
- Check the power: USB cable – Make sure it is not interrupted anywhere, especially where it passes between window frames or doors. If possible, try another USB cable.
- Restart (power outage, eg pull the USB plug)
- Is the WLAN configuration good (the sensor connects to the configured WLAN)? If not:
- Does the sensor open the AP (in the first 2-7 minutes after restart)?
- Search for WLAN airrohr- [ID]. Patience may take 1-2 minutes after the restart.
alternatively you can use the Discovery mode of the Flasher app. - Check on your own router that the sensor is registered to the network, then find the IP address of the station. This step is performed only after the initial connection of the station to the router.
- If registered: connect to IP through browser http: // [IP] /. The interface should appear there.
- If not: ESP has problems, e.g. power is not enough, continuous restart, incorrect network password, or the like.
- Connect the USB to your computer and browse the log there. This step is possible at any time after the initial flash of the controller.
- Serial Interface Text Tracking with Serial Terminal Program (Settings: baud 9600, 8N1)
- for Linux: screen, minicom, cutecom;
- for Windows: Tera Term, PuTTY;
- for macOS: screen, minicom, Serial, …
- Appropriate USB drivers may be required, see https://github.com/opendata-stuttgart/meta/wiki/Firmware-einspielnen
- There you should be able to see what the sensor does (charging messages, WiFi connection or AP, measurement – only in 3 minutes)
- Serial Interface Text Tracking with Serial Terminal Program (Settings: baud 9600, 8N1)
3. Regarding electronics:
- Remove the sensor electronics from the chassis and monitor after the power is connected.
- Check / replace the power supply again
- Does ESP blink shortly after restart? – If it does not flash – ESP may be damaged.
- Does the SDS011: red LED / fan turn on / briefly after restart? – Check the connection for disconnected cable. Check the wiring diagram.
- Check / replace the cables to the sensors.