AMG8833
AMG8833
Guide Contents 2
Overview 3
Pinouts 6
Power Pins: 6
Logic pins: 6
Assembly 8
Prepare the header strips: 8
Add the breakout board: 9
And Solder! 10
Arduino Wiring & Test 12
I2C Wiring 12
Download Adafruit_AMG88xx library 12
Load Thermistor Test 13
Pixel Array Output 14
Library Reference 15
Arduino Library Docs 16
Arduino Thermal Camera 17
Adafruit 1.44" Color TFT LCD Display with MicroSD Card breakout 17
CircuitPython Wiring & Test 19
I2C Wiring 19
Download Adafruit_CircuitPython_AMG88xx library 19
Raspberry Pi Thermal Camera 22
Raspberry Pi 3 - Model B - ARMv8 with 1G RAM 22
PiTFT Plus Assembled 320x240 2.8" TFT + Resistive Touchscreen 23
Assembled Pi T-Cobbler Plus - GPIO Breakout 23
Setup PiTFT 23
Install Python Software 23
Enable I2C 24
Wiring Up Sensor 25
Run example code 26
Downloads 28
Documents 28
Schematic 28
Dimensions 28
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.
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.
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!
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.
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
Connect GND to common power/data ground
Connect the SCL pin to the I2C clock SCL pin on your Arduino.
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.
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.
Type in AMG88xx until you see the Adafruit Library pop up. Click Install!
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
Library Reference
To create the object, use
Adafruit_AMG88xx amg;
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);
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.
https://adafru.it/dXl $14.95
IN STOCK
Keep your AMG8833 breakout wired as you already have it from the Wiring & Test section above, and add your TFT
like this
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.
The plug in your CircuitPython device via the USB cable and drag the downloaded adafruit_amg88xx.mpy file to
the /lib folder on the CIRCUITPY drive.
import time
import busio
import board
import adafruit_amg88xx
amg = adafruit_amg88xx.AMG88XX(i2c_bus)
while True:
for row in amg.pixels:
#pad to 1 decimal place
print(['{0:.1f}'.format(temp) for temp in row])
print("")
print("\n")
time.sleep(1)
save the file and open up your serial terminal. You should see the device print out an array of pixels every second.
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.
https://adafru.it/scY $35.00
IN STOCK
https://adafru.it/eZS $34.95
IN STOCK
https://adafru.it/xgf $7.95
IN STOCK
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.
Next, we will install the Raspberry Pi library and Adafruit_GPIO which is our hardware interfacing layer
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?
sudo raspi-config
Wiring Up Sensor
With the Pi powered off, we can wire up the sensor to the Pi Cobbler like this:
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!
sudo i2cdetect -y 1
It should show up under it's default address (0x69). If you don't see 69, check your wiring, did you install I2C support,
etc?
cd ~/
git clone https://github.com/adafruit/Adafruit_AMG88xx_python.git
cd Adafruit_AMG88xx_python/examples
sudo python 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 (hat tip to OSHpark for the idea!)
Schematic
click to enlarge
Dimensions
in inches. Click to enlarge