Skip to content

Citizen KitLink

Quick links

πŸš€ Installation: onboarding.iscape.smartcitizen.me

🌍 Platform: smartcitizen.me

❓ Support: support@smartcitizen.me

🎁 The KitLink

The iSCAPE Citizen Kit is based on the Smart Citizen Kit 2.0.

  1. Smart Citizen Kit 2.0 with particle sensor and battery with two mounting brackets.
  2. MicroSD card and microSD adapter to SD.
  3. USB cable and a USB charger to charge the battery.

πŸ‘‚ MeasurementsLink

Measurements Units Sensors
Air temperature ΒΊC Sensirion SHT-31
Relative Humidity % REL Sensirion SHT-31
Noise level dBA Invensense ICS-434342
Ambient light Lux Rohm BH1721FVC
Barometric pressure Pa NXP MPL3115A26
Particulate Matter PM ½.5/10 Β΅g/m3 PMS 7003

πŸ““ InstructionsLink

The sensor comes mounted and almost ready to be used

The only thing we should do is connect the battery. The kit will light in red and we will be able to configure it by following the instructions at onboarding.iscape.smartcitizen.me.

After the configuration your data will be available on the SmartCitizen platform. You can explore the data there or download it using the CSV Download option.

πŸ”‹ AutonomyLink

The kit has a battery life of 12 hours. For long exposures, we can permanently connect to the USB.

When we no longer want to publish or save more data for a few days we can turn off the kit. To do this, press the button for 5 seconds.

If the colors of the LED appear orange indicates that the battery must be charged.

The battery takes about 4 hours to fully charge. When the battery is fully charged, change the orange to green .

Remember that in addition to the colors you will have the state color of the kit: configuration, network and sd.

🚩 States of the KitLink

The buttonLink

Function Button Action
ON Push the button
OFF Push the button for 5 seconds
CHANGE MODE Push the button multiple times to choose: Setup Wi-Fi Pink
FACTORY RESET Push the button 15 seconds for a full reset

Operation modesLink

Setup modeLink

In this mode, the Kit is ready to be configured in network mode or SD card in onboarding.iscape.smartcitizen.me.

LED color Kit status
πŸ‘ Ready to be setup
πŸ”‹ Ready to be setup but battery is low, charge the Kit
πŸ”‹ Ready to be setup, battery charging
πŸ”‹ Ready to be setup, battery charged

Wi-Fi modeLink

This is the standard mode for a network that requires a Wi-Fi connection. In this way, the device will publish the data every minute on the smartcitizen.me platform. If there is an inserted micro SD card, the data will be stored in duplicate.

LED color Kit status
πŸ‘ Collecting data online
⚠ Error while collecting data
πŸ”‹ Collecting data online but battery is low, charge the Kit
πŸ”‹ Collecting data online, battery charging
πŸ”‹ Collecting data online, battery charged

Warning

βœ… The kit supports Wi-Fi WEP, WPA/WPA2 and open networks that are common networks in domestic environments and small businesses.

❎ But, 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 card mode (offline)Link

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 data can be visually spaced in a spreadsheet but also published on the smartcitizen.me platform using the UPLOAD CSV option.

LED color Kit status
πŸ‘ Collecting data offline
⚠ Error while collecting data
πŸ”‹ Collecting data offline but battery is low, charge the Kit
πŸ”‹ Collecting data offline, battery charging
πŸ”‹ Collecting data offline, battery charged

Especial statusLink

LED color Kit status
⏳ Busy, please wait!
πŸ”§ Software update going on!

β˜” Build your own enclosureLink

Warning

Keep in mind that casing is designed for short outdoor deployments. If you want a case for long exhibitions abroad, we will soon have a much more rugged enclosure ready!

Step by step

1.Use scissors to cut an empty plastic bottle at about 12 cm from the top

2.Use the rubber band to fix it using the bottle cap

3.Place the Kit inside and use the rubber band to hold it

4.You have now a simple enclosure to use your Kit outdoors for short measurement periods!

You can now install the sensor outdoors!

πŸ‘· TroubleshootingLink

Before setupLink

Before configuring the Kit setup make sure the LED is red. If not, press the button multiple times until the LED turns red.

The kit does not respondLink

If the kit does not respond or does not work properly you can do two things:

Reboot your Kit

You can fully reboot your Kit by pressing the reset button located under the sensors board as seen on the picture. That will not delete any configuration, it will simply restart your device. Press the RESET button for a second. The light will go off and on and the device will start again.

You can also perform a reboot by disconnecting the battery and the USB cable so that the kit is restarted. In this way we will not lose any data and configuration except the time in case of being in SD mode.

Factory reset your Kit

You can fully reset the Kit to the default settings so you can register again your device. Press the main button for 15 seconds.

After 5 seconds the light will go off and will go on again after 15 seconds. Then you can release the button and your device will be fully resetted as a brand new Kit.

The LED does not turn on and the kit does not workLink

First of all, push the kit button. Maybe it's simply off.

If this does not work, surely the kit has been left without battery. You will have to charge it using the USB charger. Any other mobile charger will also work.

We will know that it is charging when the LED emits orange pulses and once the battery is charged it will emit green

The kit does not store the data on the SD card.Link

Some SD cards may have problems over time. We can try formatting it but in case it does not work any micro SD card we buy at any mobile or computer store it will work. The size is not important and any micro SD or micro SDHC 512MB card up to 32GB will work.

CSV UploadLink

Here some instructions on how to upload CSV files to Smartcitizen platform. First be sure to be logged and go to your profile.

On your kits' list, click on the wheel and then on Upload CSV.

Once on the upload page, you can add some files by clicking on the Load CSV files button.

Select some files as much as you like, to be them ready to upload. Then on the drop-down menu select the Upload option

Click on the Apply button to upload them

Congrats! You just uploaded your files CSV files on the Smartcitizen platform.

Technical specsLink

The Citizen Kit, formerly known as the Low-Cost Sensor, is aimed at providing a low-cost environmental sensor solution non-technical users can easily deploy. The design developed for the project is a complete reiteration of the Smart Citizen Kit, a piece of hardware for citizen sensing already tested in other projects for more than five years. On this iteration, new sensors had been added, and all the electronic design has been redone from the ground up to improve the data accuracy and reduce the manufacturing costs.

ComponentsLink

The design is built around two boards the Smart Citizen Data Board and the Smart Citizen Urban Sensor Board. The first board contains the data acquisition, the power management, and the communication unit. The second contains a set of sensors aimed at the outdoor urban environment including: Air Temperature, Relative Humidity, Noise Level, Ambient Light and Barometric Pressure. The board also features a section especially focused on Air Quality including a Air Particles, a Carbon Monoxide, and a Nitrogen Dioxide detectors. This sensor while not capable of offering precise measurements can be used to understand the behavior of different urban locations especially when they are calibrated on the field using certified equipment. Both boards are later described in detail on the Sensor Components section.

Citizen Kits Components Setup

Learn more

Learn more about all the components and the software inside the kit in the Components documentation section.

Software UpdatesLink

The SCK 2.0 has two components that need periodic updates. The SCK 2.0 appears as a USB Storage device and the new firmware can be installed on your kit by simply downloading the new firmware release and then dragging and dropping into the SCK 2.0 device root folder. The Wi-Fi module firmware is updated automatically over-the-air every time the main processor firmware is updated.

Firmware updates

Update the Firmware

DimensionsLink

  • Dimensions: 60 x 60 x 20 mm (approx.)
  • Dimensions w/ enclosure: 110 x 110 x 50mm (approx.)
  • Weight: 65 gr.
  • Weight w/ enclosure: 160 gr.

Power ManagementLink

Battery lifetimeLink

The SCK 2.0 comes with a 2000mAh LiPo battery. The battery is meant to be a complete power option for short-term measurements and a backup solution when the kit it is used for long periods. The battery lifetime lifetime is dependent on which sensors are enabled or disabled:

  • All sensors publishing over Wi-Fi: 12 hrs.
  • All sensors publishing on SD card: 13 hrs.
  • Without air quality sensors over Wi-Fi: 10 days
  • Without air quality sensors on SD card: 25 days

Battery chargingLink

The SCK 2.0 has a micro USB port and can be charged like any Smartphone or Tablet using a dedicated adapter or a computer USB port. We recommend using a tablet power adaptor, instead of a computer USB port, for quicker charging. Autonomy can be extended by using a Power Bank, a 5V PV Panel, or with a through-glass induction charger (currently under development).