# Disconnected CO2 Data Logger
## Overview
Have you ever wondered what the air quality is around you while you're out and about? With this project, you'll be able to monitor CO2 levels and log them, like an IoT device, but without having to worry about connecting to a network. This means you can collect data from places like public transit, concert venues or even on your bike ride.
The SCD-40 STEMMA sensor monitors the true CO2 level of the air. It also has options for temperature and humidity sensing.
A FeatherWing Doubler connects the Feather RP2040 and Adalogger FeatherWing together. The Adalogger FeatherWing takes care of storing the logged data from the SCD-40 on a removeable SD card and keeps time with an onboard real time clock (RTC).
To keep things portable, this project is powered by a LiPoly battery that plugs directly into the Feather RP2040. The circuit includes an on/off switch so that you can choose when to log data and prolong battery life.
## Prerequisite Guides
[Introducing Adafruit Feather RP2040](https://learn.adafruit.com/adafruit-feather-rp2040-pico)
[Adafruit SCD-40 and SCD-41](https://learn.adafruit.com/adafruit-scd-40-and-scd-41)
[Adafruit Adalogger FeatherWing](https://learn.adafruit.com/adafruit-adalogger-featherwing)
## Parts
### Adafruit Feather RP2040
[Adafruit Feather RP2040](https://www.adafruit.com/product/4884)
A new chip means a new Feather, and the Raspberry Pi RP2040 is no exception. When we saw this chip we thought "this chip is going to be awesome when we give it the Feather Treatment" and so we did! This Feather features the **RP2040** , and all niceties you know and...
In Stock
[Buy Now](https://www.adafruit.com/product/4884)
[Related Guides to the Product](https://learn.adafruit.com/products/4884/guides)
### Adalogger FeatherWing - RTC + SD Add-on For All Feather Boards
[Adalogger FeatherWing - RTC + SD Add-on For All Feather Boards](https://www.adafruit.com/product/2922)
A Feather board without ambition is a Feather board without FeatherWings! This is the **Adalogger FeatherWing** : it adds both a battery-backed Real Time Clock and micro SD card storage to any Feather main board. Using our [Feather...](https://www.adafruit.com/products/2830)
Out of Stock
[Buy Now](https://www.adafruit.com/product/2922)
[Related Guides to the Product](https://learn.adafruit.com/products/2922/guides)
### FeatherWing Doubler - Prototyping Add-on For All Feather Boards
[FeatherWing Doubler - Prototyping Add-on For All Feather Boards](https://www.adafruit.com/product/2890)
This is the **FeatherWing Doubler** - a prototyping add-on and more for all Feather boards. This is similar to our [FeatherWing Proto](https://www.adafruit.com/products/2884) except there are two! The magic of the Doubler comes when stacking a Feather and another...
In Stock
[Buy Now](https://www.adafruit.com/product/2890)
[Related Guides to the Product](https://learn.adafruit.com/products/2890/guides)
### Adafruit SCD-40 - True CO2, Temperature and Humidity Sensor
[Adafruit SCD-40 - True CO2, Temperature and Humidity Sensor](https://www.adafruit.com/product/5187)
Take a deep breath in...now slowly breathe out. Mmm isn't it wonderful? All that air around us, which we bring into our lungs, extracts oxygen from and then breathes out carbon dioxide. CO2 is essential for life on this planet we call Earth - we and plants take turns using and...
Out of Stock
[Buy Now](https://www.adafruit.com/product/5187)
[Related Guides to the Product](https://learn.adafruit.com/products/5187/guides)
### STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long
[STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long](https://www.adafruit.com/product/4210)
This 4-wire cable is a little over 100mm / 4" long and fitted with JST-SH female 4-pin connectors on both ends. Compared with the chunkier JST-PH these are 1mm pitch instead of 2mm, but still have a nice latching feel, while being easy to insert and remove.
Out of Stock
[Buy Now](https://www.adafruit.com/product/4210)
[Related Guides to the Product](https://learn.adafruit.com/products/4210/guides)
### CR1220 12mm Diameter - 3V Lithium Coin Cell Battery
[CR1220 12mm Diameter - 3V Lithium Coin Cell Battery](https://www.adafruit.com/product/380)
These are the highest quality & capacity batteries, the same as shipped with the iCufflinks, iNecklace, Datalogging and GPS Shields, GPS HAT, etc. One battery per order (you'll want one battery per cufflink or pendant.)
Brand may vary but all battery brands are verified...
In Stock
[Buy Now](https://www.adafruit.com/product/380)
[Related Guides to the Product](https://learn.adafruit.com/products/380/guides)
### Breadboard-friendly SPDT Slide Switch
[Breadboard-friendly SPDT Slide Switch](https://www.adafruit.com/product/805)
These nice switches are perfect for use with breadboard and perfboard projects. They have 0.1" spacing and snap in nicely into a solderless breadboard. They're easy to switch no matter what size fingers you have, but not so easy that they'll get flipped by accident. Work great as...
In Stock
[Buy Now](https://www.adafruit.com/product/805)
[Related Guides to the Product](https://learn.adafruit.com/products/805/guides)
### Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh
[Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh](https://www.adafruit.com/product/3898)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of **400mAh** for a total of about 1.9 Wh. If you need a larger (or smaller!)...
In Stock
[Buy Now](https://www.adafruit.com/product/3898)
[Related Guides to the Product](https://learn.adafruit.com/products/3898/guides)
# Disconnected CO2 Data Logger
## Circuit Diagram
## Wiring Connections
- Plug the **Feather RP2040** and **Adalogger FeatherWing** into the **FeatherWing Doubler**
- **EN** to **slide switch pin 1**
- **GND** to **slide switch pin 2**
- **SCD-40 STEMMA QT port** to the **Feather RP2040's STEMMA QT port** with a STEMMA QT JST cable
- **LiPoly battery** to the Feather RP2040's LiPoly **battery connector**
# Disconnected CO2 Data Logger
## 3D Printing
The enclosure is a 3D printed, snap fit case that prints with no supports.
It consists of three parts:
- **co2\_topLid**
- **co2\_botLid**
- **co2\_mainBox**
The files can be downloaded directly here or through Thingiverse.
The top and bottom lids are removable to allow for easy access to the SD card and electronics.
[disconnectedCo2DataLogger_STLfiles.zip](https://cdn-learn.adafruit.com/assets/assets/000/105/929/original/disconnectedCo2DataLogger_STLfiles.zip?1635258258)
[STL files on Thingiverse](https://www.thingiverse.com/thing:5030874)
The case has mounting holes for the FeatherWing Doubler and the SCD-40 STEMMA sensor.
There are cutouts for the on/off switch and the Feather RP2040's USB-C port so that you can charge the LiPoly battery or update the code.
# Disconnected CO2 Data Logger
## Install CircuitPython
[CircuitPython](https://github.com/adafruit/circuitpython) is a derivative of [MicroPython](https://micropython.org) designed to simplify experimentation and education on low-cost microcontrollers. It makes it easier than ever to get prototyping by requiring no upfront desktop software downloads. Simply copy and edit files on the **CIRCUITPY** drive to iterate.
## CircuitPython Quickstart
Follow this step-by-step to quickly get CircuitPython running on your board.
[Download the latest version of CircuitPython for this board via circuitpython.org](https://circuitpython.org/board/adafruit_feather_rp2040/)
**Click the link above to download the latest CircuitPython UF2 file.**
Save it wherever is convenient for you.
To enter the bootloader, hold down the **BOOT/**** BOOTSEL button**(highlighted in red above), and while continuing to hold it (don't let go!), press and release the**reset button**(highlighted in red or blue above). **Continue to hold the BOOT/BOOTSEL button until the RPI-RP2 drive appears!**
If the drive does not appear, release all the buttons, and then repeat the process above.
You can also start with your board unplugged from USB, press and hold the BOOTSEL button (highlighted in red above), continue to hold it while plugging it into USB, and wait for the drive to appear before releasing the button.
A lot of people end up using charge-only USB cables and it is very frustrating! **Make sure you have a USB cable you know is good for data sync.**
You will see a new disk drive appear called **RPI-RP2**.
Drag the **adafruit\_circuitpython\_etc.uf2** file to **RPI-RP2.**
The **RPI-RP2** drive will disappear and a new disk drive called **CIRCUITPY** will appear.
That's it, you're done! :)
## Safe Mode
You want to edit your **code.py** or modify the files on your **CIRCUITPY** drive, but find that you can't. Perhaps your board has gotten into a state where **CIRCUITPY** is read-only. You may have turned off the **CIRCUITPY** drive altogether. Whatever the reason, safe mode can help.
Safe mode in CircuitPython does not run any user code on startup, and disables auto-reload. This means a few things. First, safe mode _bypasses any code in_ **boot.py** (where you can set **CIRCUITPY** read-only or turn it off completely). Second, _it does not run the code in_ **code.py**. And finally, _it does not automatically soft-reload when data is written to the_ **CIRCUITPY** _drive_.
Therefore, whatever you may have done to put your board in a non-interactive state, safe mode gives you the opportunity to correct it without losing all of the data on the **CIRCUITPY** drive.
### Entering Safe Mode
To enter safe mode when using CircuitPython, plug in your board or hit reset (highlighted in red above). Immediately after the board starts up or resets, it waits 1000ms. On some boards, the onboard status LED (highlighted in green above) will blink yellow during that time. If you press reset during that 1000ms, the board will start up in safe mode. It can be difficult to react to the yellow LED, so you may want to think of it simply as a slow double click of the reset button. (Remember, a fast double click of reset enters the bootloader.)
### In Safe Mode
If you successfully enter safe mode on CircuitPython, the LED will intermittently blink yellow three times.
If you connect to the serial console, you'll find the following message.
```terminal
Auto-reload is off.
Running in safe mode! Not running saved code.
CircuitPython is in safe mode because you pressed the reset button during boot. Press again to exit safe mode.
Press any key to enter the REPL. Use CTRL-D to reload.
```
You can now edit the contents of the **CIRCUITPY** drive. Remember, _your code will not run until you press the reset button, or unplug and plug in your board, to get out of safe mode._
## Flash Resetting UF2
If your board ever gets into a really _weird_ state and CIRCUITPY doesn't show up as a disk drive after installing CircuitPython, try loading this 'nuke' UF2 to RPI-RP2. which will do a 'deep clean' on your Flash Memory. **You will lose all the files on the board** , but at least you'll be able to revive it! After loading this UF2, follow the steps above to re-install CircuitPython.
[Download flash erasing "nuke" UF2](https://cdn-learn.adafruit.com/assets/assets/000/101/659/original/flash_nuke.uf2?1618945856)
# Disconnected CO2 Data Logger
## Coding the Disconnected CO2 Data Logger
Warning:
[Follow these steps to create the /sd directory](https://learn.adafruit.com/adafruit-memento-camera-board/circuitpython-memento-starter-projects)
Once you've finished setting up your Feather RP2040 with CircuitPython, you can access the code and necessary libraries by downloading the Project Bundle.
To do this, click on the ** Download Project Bundle** button in the window below. It will download as a zipped folder.
https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/Disconnected_CO2_Data_Logger/code.py
## Upload the Code and Libraries to the Feather RP2040
After downloading the Project Bundle, plug your Feather RP2040 into the computer's USB port. You should see a new flash drive appear in the computer's File Explorer or Finder (depending on your operating system) called **CIRCUITPY**. Unzip the folder and copy the following items to the Feather RP2040's **CIRCUITPY** drive.
- **lib** folder
- **code.py**
Your Feather RP2040 **CIRCUITPY ** drive should look like this after copying the **lib** folder and the **code.py** file.
## How the CircuitPython Code Works
The SCD-40 and RTC are controlled over I2C. The SCD-40 begins measuring CO2 levels with `start_periodic_measurement()`.
```python
# setup for I2C
i2c = board.I2C()
# setup for SCD40
scd4x = adafruit_scd4x.SCD4X(i2c)
# setup for RTC
rtc = adafruit_pcf8523.PCF8523(i2c)
# start measuring co2 with SCD40
scd4x.start_periodic_measurement()
```
The SD card is accessed using SPI. `board.D10` is used for the `SD_CS` pin on the RP2040 boards.
```python
# SPI SD_CS pin
SD_CS = board.D10
# SPI setup for SD card
spi = busio.SPI(board.SCK, board.MOSI, board.MISO)
sdcard = sdcardio.SDCard(spi, SD_CS)
vfs = storage.VfsFat(sdcard)
try:
storage.mount(vfs, "/sd")
print("sd card mounted")
except ValueError:
print("no SD card")
```
### Set the Time
The RTC is set using the `set_clock` variable. If `set_clock` is `True`, then the date and time is set to reflect what is entered in the `time.struct_time()` function. If `set_clock` is `False`, then the RTC is not reset.
```python
# to update the RTC, change set_clock to True
# otherwise RTC will remain set
# it should only be needed after the initial set
# if you've removed the coincell battery
set_clock = False
if set_clock:
# year, mon, date, hour, min, sec, wday, yday, isdst
t = time.struct_time((2021, 10, 31, 00, 00, 00, 0, -1, -1))
print("Setting time to:", t)
rtc.datetime = t
print()
```
### Write Data
Before the loop, some data is written to the SD card's text file to assist in separating the data from different logging sessions. First, the date is written, followed by the time. Then, header labels are added, which will be useful when importing the data into a spreadsheet.
```python
# initial write to the SD card on startup
with open("/sd/co2.txt", "a") as f:
# writes the date
f.write('The date is {} {}/{}/{}\n'.format(days[t.tm_wday], t.tm_mday, t.tm_mon, t.tm_year))
# writes the start time
f.write('Start time: {}:{}:{}\n'.format(t.tm_hour, t.tm_min, t.tm_sec))
# headers for data, comma-delimited
f.write('CO2,Time\n')
# debug statement for REPL
print("initial write to SD card complete, starting to log")
```
In the loop, the CO2 level from the SCD-40, along with the current time, is written to the SD card's text file every 30 seconds.
```python
while True:
# variable for RTC datetime
t = rtc.datetime
# append SD card text file
with open("/sd/co2.txt", "a") as f:
# read co2 data from SCD40
co2 = scd4x.CO2
# write co2 data followed by the time, comma-delimited
f.write('{},{}:{}:{}\n'.format(co2, t.tm_hour, t.tm_min, t.tm_sec))
# repeat every 30 seconds
time.sleep(30)
```
# Disconnected CO2 Data Logger
## Wiring
Solder socket headers to the FeatherWing Doubler and plug headers to the Feather RP2040 and the Adalogger FeatherWing.
Tin two pieces of silicon wire. Solder these to two pins on the slide switch.
Add heat shrink to cover the switch's solder connections.
Solder one wire to the **EN** pin on the FeatherWing Doubler. Solder the second wire to **GND** on the FeatherWing Doubler. This creates the on/off switch connection when you plug in the Feather RP2040.
# Disconnected CO2 Data Logger
## Assembly
Attach M2.5 standoffs to the SCD-40 STEMMA board.
Mount the SCD-40 to the top lid of the case using four M2.5 screws.
Mount the FeatherWing Doubler to the bottom lid of the case using M2.5 standoffs and screws.
Plug the LiPoly battery into the Feather RP2040. Then, plug the Feather RP2040 into the FeatherWing Doubler, securing the LiPoly battery underneath the Feather RP2040.
Plug the Adalogger FeatherWing into the FeatherWing Doubler.
Snap the bottom lid of the case into the main box. Secure the on/off switch into the cutout on the side. Make sure that the Feather RP2040's USB port is facing the case's USB-C cutout.
Connect the SCD-40 and Feather RP2040 with a STEMMA QT cable.
Snap the top lid onto the case to enclose the CO2 Data Logger.
# Disconnected CO2 Data Logger
## Usage
After powering up, the Disconnected CO2 Data Logger will begin logging CO2 data with a timestamp to the Adalogger FeatherWing's SD card every 30 seconds.
When you've finished logging, you can import the text file from the SD card, which is comma delimited, to your preferred spreadsheet editor to create charts to visualize your data.
This line graph was created with Google Sheets and shows the CO2 data in a public space over the course of a day. You can tell when a larger crowd gathered in the afternoon.
By collecting data in this way, you can really do whatever you want with it. It isn't tied to a service and the text file format makes it so that it travels easily between applications.
## Featured Products
### Adafruit Feather RP2040
[Adafruit Feather RP2040](https://www.adafruit.com/product/4884)
A new chip means a new Feather, and the Raspberry Pi RP2040 is no exception. When we saw this chip we thought "this chip is going to be awesome when we give it the Feather Treatment" and so we did! This Feather features the **RP2040** , and all niceties you know and...
In Stock
[Buy Now](https://www.adafruit.com/product/4884)
[Related Guides to the Product](https://learn.adafruit.com/products/4884/guides)
### Adalogger FeatherWing - RTC + SD Add-on For All Feather Boards
[Adalogger FeatherWing - RTC + SD Add-on For All Feather Boards](https://www.adafruit.com/product/2922)
A Feather board without ambition is a Feather board without FeatherWings! This is the **Adalogger FeatherWing** : it adds both a battery-backed Real Time Clock and micro SD card storage to any Feather main board. Using our [Feather...](https://www.adafruit.com/products/2830)
Out of Stock
[Buy Now](https://www.adafruit.com/product/2922)
[Related Guides to the Product](https://learn.adafruit.com/products/2922/guides)
### FeatherWing Doubler - Prototyping Add-on For All Feather Boards
[FeatherWing Doubler - Prototyping Add-on For All Feather Boards](https://www.adafruit.com/product/2890)
This is the **FeatherWing Doubler** - a prototyping add-on and more for all Feather boards. This is similar to our [FeatherWing Proto](https://www.adafruit.com/products/2884) except there are two! The magic of the Doubler comes when stacking a Feather and another...
In Stock
[Buy Now](https://www.adafruit.com/product/2890)
[Related Guides to the Product](https://learn.adafruit.com/products/2890/guides)
### Adafruit SCD-40 - True CO2, Temperature and Humidity Sensor
[Adafruit SCD-40 - True CO2, Temperature and Humidity Sensor](https://www.adafruit.com/product/5187)
Take a deep breath in...now slowly breathe out. Mmm isn't it wonderful? All that air around us, which we bring into our lungs, extracts oxygen from and then breathes out carbon dioxide. CO2 is essential for life on this planet we call Earth - we and plants take turns using and...
Out of Stock
[Buy Now](https://www.adafruit.com/product/5187)
[Related Guides to the Product](https://learn.adafruit.com/products/5187/guides)
### STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long
[STEMMA QT / Qwiic JST SH 4-pin Cable - 100mm Long](https://www.adafruit.com/product/4210)
This 4-wire cable is a little over 100mm / 4" long and fitted with JST-SH female 4-pin connectors on both ends. Compared with the chunkier JST-PH these are 1mm pitch instead of 2mm, but still have a nice latching feel, while being easy to insert and remove.
Out of Stock
[Buy Now](https://www.adafruit.com/product/4210)
[Related Guides to the Product](https://learn.adafruit.com/products/4210/guides)
### Black Nylon Machine Screw and Stand-off Set – M2.5 Thread
[Black Nylon Machine Screw and Stand-off Set – M2.5 Thread](https://www.adafruit.com/product/3299)
Totaling 380 pieces, this **M2.5 Screw Set** is a must-have for your workstation. You'll have enough screws, nuts, and hex standoffs to fuel your maker tendencies for days on end! M2.5 size screws fit almost all of the Adafruit breakout/dev board mounting holes...
In Stock
[Buy Now](https://www.adafruit.com/product/3299)
[Related Guides to the Product](https://learn.adafruit.com/products/3299/guides)
### Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh
[Lithium Ion Polymer Battery Ideal For Feathers - 3.7V 400mAh](https://www.adafruit.com/product/3898)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of **400mAh** for a total of about 1.9 Wh. If you need a larger (or smaller!)...
In Stock
[Buy Now](https://www.adafruit.com/product/3898)
[Related Guides to the Product](https://learn.adafruit.com/products/3898/guides)
## Related Guides
- [Introducing Adafruit Feather RP2040](https://learn.adafruit.com/adafruit-feather-rp2040-pico.md)
- [Adafruit SCD-40 and SCD-41](https://learn.adafruit.com/adafruit-scd-40-and-scd-41.md)
- [7 Segment Display Internet Clock](https://learn.adafruit.com/7-segment-display-internet-clock.md)
- [Mystery Box: Crypto Countdown Case](https://learn.adafruit.com/mystery-box-crypto-countdown-case.md)
- [RP2040 RunCPM Emulator with USB Keyboard & HDMI screen](https://learn.adafruit.com/rp2040-runcpm-emulator-with-usb-keyboard-hdmi-screen.md)
- [QT Py Snap Fit Case](https://learn.adafruit.com/qt-py-snap-fit-case.md)
- [Personal and Portable ESP32-S2 Web Server](https://learn.adafruit.com/wordle-personal-esp32-s2-web-server.md)
- [32x32 Square Pixel Art Animation Display](https://learn.adafruit.com/32x32-square-pixel-display.md)
- [Solderless Robot Toy Xylophone](https://learn.adafruit.com/solderless-robot-toy-xylophone.md)
- [Daily Cheer Automaton](https://learn.adafruit.com/daily-cheer-automaton.md)
- [Pip-Boy 2040 Wrist-Mounted Prop](https://learn.adafruit.com/pip-boy-2040.md)
- [Qualia S3 Compass](https://learn.adafruit.com/qualia-s3-compass.md)
- [Deco Two-Key Feather Macro Pad](https://learn.adafruit.com/deco-two-key-keypad-macropad-circuitpython-feather.md)
- [Using Piezo Buzzers with WipperSnapper](https://learn.adafruit.com/using-piezo-buzzers-with-wippersnapper.md)
- [CircuitPython MIDI to CV Skull](https://learn.adafruit.com/circuitpython-midi-to-cv-skull.md)
- [CircuitPython Powered Sip & Puff with ST LPS33HW Pressure Sensor](https://learn.adafruit.com/st-lps33-and-circuitpython-sip-and-puff.md)
- [USB Host to BLE Keyboard Adapter](https://learn.adafruit.com/esp32-s3-usb-to-ble-keyboard-adapter.md)