The Package contains three types of devices:
The image below shows the indoor devices:
And the outdoor one:
Important note
Below you can see the components:
In case of issues while collecting data, the device LED will likely show a weird behaviour (frozen in one color, for instance). For examples of normal behaviours, visit: https://docs.smartcitizen.me/Smart Citizen Kit/#operation-modes
You can reset the kit by inserting a pin or a small screw driver on the Reset button hole from the photos above.
This guide details the necessary information and instructions for the devices configuration and deployment (both indoor and outdoor).
The guide provides the detailed steps for the users who want to register the devices by themselves. If you requested the registration process done by Fab Lab Barcellona, you can skip those steps.
Important
The device will not work reliably without the provided LiPo battery connected permanently.
There are two buttons on the Device: the on/off
button and the reset
button:
TheON/OFF
button is located here:
The ON/OFF
button is used for:
If the device runs out of battery, you generally can simply plug it in. If the device's battery is completely drained, you will need to click the ON/OFF
button after 5' of charging the battery.
The reset
button, is located here:
You only need to use this button if to reset the device. It's the best option if you get a notification when the device stops publishing data.
Check the LED colors in: https://docs.smartcitizen.me/Smart Citizen Kit/#operation-modes
There are only two possibilities for the device to placed: laterally or vertically.
The device should never be placed horizontally (wide side flat on a surface). This placement would cover completely the sensor inlets, or leave them exposed to dust accumulation. Likewise, the sensors, do not work properly on this configuration.
The outdoor sensors are deployed as below:
Note the slots on the cover to pass zip-ties, screws or other elements to hold the device
All devices: visit the onboarding app at start.smartcitizen.me. The onboarding app at will guide through the process of configuring the device. You will need to repeat the process for as many devices as you have.
Before you start make sure you have:
Make sure that, if you register the device on your own, the device name is as provided in the table via email, with the following format:
SITE_BUILDING_ROOM_#MAC
As an example:
ETR_MAIN_1_#DF81
You can find this information in the provided materials via email.
Always use the same user for registering all TwinAIR devices.
Do not change the name of the device once it has been agreed with IAAC.
The easiest way to enable notifications is to visit your device on the website and click on theEDIT button
on the bottom part of the graphs
Then, scroll down to the notifications section and enable both. This will trigger an email in case the device stops publishing.
This step is crucial to ensure that, in the event of sensor malfunction, we can act as fast as possible to data loss. Since TwinAIR project relies heavily on this data, we encourage and appreciate if the pilot contact points can support on this matter.
The easiest way to enable forwarding is to visit your device on the website and click on theEDIT button
on the bottom part of the graphs
Then, scroll down to the forwarding section and enable the checkbox. Make sure all the other settings are shown as in the image below:
If you do not see this, please contact Fab Lab.
Sensor Pack #2 requires handling of calibration data. For this reason, it's necessary to store the physical ID (Station ID
or Hardware ID
) of the unit alongside to the virtual device in the Smart Citizen Platform. The hardware ID should normally be in a sticker to the enclosure both inside and outside and looks like this:
Station ID
Station ID
is safely stored in the platform's deviceThis hardware ID is not the same as the device ID
. The device ID
is the number you have after the smartcitizen.me/kits/ url where you see the data of your device. The Station ID
is the one in the sticker. The Station ID
is not meant to change, while the device ID
can change as you can register your kit many times!
EDIT button
on the bottom part of the graphshardware URL
field, introduce the number in the sticker (it should be something like SCAS2200XX
)<DEVICE-ID>
is correct): https://api.smartcitizen.me/v0/devices/<DEVICE-ID>/
After this, we will take care of processing the data in a periodic way.
All devices comes with USB cable and an adapter with an additional 2000mAh LiPo battery. The SCK has a micro USB port and can be charged like any smartphone or tablet using a dedicated adapter or a computer USB port.
Battery characteristics can be found in the following link:
https://docs.smartcitizen.me/_FAQ/#what-batteries-are-shipped-with-the-kits
Wi-Fi Mode (online)
This is the standard mode and requires a Wi-Fi connection. In this way, the device will publish data every minute (time resolution can be configured) on the smartcitizen.me platform. If a micro SD card is inserted, the data will be stored in duplicate as a backup.
The kit supports Wi-Fi WEP, WPA/WPA2 and open networks, those the standard Wi-Fi networks found in domestic and small businesses environments. However, it does not support WPA/WPA2 Enterprise networks such as EDUROAM or networks with captive portals such as those found in Airports and Hotels.
SD Mode (offline)
If we do not have an internet connection, we can use the SD mode. In this case, the device will record the data on the micro SD card. Later we can read the card using a card reader. The recorded data can be visually explored in a spreadsheet but also published on the platform utilising the UPLOAD CSV option.
Limitations
While on SD-card mode, the device needs constant power (either USB or battery).