Part

Thermal camera, AMG8833

An 8x8 grid of temperatures ten times a second over I2C at 0x69.

See every part
  • 5 pins
  • 4 settings
  • In 1 project
Drawn live by the editor's own code, at the size you see it.
Thermal camera, AMG8833 as drawn in the Mokxi simulator
At a glance

The Thermal camera, AMG8833 in brief

What it is, and every setting the properties panel gives it.

The AMG8833 Grid-EYE is an 8x8 thermal camera: sixty-four thermopile pixels, one patch of the scene each, over I2C at up to ten frames a second. The common breakout has VIN, GND, SCL, SDA and an optional open-drain INT pin, and takes 3 to 5 volts, so on an Uno it goes to 5 V with SDA on A4 and SCL on A5, and on an ESP32 to 3.3 V with GPIO 21 and 22. Its address is 0x69, or 0x68 with the AD pin low, a property. Mokxi models the registers from the Grid-EYE specification: twelve-bit pixels in quarters of a degree from 0x80, the thermistor at 0x0E, a new frame every 100 milliseconds at the fast rate, and the absolute interrupt that pulls INT low when a pixel crosses its levels. The scene is a background temperature and one warm spot you click onto the grid, and the Adafruit_AMG88xx library reads it with readPixels. The usual mistake is reading all 128 pixel bytes at once on an Uno, whose Wire buffer holds 32. Frame-to-frame noise and the difference interrupt mode are not modeled.

Family
Sensors
Pins
5
address
105
background
22
spot
34
pixel
27
Pins

5 pins

Named as the editor names them, so a wire lands where you expect it.

Pin
What it does
VIN
Supply, 3 V to 5 V on the breakout.
GND
Ground.
SCL
I2C clock.
SDA
I2C data.
INT
Open drain, low when a pixel crosses the interrupt levels. Optional.
How to use it

How to use the AMG8833 thermal camera with an Arduino

Wire VIN to 5 V, GND to GND, SDA to SDA and SCL to SCL; on an Uno those are the same signals as A4 and A5. The breakout answers at 0x69, which is where the Adafruit AMG88xx library looks by default, so amg.begin() needs no address unless the AD pin is tied low.

Read a frame with amg.readPixels(pixels) into an array of 64 floats, row by row from the top left. A new frame arrives every 100 ms, so there is no point reading faster. The thermal camera example finds the hottest pixel and repaints only the squares whose color changed, because pushing a whole picture to the screen takes far longer than reading it.

Part pin
Board pin
VIN
5 V
GND
GND
SDA
SDA (A4)
SCL
SCL (A5)

On an ESP32 power it from 3.3 V and use the board’s I2C pins, GPIO 21 for SDA and 22 for SCL on a classic DevKit; the library call is the same.

Arduino Uno: thermal cameralive0.000 s 0.00x
Click to open it in the editor
This is the simulator itself, running here. Click anything to open it in the editor.
How it is modeled

What is true about the Thermal camera, AMG8833, here

In its help article’s own words: what the simulation gets right, and where it stops.

Modeled

From the Grid-EYE specification:

The registers. Power control, reset, frame rate, interrupt control and status, the interrupt levels, the thermistor at 0x0E and the sixty-four pixels from 0x80.

The formats. Pixels are twelve-bit two's complement in quarters of a degree; the thermistor is twelve-bit sign and magnitude in sixteenths.

The frames. A new frame every 100 ms at ten frames a second, every second at one, none while asleep.

The absolute interrupt. A pixel over the upper level or under the lower one sets its bit in the table and pulls INT low until the flag is cleared.

Not modeled

The scene is Mokxi's: a background and one spot that spreads half its difference to the pixels beside it and a quarter to the corners. A real sensor is noisy by about a degree from frame to frame; this one is not. The difference interrupt mode, the hysteresis and the moving average are stored but do nothing. The thermistor reads the background, standing in for the room.

From Thermal camera, AMG8833, in full.

Projects

See the Thermal camera, AMG8833 in a project

One built-in project uses it. It opens in the editor, already wired.

Boards

The boards it is shown on

This board has a built-in project with the Thermal camera, AMG8833 in it.

Wire up the Thermal camera, AMG8833

Open the editor and push it into the breadboard. It is free, and it runs on your own machine.