| .. _amg88xx_shields: |
| |
| Panasonic Grid-EYE Shields |
| ########################## |
| |
| Overview |
| ******** |
| |
| The Panasonic Grid-EYE is an infra-red sensor, which is comprised of 64 |
| individual thermopile elements arranged in an 8x8 matrix. |
| |
| The sensor comes in a compact surface mount package and can be very easily |
| integrated into thermometry applications. |
| |
| Grid-EYE is available in different varieties which differ in field of view, |
| amplification factor and operating voltages. For example AMG8833 features a 60 |
| degree field of view, a high gain amplification factor and 3.3V operating |
| voltage. |
| |
| For the different part numbers that follow the AMG88xx scheme please refer to |
| `IR Thermophile Array Sensor - Grid-EYE`_. |
| |
| For sensor evaluation and rapid prototyping multiple shields are available: |
| |
| - `Panasonic Grid-EYE Evaluation Shield`_ |
| |
| .. figure:: AMG88XX_panasonic_grid_eye_evaluation_shield.png |
| :width: 300px |
| :align: center |
| :alt: Panasonic Grid-EYE Evaluation Shield |
| |
| - `Adafruit AMG8833 8x8 Thermal Camera Sensor`_ |
| |
| .. figure:: AMG8833_adafruit_ir_thermal_camera_sensor.png |
| :width: 200px |
| :align: center |
| :alt: Adafruit AMG8833 8x8 Thermal Camera Sensor |
| |
| Please note that the former follows the Arduino shield standard, while the |
| latter is a breakout board only. Please use the ``amg88xx_grid_eye_eval_shield`` |
| Grid-EYE shield designation for these boards. |
| |
| For the Panasonic Grid-EYE sensor an older evaluation kit was available, that |
| also could be used as an Arduino shield. |
| |
| - Panasonic Grid-EYE Evaluation Kit |
| |
| .. figure:: AMG88XX_panasonic_grid_eye_evaluation_kit.png |
| :width: 250px |
| :align: center |
| :alt: Panasonic Grid-EYE Evaluation Kit (deprecated) |
| |
| Please note that this evaluation kit is no longer available and no online |
| documentation is available anymore. Please use the ``amg88xx_eval_kit`` |
| Grid-EYE shield designation for this board instead. |
| |
| Requirements |
| ************ |
| |
| These shields can only be used with a board that has Arduino connectors and |
| where node aliases for I2C and GPIO interfaces are correctly defined in the |
| board's device tree. |
| |
| This is true for example for Panasonic's PAN1780/PAN1770, PAN1781 and PAN1782 |
| evaluation boards (`Panasonic Wireless Connectivity Development Hub`_). |
| |
| Jumper Configuration |
| ******************** |
| |
| Panasonic Grid-EYE Evaluation Shield |
| ==================================== |
| |
| The Grid-EYE sensor is powered using a LDO. Make sure to set a jumper on |
| P10: LDO_EN. |
| |
| A jumper on P11 configures the I2C address selection. |
| |
| When you use the ``amg88xx_grid_eye_eval_shield`` Grid-EYE shield designation |
| make sure to use the following jumper configurations: |
| |
| * P10: LDO_EN |
| * P11: AD 0x68 |
| |
| Panasonic Grid-EYE Evaluation Kit |
| ================================= |
| |
| On the AMG88xx Evaluation Kit, all jumpers except the J11 and J14 must be |
| removed. |
| |
| Pin Assignment |
| ************** |
| |
| Panasonic Grid-EYE Evaluation Shield |
| ==================================== |
| |
| The following table shows the complete pin assignment of the Grid-EYE |
| Evaluation Shield. |
| |
| +---------------------------+-----------------+ |
| | Shield Connector Pin | Function | |
| +===========================+=================+ |
| | D2 | Interrupt | |
| +---------------------------+-----------------+ |
| | D14 | I2C SDA | |
| +---------------------------+-----------------+ |
| | D15 | I2C SCL | |
| +---------------------------+-----------------+ |
| | Power supply header pin 5 | 5V Power Supply | |
| +---------------------------+-----------------+ |
| | Power supply header pin 6 | GND | |
| +---------------------------+-----------------+ |
| | Power supply header pin 7 | GND | |
| +---------------------------+-----------------+ |
| |
| For more detailed information please refer to |
| `Panasonic Grid-EYE Evaluation Shield`_. |
| |
| For the `Adafruit AMG8833 8x8 Thermal Camera Sensor`_ breakout board you can |
| use the ``amg88xx_grid_eye_eval_shield`` shield designation as well. |
| |
| The wiring has to be done according to |
| `Adafruit AMG8833 8x8 Thermal Camera Sensor Pinouts`_ and the pin assignment |
| table mentioned above. |
| |
| Panasonic Grid-EYE Evaluation Kit |
| ================================= |
| |
| The following table shows the complete pin assignment of the Grid-EYE |
| Evaluation Kit. |
| |
| +---------------------------+-----------------+ |
| | Shield Connector Pin | Function | |
| +===========================+=================+ |
| | D6 | Interrupt | |
| +---------------------------+-----------------+ |
| | D14 | I2C SDA | |
| +---------------------------+-----------------+ |
| | D15 | I2C SCL | |
| +---------------------------+-----------------+ |
| |
| Building |
| ******** |
| |
| The ``samples/sensor/amg88xx`` application demonstrates the basic usage of the |
| Panasonic Grid-EYE sensor. |
| |
| If you want to build the application you have to use the |
| ``-DSHIELD=amg88xx_grid_eye_eval_shield`` shield designation accordingly when |
| you invoke ``west build``. |
| |
| When using the PAN1780 evaluation board the build invocation looks like this: |
| |
| .. zephyr-app-commands:: |
| :zephyr-app: samples/sensor/amg88xx |
| :board: pan1780_evb |
| :shield: amg88xx_grid_eye_eval_shield |
| :goals: build |
| |
| References |
| ********** |
| |
| .. target-notes:: |
| |
| .. _`IR Thermophile Array Sensor - Grid-EYE`: https://industry.panasonic.eu/products/components/sensors/ir-thermophile-array-sensor-grid-eye |
| .. _`Panasonic Grid-EYE Evaluation Shield`: https://industry.panasonic.eu/products/components/sensors/ir-thermophile-array-sensor-grid-eye/grid-eye-evaluation-kit |
| .. _`Panasonic Wireless Connectivity Development Hub`: https://pideu.panasonic.de/development-hub/ |
| .. _`Adafruit AMG8833 8x8 Thermal Camera Sensor`: https://learn.adafruit.com/adafruit-amg8833-8x8-thermal-camera-sensor/overview |
| .. _`Adafruit AMG8833 8x8 Thermal Camera Sensor Pinouts`: https://learn.adafruit.com/adafruit-amg8833-8x8-thermal-camera-sensor/pinouts |