Update on boards

docs/hardware/boards/analog-sensor-board.md

@@ -1,21 +1,34 @@
 ---
-type: core
-feature_img: None
-status: stable
-versions: None
-interface: None
+internal:
+  writing: false
+  proofread: false
+  links: false
+  images: false
 ---
 
 # Analog Sensor Board
 
 The SmartCitizen Analog Sensor Board (_ASB_) is an expansion board for the Smart Citizen Kit that provides connectivity to analog sensors with a high precission ADC (Texas ADS1115) via I2C, with four configurable addresses. It also gives the possibility to directly hook up [this ADC by Adafruit](https://www.adafruit.com/product/1085).
 
-![](/assets/images/asb4ch.jpg)
+<img style="max-height: 350px; width: 100%; object-fit: cover;" src="https://live.staticflickr.com/65535/53968621883_5c4f1ab625_k.jpg" alt="Analog-Sensor-Board-front-b"/>
 
-We use it to measure low power sensors such as the Alphasense Ltd. electrochemical sensors.
+We use it to measure low power sensors such as the Alphasense Ltd. electrochemical sensors, or SPEC sensors. You can use it in different configurations and the different headers:
+
+![](/assets/images/asb-socket-options.png)
+
+Below you see a comparison:
+
+=== "B-series sensors"
+    <img src="https://live.staticflickr.com/65535/53968621883_5819b0379c_h.jpg" alt="Analog-Sensor-Board-front-b"/>
+=== "A-series sensors"
+    <img src="https://live.staticflickr.com/65535/53968379046_ab50fd93bd_h.jpg" alt="Analog-Sensor-Board-front-a"/>
+=== "Empty"
+    <img src="https://live.staticflickr.com/65535/53968710279_06c66e72e6_h.jpg" alt="Analog-Sensor-Board-front-empty"/>
 
 ## Characteristics
 
+![](/assets/images/asb-diagram.png){:style="width: 500px"}
+
 ### Operating voltage
 
 Natively operates at 3.3V, but can use also up to 5.5V in EXT-V, and with a selectable jumper. It integrates a level-shifter from the GROVE connector's voltage to EXT-V.

docs/hardware/boards/data-board.md

@@ -1,8 +1,14 @@
-<!-- TODO - Fix versions and add microcontrollers -->
+---
+internal:
+  writing: false
+  proofread: false
+  links: false
+  images: false
+---
 
 # Data Board
 
-The Data Board is a data-logger at the core of the sensors architecture supporting the Smart Citizen Kit and the Smart Citizen Station. This module is powered by an ARM M0+ 32-bits 48Mhz **SAMD21** running the [Smart Citizen Firmware](/Components/Firmware), combining the low power consumption of the ARM M0 family with the power of a 32-bits processor with 32KB of RAM and 256KB of FLASH memory. This solution offers enough program storage and memory space to support multiple auxiliary sensors. This chip is used by the Arduino Zero and MKR boards, therefore benefiting from the open community built around these boards in particular and the Arduino project in general.
+The Data Board is a data-logger at the core of the sensors architecture supporting the Smart Citizen Kit and the Smart Citizen Station. This module is powered by an ARM M0+ 32-bits 48Mhz **SAMD21** running the [Smart Citizen Firmware](/docs/hardware/firmware/), combining the low power consumption of the ARM M0 family with the power of a 32-bits processor with 32KB of RAM and 256KB of FLASH memory. This solution offers enough program storage and memory space to support multiple auxiliary sensors. This chip is used by the Arduino Zero and MKR boards, therefore benefiting from the open community built around these boards in particular and the Arduino project in general.
 
 === "SCK2.3"
     <img style="max-height: 325px; width: 100%; object-fit: cover;" src="https://live.staticflickr.com/65535/54281911435_c1ae473a74_o.jpg" alt="SCK2.3 Data Board"/>
@@ -17,19 +23,25 @@ The Data Board also includes a Wi-Fi module, a micro SD card slot, an internal F
 
 ## Microcontrollers
 
-![](/assets/images/sck-mcus.png)
+![](/assets/images/data-board-mcus.png){:style="width: 500px"}
 
 The Data Board connects to the sensor board providing power, analog and digital communications (12 bits ADC, GPIO, I2C, I2S, VCC). The Data Board also includes a Seeed Studio standard Grove connector where off-the-shelf modules from the same manufacturer can be connected. The connector supports an independent I2C bus by default, but by software it can be configured to support other uses (GPIO, I2C and UART). It can supply power up to 750mA, and it can be enabled or disabled by software to save power.
 
+![](/assets/images/data-board-connectors.png){:style="width: 500px"}
+
 The board includes a power unit, with a battery management system, capable of handling a variety of Lithium polymer cells. The batteries are connected to a standard JST-2 pin battery connector. The Smart Citizen Kit by default uses a 2000mAh battery, but larger capacities can be used. Under normal conditions, and depending on the sensors enabled, a 2000mAh battery can last between 24 hours (with all sensors enabled, and a 1-minute recording frequency) to more than a week. The board also features a _sleep mode_, through which drastically lower average consumption are achieved.
 
 The controller allows the batteries to be easily charged using the boards micro USB connector using any standard USB power adapter like the ones used on Smartphones. On remote areas, it can also be powered using a selection of PV Panels like [Voltaics Systems](https://www.voltaicsystems.com/) 6W panel.
 
+![](/assets/images/data-board-connectors-power.png){:style="width: 500px"}
+
+TODO - Leds, buttons...
+
 ## Firmware
 
-The Smart Citizen Kit firmware is comprised of two parts: 
+The Smart Citizen Kit firmware is made out of two parts:
 
-1. the primary processing tasks are done by the SAMD21 microcontroller firmware; 
+1. the primary processing tasks are done by the SAMD21 microcontroller firmware;
 2. the tasks related to network communication are run through the ESP8266.
 
 The SAMD21 is built on top of the Arduino Zero with a custom variant for the Data Board main MCU. The ESP8266 is also built using the Arduino ESP Core. Both firmwares are built and managed with Platform IO, an open-source IDE for embedded development. Platform IO features built-in dependency management and allows you to compile and upload both processors with a single command. Using the SWD ARM connector you can change the MCU bootloader and debug the firmware using Open Source tools.
@@ -51,21 +63,14 @@ The SAMD21 is built on top of the Arduino Zero with a custom variant for the Dat
 
 The Kit features a modular architecture where sensors can be updated independently by replacing any individual Sensor Board. The Sensor Boards features GPIO, ADC, I2C, UART and I2S connections at 3.3V. Currently, we only offer the Urban Sensor Board, but more boards are on the way, and you can even design and build a custom one.
 
-!!! info "Example of a Sensor Board"
-	This is the V2.0 Urban Board example.
-    ![](/assets/images/sck-connection.png)
-
 Here there is a pinout of the Data Board connector:
 
-![](/assets/images/data-board-pinout.png)
+![](/assets/images/data-board-pinout.png){:style="width: 500px"}
 
 ### Auxiliary connector
 
 The Data Board features and independent configurable auxiliary bus at 3.3V with a SEEED Studio Grove connector. The Bus has native support for I2C, but it can also be setup on firmware as a GPIO or UART port. It can supply power up to 750mA, and it can be enabled or disabled by software.
 
-!!! info "Example of devices connected via the **AUX connector.**"
-	![](/assets/images/station-components.jpg)
-
 ## Power management
 
 The Smart Smart Citizen Kit gives us the possibility of running directly from a USB power source with or without lithium battery, using the [BQ24259 USB Charger](/assets/datasheets/components/bq24259.pdf). The charger manages external power regulation, battery fast charging (up to 2Ah) and USB OTG that allow us powering other devices from the SCK (currently not implemented).

docs/hardware/boards/urban-board.md

@@ -1,9 +1,9 @@
 ---
-type: core
-feature_img: None
-status: stable
-versions: None
-interface: None
+internal:
+  writing: false
+  proofread: false
+  links: false
+  images: false
 ---
 
 # Urban Board
@@ -34,19 +34,15 @@ The Urban Board connects to the [Data Board](/hardware/boards/data-board/) with
 
 ![](/assets/images/sck-connection.png)
 
+### PM sensor
+
+=== "SCK2.3/2.2"
+    ![](/assets/urban-board-sen5x.png)
+=== "SCK2.1"
+    TODO
+
 ## Measurements
 
-<!-- === "SCK 2.0"
-    | Measurement                                  | Units                                          | Sensor                |
-    |----------------------------------------------|------------------------------------------------|-----------------------|
-    | Air Temperature                              | ºC                                             | Sensirion SHT-31      |
-    | Relative Humidity                            | % REL                                          | Sensirion SHT-31      |
-    | Noise Level and Spectrum                     | dBA, dBC or dBZ                                | Invensense ICS-43432  |
-    | Ambient Light                                | Lux                                            | Rohm BH1721FVC        |
-    | Barometric pressure and AMSL                 | kPa and Meters                                 | NXP MPL3115A2         |
-    | Carbon Monoxide                              | ppm                                            | SGX MICS-4514         |
-    | Nitrogen Dioxide                             | ppb                                            | SGX MICS-4514         |
-    | PM1, PM2.5 and PM10 | µg/m3                                                                   | Plantower PMS5003     | -->
 === "SCK 2.3"
     | Measurement                                  | Units                                          | Sensor                |
     |----------------------------------------------|------------------------------------------------|-----------------------|