SparkFun Environmental Combo Breakout - CCS811/BME280 (Qwiic)

The SparkFun CCS811/BME280 Environmental Combo Breakout takes care of all your atmospheric-quality sensing needs with the popular CCS811 and BME280 ICs. This unique breakout provides a variety of environmental data, including barometric pressure, humidity, temperature, TVOCs and equivalent CO2 (or eCO2) levels. To make it even easier to use this breakout, all communication is enacted exclusively via I2C, utilizing our handy Qwiic system. However, we still have broken out 0.1" spaced pins in case you prefer to use a breadboard.

The CCS811 is an exceedingly popular sensor, providing readings for equivalent CO2 (or eCO2) in the parts per million (PPM) and total volatile organic compounds in the parts per billion (PPB). The CCS811 also has a feature that allows it to fine-tune its readings if it has access to the current humidity and temperature. Luckily for us, the BME280 provides humidity, temperature and barometric pressure! This allows the sensors to work together to give us more accurate readings than they’d be able to provide on their own. We also made it easy to interface with them via I2C.

The SparkFun Qwiic connect system is an ecosystem of I2C sensors, actuators, shields and cables that make prototyping faster and less prone to error. All Qwiic-enabled boards use a common 1mm pitch, 4-pin JST connector. This reduces the amount of required PCB space, and polarized connections mean you can’t hook it up wrong.

Get Started with the Environmental Combo Breakout Guide

  • Qwiic-Connector Enabled
  • Operation Voltage: 3.3V
  • Total Volatile Organic Compound (TVOC) sensing from 0 to 1,187 parts per billion
  • eCO2 sensing from 400 to 8,192 parts per million
  • Temp Range: -40C to 85C
  • Humidity Range: 0–100% RH, =-3% from 20–80%
  • Pressure Range: 30,000Pa to 110,000Pa, relative accuracy of 12Pa, absolute accuracy of 100Pa
  • Altitude Range: 0 to 30,000 feet (9.2 km), relative accuracy of 3.3 feet (1m) at sea level, 6.6 (2m) at 30,000 feet

SparkFun Environmental Combo Breakout - CCS811/BME280 (Qwiic) Product Help and Resources

CCS811/BME280 (Qwiic) Environmental Combo Breakout Hookup Guide

September 8, 2017

Sense various environmental conditions such as temperature, humidity, barometric pressure, eCO2 and tVOCs with the CCS811 and BME280 combo breakout board.

Core Skill: Programming

If a board needs code or communicates somehow, you're going to need to know how to program or interface with it. The programming skill is all about communication and code.

3 Programming

Skill Level: Competent - The toolchain for programming is a bit more complex and will examples may not be explicitly provided for you. You will be required to have a fundamental knowledge of programming and be required to provide your own code. You may need to modify existing libraries or code to work with your specific hardware. Sensor and hardware interfaces will be SPI or I2C.
See all skill levels

Core Skill: Electrical Prototyping

If it requires power, you need to know how much, what all the pins do, and how to hook it up. You may need to reference datasheets, schematics, and know the ins and outs of electronics.

2 Electrical Prototyping

Skill Level: Rookie - You may be required to know a bit more about the component, such as orientation, or how to hook it up, in addition to power requirements. You will need to understand polarized components.
See all skill levels

Customer Comments

  • perpetual i2c errors on esp8266. works ok on a uno. someone mentioned a clock stretching issue? Will try Wire.setClockStretchLimit(500L);

  • What a horribly depressing output range .. I guess no need for it to go lower, sadly.

    “eCO2: The equivalent CO2 (eCO2) output range for CCS811 is from 400ppm to 8192ppm. Values outside this range are clipped.”

  • Aren’t the breadboard-spaced pins 0.1", not 1mm? :)

Customer Reviews

3 out of 5

Based on 7 ratings:

Currently viewing all customer reviews.

3 of 3 found this helpful:

Great combination of sensors somewhat hard to use

This is a great combo board for complete environmental monitoring. But I got caught out by the I2C clock stretching requirements on the ESP8266. This is not standard and had to do some hacking around to make it work.

1 of 1 found this helpful:

2 weeks in and still not working properly

I’m building a simple environmental monitor and expected that this component together with a redboard and Qwik shield should work seamlessly out of the box - as described in the Hookup guide.

Its been two weeks since the parts have arrived and this is my current status:

  1. I’ve “broken in” the sensor for 48 hours - and from my experience this did not make any difference to the readings.

  2. I’ve communicated that I am getting a faulty temperature reading (5-7 degrees celcius too high) to Sparkfun customer service (on my 6th email exchange now) - who has updated the hookup guide with a “New fix” (manually reduce the temp reading to compensate for over heating of BME280 produced by the CCS811).

  3. I yesterday left the sensor plugged in over night and I woke up to the following readings: temp 25.5 (4 degrees Celcius too high), altitude -4m (24m too low), humidity 30% (10% too low), and CO2/TVOC 1,200/800 (after opening a window went down to 650/35 so probably correct) and atmospheric pressure of 101 kPa (probably ok).

To conclude, I would be happy with a setup that takes a week to configure and is 10% off in perpetuity. However my experience is that readings can be dramatically out of range - and the system is still not working properly after all the work I’ve put in.

Sparkfun’s customer support has made no attempt to remedy this and is continuing to give generic advice (try this, why not try that?) this is from our latest correspondence when I push him about the precision of the unit: “ We try to account for everything, but we mostly rely on the community to pick up on and fix issues we might have missed.”

I paid a good amount of money for this kit - it is not cool for this company to expect me to do QA for them.

Bought for hackathon

I bought this for making an air quality monitoring device for a hackathon and it worked first time out of the box with the sample code. It was easy to integrate and was the most reliable part of our project. The global average CO2 is (unfortunately) above 400ppm, so the range works just fine. It agreed with the HVAC control panel for the room’s CO2 so seemed to be reasonably accurate. The response time also is within a few seconds.

Design flaw. Runs very hot.

The CCS811 is way too close to the BME280 and heats the temperature sensor up significantly. My BME280 on this board read 5-10 degrees F above the actual temperature. Since every everything else (humidity, TVOC, and eCO2) the sensor outputs except pressure is affected by the temperature, those values are likely to be off as well.

When I contacted support about this, they confirmed that the two sensors were too close together to get accurate temperature readings and suggested using an offset in my code.

It seems to me that they should redesign this board or at least warn people since they know these boards run very hot.

All great, except...

I like everything about this sensor–size, connectors, ease of use. Unfortunately, I don’t think the CO2 and temp readings are accurate. I’ve done the 48-hour burn-in, nd I don’t pay attention to readings prior to the 20-minute point. I see others have had similar issues, but don’t see an ultimate solution to the problem.

BME280 OK, CCS811 is junk

The BME280 portion of this combo works fine. The CCS811, not so much. It was wildly inaccurate when running the test program. Then when I connected it to the I2C port on the Sparkfun Weather Shield, it didn’t work at all. But the BME280 portion still worked. Go figure.

My recommendation: forget about measuring CO2 with this and buy a simple BME280-only sensor. This combo is a nice idea but it doesn’t work. Sorry.

0 of 1 found this helpful:

Cool board

Everything worked fine. The board, the libraries and the example code. I was in the process of trying to find my color touchscreen shield for it, then I found about about Nordic’s Thingy:52 development kit for $40. I bought that because it will do everything I want (and more) through the smartphone, also because I still can’t find my touchscreen…