# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Overview

![](https://cdn-learn.adafruit.com/assets/assets/000/043/115/medium800thumb/temperature_3538_giffy2.jpg?1498594979)

Add heat-vision to your project and with an Adafruit AMG8833 Grid-EYE Breakout! This sensor from Panasonic is an 8x8 array of IR thermal sensors. When connected to your microcontroller (or raspberry Pi) it will return an array of 64 individual infrared temperature readings over I2C. It's like those fancy thermal cameras, but compact and simple enough for easy integration.

![](https://cdn-learn.adafruit.com/assets/assets/000/100/548/medium800/temperature___humidity_AMG_STEMMA_top_angle.jpg?1615318168)

This part will measure temperatures ranging from **0°C to 80°C (32°F to 176°F) **with an accuracy of +- 2.5°C (4.5°F). It can detect a human from a distance of up to 7 meters (23) feet. With a maximum frame rate of 10Hz, It's perfect for creating your own human detector or mini thermal camera. We have code for using this breakout on an Arduino or compatible (the sensor communicates over I2C) or on a Raspberry Pi with Python. On the Pi, with a bit of image processing help from the SciPy python library we were able to interpolate the 8x8 grid and get some pretty nice results!

![](https://cdn-learn.adafruit.com/assets/assets/000/043/021/medium800thumb/temperature_amg_88.jpg?1498502178)

The AMG8833 is the next generation of 8x8 thermal IR sensors from Panasonic, and offers higher performance than it's predecessor the AMG8831. The sensor only supports I2C, and has a configurable interrupt pin that can fire when any individual pixel goes above or below a thresholds that you set.

To make it easy to use, we pick & placed it on a breakout board with a 3.3V regulator and level shifting. So you can use it with any 3V or 5V microcontroller or computer.

![](https://cdn-learn.adafruit.com/assets/assets/000/100/549/medium800/temperature___humidity_AMG_STEMMA_back.jpg?1615318176)

Should you wish to avoid soldering, we now also include our **[Stemma QT](http://adafruit.com/stemma)** connectors ([SparkFun Qwiic](https://www.sparkfun.com/qwiic) compatible).  **Using these handy connectors you can simply plug in the sensor, no soldering required! ** [QT Cable is not included, but we have a variety in the shop](https://www.adafruit.com/?q=stemma+qt+cable&sort=BestMatch).

![](https://cdn-learn.adafruit.com/assets/assets/000/100/550/medium800/temperature___humidity_AMG_STEMMA_side.jpg?1615318186)

Even better - We've done all the hard work here, with example code and supporting software libraries to get you up in running in just a few lines of code!

Info: 

![](https://cdn-learn.adafruit.com/assets/assets/000/043/016/medium800/temperature_AMG8833_3.jpg?1498492754)

# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Pinouts

![](https://cdn-learn.adafruit.com/assets/assets/000/100/552/medium800/temperature___humidity_AMG_STEMMA_pinouts.jpg?1615318408)

![](https://cdn-learn.adafruit.com/assets/assets/000/043/117/medium800/temperature_pinout.jpg?1498595465)

This camera has 4 mounting holes, and two header strips. Only the bottom strip is connected to the sensor. The top set of breakouts is there for mechanical stability only!

## Power Pins:

- **Vin** - this is the power pin. Since the sensor uses 3.3V, we have included an onboard voltage regulator that will take 3-5VDC and safely convert it down. To power the board, give it the same power as the logic level of your microcontroller - e.g. for a 5V micro like Arduino, use 5V
- **3Vo** - this is the 3.3V output from the voltage regulator, you can grab up to 100mA from this if you like
- **GND** - common ground for power and logic

## Logic pins:

- **SCL ** - this is the I2C clock pin, connect to your microcontrollers I2C clock line. There is a 10K pullup on this pin and it is level shifted so you can use 3 - 5VDC.
- **SDA ** - this is the I2C data pin, connect to your microcontrollers I2C data line. There is a 10K pullup on this pin and it is level shifted so you can use 3 - 5VDC.
- **INT** - this is the interrupt-output pin. It is 3V logic and you can use it to detect when something moves or changes in the sensor vision path.
- **[STEMMA QT](https://learn.adafruit.com/introducing-adafruit-stemma-qt) -** These connectors allow you to connectors to dev boards with  **STEMMA QT** connectors or to other things with [various associated accessories](https://www.adafruit.com/?q=JST%20SH%204)

![](https://cdn-learn.adafruit.com/assets/assets/000/043/118/medium800/temperature_top.jpg?1498595587)

The 6 holes at the top of the board are provided for stability and are not connected to anything. Use these if you want your sensor to sit nice and flat on a breadboard or Perma-Proto.

# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Assembly

![](https://cdn-learn.adafruit.com/assets/assets/000/043/077/medium800/temperature_AMG8833_3.jpg?1498580723)

### Prepare the header strips:

Cut the strips to length if necessary. It will be easier to solder if you insert it into a breadboard - **long pins down**

![temperature_DSC_3527.jpg](https://cdn-learn.adafruit.com/assets/assets/000/043/078/medium640/temperature_DSC_3527.jpg?1498580764)

## Add the breakout board:

Place the breakout board over the pins so that the short pins poke through the breakout pads

![temperature_DSC_3534.jpg](https://cdn-learn.adafruit.com/assets/assets/000/043/080/medium640/temperature_DSC_3534.jpg?1498580836)

## And Solder!

Be sure to solder all pins for reliable electrical contact.  
  
_(For tips on soldering, be sure to check out our [Guide to Excellent Soldering](http://learn.adafruit.com/adafruit-guide-excellent-soldering)__)._

![temperature_DSC_3535.jpg](https://cdn-learn.adafruit.com/assets/assets/000/043/081/medium640/temperature_DSC_3535.jpg?1498580888)

![temperature_DSC_3538.jpg](https://cdn-learn.adafruit.com/assets/assets/000/043/083/medium640/temperature_DSC_3538.jpg?1498580900)

![temperature_DSC_3540.jpg](https://cdn-learn.adafruit.com/assets/assets/000/043/084/medium640/temperature_DSC_3540.jpg?1498580920)

You're done! Check your solder joints visually and continue onto the next steps

![temperature_DSC_3544.jpg](https://cdn-learn.adafruit.com/assets/assets/000/043/085/medium640/temperature_DSC_3544.jpg?1498580981)

# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Arduino Wiring & Test

You can easily wire this breakout to any microcontroller, we'll be using an Arduino. You can use any other kind of microcontroller as well as long as it has I2C clock and I2C data lines.

# I2C Wiring
- Connect **Vin** to the power supply, 3-5V is fine. Use the same voltage that the microcontroller logic is based off of. For most Arduinos, that is 5V **(red wire on STEMMA QT version)**
- Connect **GND** to common power/data ground **(black wire on STEMMA QT version)**
- Connect the **SCL** pin to the I2C clock **SCL** pin on your Arduino. **(yellow wire on STEMMA QT version)**  
On an UNO & '328 based Arduino, this is also known as **A5** , on a Mega it is also known as **digital 21** and on a Leonardo/Micro, **digital 3**   
- Connect the **SDA** pin to the I2C data **SDA** pin on your Arduino. **(blue wire on STEMMA QT version)**  
On an UNO & '328 based Arduino, this is also known as **A4** , on a Mega it is also known as **digital 20** and on a Leonardo/Micro, **digital 2**

By default, the I2C address is 0x69. If you solder the jumper on the back of the board labeled " **Addr**", the address will change to 0x68.

![temperature___humidity_AMG8833S_Arduino_STEMMA_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/100/557/medium640/temperature___humidity_AMG8833S_Arduino_STEMMA_bb.jpg?1615327484)

![temperature___humidity_AMG8833S_Arduino_breadboard_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/100/558/medium640/temperature___humidity_AMG8833S_Arduino_breadboard_bb.jpg?1615327502)

![temperature___humidity_AMG8833_Arduino_original.png](https://cdn-learn.adafruit.com/assets/assets/000/100/559/medium640/temperature___humidity_AMG8833_Arduino_original.png?1615327526)

# Download Adafruit\_AMG88xx library

To begin reading sensor data, [you will need to install the Adafruit\_AMG88xx library](https://github.com/adafruit/Adafruit_AMG88xx).

Start up the IDE and open the Library Manager:

![](https://cdn-learn.adafruit.com/assets/assets/000/048/539/medium800/temperature___humidity_managelib.png?1511746137)

Type in **AMG88xx** until you see the Adafruit Library pop up. Click Install!

![](https://cdn-learn.adafruit.com/assets/assets/000/048/540/medium800/temperature___humidity_amglib.png?1511746208)

We also have a great tutorial on Arduino library installation at:  
[http://learn.adafruit.com/adafruit-all-about-arduino-libraries-install-use](http://learn.adafruit.com/adafruit-all-about-arduino-libraries-install-use)

# Load Test

Open up  **File-\>Examples-\>Adafruit\_AMG88xx-\>amg88xx\_test** and upload to your Arduino wired up to the sensor. This example just connects to the sensor and reads the internal thermistor to test your connections.

![](https://cdn-learn.adafruit.com/assets/assets/000/043/120/medium800/temperature_amgtest.gif?1498596062)

Once uploaded to your Arduino, open up the serial console at 9600 baud speed to see the internal thermistor reading. If you get a reading of ~26° degrees (room temperature) then everything is wired and working correctly!

![](https://cdn-learn.adafruit.com/assets/assets/000/043/121/medium800/temperature_serialtest.gif?1498596216)

# Pixel Array Output

OK now that we know the sensor is working, let's read actual thermal data. Load up  **File -\> Examples -\> Adafruit\_AMG88 -\> pixels\_test**

Upload the code, and open the serial console at 9600 baud rate. You should see a printout of the array of readings every second. Each number is the detected temperature in Celsius, and in the 8x8 grid order that comes from the sensor

The numbers should increase if you put your hand or face above the sensor. They'll decrease if you hold up something cold in front of the sensor eye

![](https://cdn-learn.adafruit.com/assets/assets/000/043/141/medium800/temperature_Screenshot_%2820%29.png?1498597736)

# Library Reference

To create the object, use

```
Adafruit_AMG88xx amg;
```

Initialize the sensor using

```
status = amg.begin();
    if (!status) {
        Serial.println("Could not find a valid AMG88xx sensor, check wiring!");
        while (1);
    }

```

to read the pixels you will need an array to place the readings into. Once you have one, you can call readPixels. Make sure the array you create is big enough by using the pre-defined AMG88xx\_PIXEL\_ARRAY\_SIZE macro.

```
float pixels[AMG88xx_PIXEL_ARRAY_SIZE];
amg.readPixels(pixels);
```

# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Arduino Library Docs

# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Arduino Thermal Camera

To make your Arduino into a cool thermal camera, we can add a small display.

In this example we use an Adafruit 1.44" Color TFT. With some code changes, you can use other size displays but a color display is best of course.

### Adafruit 1.44" Color TFT LCD Display with MicroSD Card breakout

[Adafruit 1.44" Color TFT LCD Display with MicroSD Card breakout](https://www.adafruit.com/product/2088)
This lovely little display breakout is the best way to add a small, colorful and bright display to any project. Since the display uses 4-wire SPI to communicate and has its own pixel-addressable frame buffer, it can be used with every kind of microcontroller. Even a very small one with low...

In Stock
[Buy Now](https://www.adafruit.com/product/2088)
[Related Guides to the Product](https://learn.adafruit.com/products/2088/guides)
![Overhead video of TFT display running boot-up animation including accelerometer and colored polygons.](https://cdn-shop.adafruit.com/product-videos/640x480/2088-09.jpg)

Keep your AMG8833 breakout wired as you already have it from the Wiring & Test section above, and add your TFT like this

![](https://cdn-learn.adafruit.com/assets/assets/000/129/456/medium800/temperature___humidity_stemma-circuit.png?1713885506)

Once everything is all wired up, load up  **File-\>Examples-\>Adafruit\_AMG88xx-\>thermal\_cam**

Hit upload and you should have a simple thermal camera!

![](https://cdn-learn.adafruit.com/assets/assets/000/043/140/medium800thumb/temperature_3538_giffy2.jpg?1498597620)

[James DV has also sent over a version that is optimized if you want a faster display-update rate](https://github.com/jamesdanielv/thermalcam)

# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Python & CircuitPython

It's easy to use the AMG8833 sensor with Python or CircuitPython and the [Adafruit CircuitPython AMG88xx](https://github.com/adafruit/Adafruit_CircuitPython_AMG88xx) module.  This module allows you to easily write Python code that reads thermal imaging data from the sensor.

You can use this sensor with any CircuitPython microcontroller board or with a computer that has GPIO and Python [thanks to Adafruit\_Blinka, our CircuitPython-for-Python compatibility library](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux).

# CircuitPython Microcontroller Wiring

First wire up a AMG8833 to your board exactly as shown on the previous pages for Arduino.  Here's an example of wiring a Feather M0 to the sensor with I2C:

- **Board 3V** to **sensor VIN (red wire on STEMMA QT version)**  
- **Board GND** to **sensor GND (black wire on STEMMA QT version)**  
- **Board SCL** to **sensor SCL (yellow wire on STEMMA QT version)**  
- **Board SDA** to **sensor SDA (blue wire on STEMMA QT version)**  

![temperature___humidity_AMG8833S_Feather_STEMMA_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/100/560/medium640/temperature___humidity_AMG8833S_Feather_STEMMA_bb.jpg?1615332292)

![temperature___humidity_AMG8833S_Feather_breadboard_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/100/561/medium640/temperature___humidity_AMG8833S_Feather_breadboard_bb.jpg?1615332336)

![temperature___humidity_AMG8833_Feather_original.jpg](https://cdn-learn.adafruit.com/assets/assets/000/100/562/medium640/temperature___humidity_AMG8833_Feather_original.jpg?1615332359)

# Python Computer Wiring

Since there's _dozens_ of Linux computers/boards you can use we will show wiring for Raspberry Pi. For other platforms, [please visit the guide for CircuitPython on Linux to see whether your platform is supported](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux). 

Here's the Raspberry Pi wired with I2C:

- **Pi 3V3** to **sensor VIN (red wire on STEMMA QT version)**  
- **Pi GND** to **sensor GND (black wire on STEMMA QT version)**  
- **Pi SCL** to **sensor SCL (yellow wire on STEMMA QT version)**  
- **Pi SDA** to **sensor SDA (blue wire on STEMMA QT version)**  

![temperature___humidity_AMG8833S_Raspi_STEMMA_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/100/563/medium640/temperature___humidity_AMG8833S_Raspi_STEMMA_bb.jpg?1615332452)

![temperature___humidity_AMG8833S_Raspi_Breadboard_bb.jpg](https://cdn-learn.adafruit.com/assets/assets/000/100/564/medium640/temperature___humidity_AMG8833S_Raspi_Breadboard_bb.jpg?1615332472)

![temperature___humidity_AMG8833_Raspi_original.jpg](https://cdn-learn.adafruit.com/assets/assets/000/100/565/medium640/temperature___humidity_AMG8833_Raspi_original.jpg?1615332490)

# CircuitPython Installation of AMG88xx Library

You'll need to install the [Adafruit CircuitPython AMG88xx](https://github.com/adafruit/Adafruit_CircuitPython_AMG88xx) library on your CircuitPython board.

First make sure you are running the [latest version of Adafruit CircuitPython](https://learn.adafruit.com/welcome-to-circuitpython/installing-circuitpython) for your board.

Next you'll need to install the necessary libraries to use the hardware--carefully follow the steps to find and install these libraries from [Adafruit's CircuitPython library bundle](https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases).  Our CircuitPython starter guide has [a great page on how to install the library bundle](https://learn.adafruit.com/welcome-to-circuitpython/circuitpython-libraries).

For non-express boards like the Trinket M0 or Gemma M0, you'll need to manually install the necessary libraries from the bundle:

- **adafruit\_amg88xx.mpy**
- **adafruit\_bus\_device**
- **adafruit\_register**

Before continuing make sure your board's lib folder or root filesystem has the **adafruit\_amg88xx.mpy,** and **adafruit\_bus\_device** and **adafruit\_register** files and folders ** ** copied over.

Next[ connect to the board's serial REPL](https://learn.adafruit.com/welcome-to-circuitpython/the-repl) so you are at the CircuitPython  **\>\>\>**  prompt.

# Python Installation of AMG88xx Library

You'll need to install the Adafruit\_Blinka library that provides the CircuitPython support in Python. This may also require enabling I2C on your platform and verifying you are running Python 3. [Since each platform is a little different, and Linux changes often, please visit the CircuitPython on Linux guide to get your computer ready](https://learn.adafruit.com/circuitpython-on-raspberrypi-linux)!

Once that's done, from your command line run the following command:

- `sudo pip3 install adafruit-circuitpython-amg88xx`

If your default Python is version 3 you may need to run 'pip' instead. Just make sure you aren't trying to use CircuitPython on Python 2.x, it isn't supported!

# CircuitPython & Python Usage

To demonstrate the usage of the sensor we'll initialize it and read the thermal imaging data the board's Python REPL.

If you're using an I2C connection run the following code to import the necessary modules and initialize the I2C connection with the sensor:

```
import time
import busio
import board
import adafruit_amg88xx
i2c = busio.I2C(board.SCL, board.SDA)
amg = adafruit_amg88xx.AMG88XX(i2c)
```

Now you're ready to read values from the sensor using any of these properties:

- **temperature** - The sensor temperature in degrees Celsius.
- **pixels** - Temperature of each pixel across the sensor in Celsius. Temperatures are stored in a two dimensional list where the first index is the row and the second is the column. The first row is on the side closest to the writing on the sensor.

For example, to print the pixel temp once every second until you tell it to stop:

```
while True:
    for row in amg.pixels:
        print(['{0:.1f}'.format(temp) for temp in row])
        print("")
    print("\n")
    time.sleep(1)
```

![](https://cdn-learn.adafruit.com/assets/assets/000/059/232/medium800/temperature___humidity_AMG8833_REPL_Print_Output.png?1534370007)

That's all there is to using AMG88ss with CircuitPython!

# Full Example Code
https://github.com/adafruit/Adafruit_CircuitPython_AMG88xx/blob/main/examples/amg88xx_simpletest.py

# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Python Docs

# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Raspberry Pi Thermal Camera

![](https://cdn-learn.adafruit.com/assets/assets/000/043/023/medium800thumb/temperature_amg_88.jpg?1498502211)

The Raspberry Pi also has an i2c interface, and even better has processing capability to interpolate and filter the sensor output. By adding processing power, you can 'turn' the 8x8 output into what appears to be a higher-resolution display.

We're using a PiTFT 2.8" and a Pi Cobbler but the code can be adapted to output to the HDMI display - we're using pygame to draw to the framebuffer.

You can use any Raspberry Pi computer, from Pi A+ to Pi 3 or even a Pi Zero, but we happen to have a Pi 3 on our desk set up already so we're using that.

### Raspberry Pi 3 - Model B - ARMv8 with 1G RAM

[Raspberry Pi 3 - Model B - ARMv8 with 1G RAM](https://www.adafruit.com/product/3055)
Did you really think the Raspberry Pi would stop getting better? At this point, we sound like a broken record, extolling on the new Pi’s myriad improvements like we’re surprised that the folks at the Raspberry Pi Foundation are continuously making their flagship board better. ...

In Stock
[Buy Now](https://www.adafruit.com/product/3055)
[Related Guides to the Product](https://learn.adafruit.com/products/3055/guides)
![Angled shot of Raspberry Pi 3 - Model B.](https://cdn-shop.adafruit.com/640x480/3055-04.jpg)

### PiTFT Plus Assembled 320x240 2.8" TFT + Resistive Touchscreen

[PiTFT Plus Assembled 320x240 2.8" TFT + Resistive Touchscreen](https://www.adafruit.com/product/2298)
Is this not the cutest little display for the Raspberry Pi? It features a 2.8" display with 320x240 16-bit color pixels and a resistive touch overlay. The plate uses the high speed SPI interface on the Pi and can use the mini display as a console, X window port, displaying images or...

Out of Stock
[Buy Now](https://www.adafruit.com/product/2298)
[Related Guides to the Product](https://learn.adafruit.com/products/2298/guides)
![Red polished white finger touching the PiTFT Plus Assembled 320x240 2.8" TFT + Resistive Touchscreen. ](https://cdn-shop.adafruit.com/640x480/2298-16.jpg)

### Assembled Pi T-Cobbler Plus - GPIO Breakout

[Assembled Pi T-Cobbler Plus - GPIO Breakout](https://www.adafruit.com/product/2028)
 **This is the assembled version of the Pi T-Cobbler Plus.  It only works with the Raspberry Pi Model Zero, A+, B+, Pi 2, Pi 3 & Pi 4!** (Any Pi with 2x20 connector)  
  
The Raspberry Pi has landed on the Maker World like a 40-GPIO pinned, quad-USB ported, credit...

In Stock
[Buy Now](https://www.adafruit.com/product/2028)
[Related Guides to the Product](https://learn.adafruit.com/products/2028/guides)
![Angled shot of Assembled Pi T-Cobbler Plus next to GPIO ribbon cable](https://cdn-shop.adafruit.com/640x480/2028-07.jpg)

# Setup PiTFT

If you have not done so already, the first thing you will need to do is setup your PiTFT. Instructions on how to do so can be found in [this guide](https://learn.adafruit.com/adafruit-pitft-28-inch-resistive-touchscreen-display-raspberry-pi/easy-install-2).

# Install Python Software

Once your PiTFT is all set up, and you have Internet access set up [go back to this page and install the Python software for the AMG8833 so you can read data from the sensor.](https://learn.adafruit.com/adafruit-amg8833-8x8-thermal-camera-sensor/python-circuitpython)

### Adafruit AMG8833 8x8 Thermal Camera Sensor - Python & CircuitPython

[Adafruit AMG8833 8x8 Thermal Camera Sensor](https://learn.adafruit.com/adafruit-amg8833-8x8-thermal-camera-sensor)
[Python & CircuitPython](https://learn.adafruit.com/adafruit-amg8833-8x8-thermal-camera-sensor/python-circuitpython)
Finally, install both pygame and scipy. Pygame lets us draw easily to a screen using python, we'll use that to make the display work. Scipy is a powerful scientific/data processing library that we can use to magically turn the 8x8 = 64 pixel array into something that looks more like a 32x32 = 1024 pixel array. Wow, isn't digital signal processing cool?

```terminal
sudo apt-get install -y python3-pip python-scipy python-pygame i2c-tools
sudo pip3 install colour adafruit-blinka numpy pygame scipy adafruit-circuitpython-amg88xx
```

Warning: If you get errors that say the software cannot find scipy or pygame, ensure the step above worked

# Wiring Up Sensor

With the Pi powered off, we can wire up the sensor to the Pi Cobbler like this:

- Connect **Vin** to the 3V or 5V power supply (either is fine)
- Connect **GND** to the ground pin on the Cobbler
- Connect **SDA ** to  **SDA ** on the Cobbler
- Connect  **SCL** to  **SCL** on the Cobbler

You can also use direct wires, we happen to have a Cobbler ready. remember you can plug the cobbler into the bottom of the PiTFT to get access to all the pins!

![](https://cdn-learn.adafruit.com/assets/assets/000/043/143/medium800/temperature_AMG88_pi_cam_bb.png?1498598670)

Now you should be able to verify that the sensor is wired up correctly by asking the Pi to detect what addresses it can see on the I2C bus:

```
sudo i2cdetect -y 1
```

![](https://cdn-learn.adafruit.com/assets/assets/000/043/253/medium800/temperature_Screenshot_%2826%29.png?1498679179)

It should show up under its default address ( **0x69** ). If you don't see 0x69, check your wiring, did you install I2C support, etc?

# Run example code

At long last, we are finally ready to run our example code

https://github.com/adafruit/Adafruit_CircuitPython_AMG88xx/blob/main/examples/amg88xx_rpi_thermal_cam.py

If you have everything installed and wired up correctly, you should see a nice thermal camera image. Cool tones (blue and purple) are cooler temperatures, and warmer tones (yellow, red) are warmer temperatures.

If your image seems to be flipped on the screen, try changing the orientation of the AMG8833 breakout on the breadboard.

If you're interested int he details, and want to know more about how we made 64 pixels look like many more, it's called [bicubic interpolation](https://en.wikipedia.org/wiki/Bicubic_interpolation) ([hat tip to OSHpark for the idea](https://twitter.com/oshpark/status/870377750993006592)!)

![](https://cdn-learn.adafruit.com/assets/assets/000/043/142/medium800thumb/temperature_3538_giffy1.jpg?1498597973)

# Adafruit AMG8833 8x8 Thermal Camera Sensor

## Downloads

# Documents

- [AMG8833 datasheet](https://cdn-learn.adafruit.com/assets/assets/000/043/261/original/Grid-EYE_SPECIFICATIONS%28Reference%29.pdf?1498680225)
- [AMG8833 Arduino Driver](https://github.com/adafruit/Adafruit_AMG88xx)
- [Fritzing object for STEMMA QT version in Adafruit Fritzing Library](https://github.com/adafruit/Fritzing-Library/blob/master/parts/Adafruit%20AMG8833.fzpz)
- [Fritzing object in the Adafruit Fritzing library](https://github.com/adafruit/Fritzing-Library)
- [AMG8833 CircuitPython Driver](https://github.com/adafruit/Adafruit_CircuitPython_AMG88xx)
- [AMG8833 breakout PCB files (EAGLE format)](https://github.com/adafruit/Adafruit-AMG8833-Breakout-PCB)

# Schematic and Fab Print STEMMA QT Version
![](https://cdn-learn.adafruit.com/assets/assets/000/100/554/medium800/temperature___humidity_AMG_STEMMA_sch.png?1615321998)

![](https://cdn-learn.adafruit.com/assets/assets/000/100/556/medium800/temperature___humidity_AMG_STEMMA_fab_print.png?1615322055)

# Schematic and Fab Print FeatherWing Version
![](https://cdn-learn.adafruit.com/assets/assets/000/102/726/medium800/temperature___humidity_AMG8833FW_sch.png?1623184520)

![](https://cdn-learn.adafruit.com/assets/assets/000/102/727/medium800/temperature___humidity_AMG8833FW_fab_print.png?1623184529)

# Schematic Original Breakout Version

click to enlarge

![](https://cdn-learn.adafruit.com/assets/assets/000/043/011/medium800/temperature_amg8833_schematic.png?1498491937)

# Dimensions Original Breakout Version

in inches. Click to enlarge

![](https://cdn-learn.adafruit.com/assets/assets/000/043/260/medium800/temperature_amg88_dimensions.png?1498680150)


## Featured Products

### Adafruit AMG8833 IR Thermal Camera Breakout

[Adafruit AMG8833 IR Thermal Camera Breakout](https://www.adafruit.com/product/3538)
Add heat-vision to your project with an Adafruit AMG8833 Grid-EYE Breakout! This sensor from Panasonic is an 8x8 array of IR thermal sensors. When connected to your microcontroller (or raspberry Pi) it will return an array of 64 individual infrared temperature readings over I2C. It's like...

In Stock
[Buy Now](https://www.adafruit.com/product/3538)
[Related Guides to the Product](https://learn.adafruit.com/products/3538/guides)
### Adafruit 1.44" Color TFT LCD Display with MicroSD Card breakout

[Adafruit 1.44" Color TFT LCD Display with MicroSD Card breakout](https://www.adafruit.com/product/2088)
This lovely little display breakout is the best way to add a small, colorful and bright display to any project. Since the display uses 4-wire SPI to communicate and has its own pixel-addressable frame buffer, it can be used with every kind of microcontroller. Even a very small one with low...

In Stock
[Buy Now](https://www.adafruit.com/product/2088)
[Related Guides to the Product](https://learn.adafruit.com/products/2088/guides)
### Raspberry Pi 3 - Model B - ARMv8 with 1G RAM

[Raspberry Pi 3 - Model B - ARMv8 with 1G RAM](https://www.adafruit.com/product/3055)
Did you really think the Raspberry Pi would stop getting better? At this point, we sound like a broken record, extolling on the new Pi’s myriad improvements like we’re surprised that the folks at the Raspberry Pi Foundation are continuously making their flagship board better. ...

In Stock
[Buy Now](https://www.adafruit.com/product/3055)
[Related Guides to the Product](https://learn.adafruit.com/products/3055/guides)
### Assembled Pi T-Cobbler Plus - GPIO Breakout

[Assembled Pi T-Cobbler Plus - GPIO Breakout](https://www.adafruit.com/product/2028)
 **This is the assembled version of the Pi T-Cobbler Plus.  It only works with the Raspberry Pi Model Zero, A+, B+, Pi 2, Pi 3 & Pi 4!** (Any Pi with 2x20 connector)  
  
The Raspberry Pi has landed on the Maker World like a 40-GPIO pinned, quad-USB ported, credit...

In Stock
[Buy Now](https://www.adafruit.com/product/2028)
[Related Guides to the Product](https://learn.adafruit.com/products/2028/guides)
### PiTFT Plus Assembled 320x240 2.8" TFT + Resistive Touchscreen

[PiTFT Plus Assembled 320x240 2.8" TFT + Resistive Touchscreen](https://www.adafruit.com/product/2298)
Is this not the cutest little display for the Raspberry Pi? It features a 2.8" display with 320x240 16-bit color pixels and a resistive touch overlay. The plate uses the high speed SPI interface on the Pi and can use the mini display as a console, X window port, displaying images or...

Out of Stock
[Buy Now](https://www.adafruit.com/product/2298)
[Related Guides to the Product](https://learn.adafruit.com/products/2298/guides)

## Related Guides

- [Adafruit 1.44" Color TFT with Micro SD Socket](https://learn.adafruit.com/adafruit-1-44-color-tft-with-micro-sd-socket.md)
- [PiTFT Python + Pillow Animated Gif Player](https://learn.adafruit.com/pitft-linux-python-animated-gif-player.md)
- [Adafruit's Raspberry Pi Lesson 12. Sensing Movement](https://learn.adafruit.com/adafruits-raspberry-pi-lesson-12-sensing-movement.md)
- [Playing sounds and using buttons with Raspberry Pi](https://learn.adafruit.com/playing-sounds-and-using-buttons-with-raspberry-pi.md)
- [Animated Scrolling "Mario Clouds" TFT Jewelry](https://learn.adafruit.com/scrolling-mario-clouds-tft-jewelry.md)
- [I2C Addresses and Troublesome Chips](https://learn.adafruit.com/i2c-addresses.md)
- [PiGRRL 2](https://learn.adafruit.com/pigrrl-2.md)
- [Large Pi-based Thermometer and Clock](https://learn.adafruit.com/large-pi-based-thermometer-and-clock.md)
- [Raspberry Pi E-mail Notifier Using LEDs](https://learn.adafruit.com/raspberry-pi-e-mail-notifier-using-leds.md)
- [CircuitPython Display Support Using displayio](https://learn.adafruit.com/circuitpython-display-support-using-displayio.md)
- [Capacitive Touch Sensors on the Raspberry Pi](https://learn.adafruit.com/capacitive-touch-sensors-on-the-raspberry-pi.md)
- [Running OpenGL-based Games & Emulators on Adafruit PiTFT Displays](https://learn.adafruit.com/running-opengl-based-games-and-emulators-on-adafruit-pitft-displays.md)
- [Windows IoT Core Application Development: Headed Blinky](https://learn.adafruit.com/windows-iot-application-development-headed-blinky.md)
- [IoT Temperature Logger with Analog Devices ADT7410, Raspberry Pi, and Adafruit IO](https://learn.adafruit.com/iot-temperature-logger-with-python-and-adafruit-io.md)
- [Monitor PiCam and temperature on a PiTFT via adafruit.io](https://learn.adafruit.com/monitor-picam-and-temperature-on-a-pitft-via-adafruit-dot-io.md)
- [LoRa and LoRaWAN Radio for Raspberry Pi](https://learn.adafruit.com/lora-and-lorawan-radio-for-raspberry-pi.md)