adafruit learning system MatrixPortal M4 Manual de usuario
Adafruit MatrixPortal M4
Created by Melissa LeBlanc-Williams
Last updated on 2021-08-09 02:02:07 PM EDT
2
5
9
9
9
10
10
11
11
11
12
12
12
13
13
13
14
14
16
16
17
17
19
21
21
21
24
25
28
28
28
30
30
30
32
32
33
33
33
38
40
41
42
43
47
47
48
48
48
48
48
Guide Contents
Guide Contents
Overview
Pinouts
Microcontroller and Flash
WiFi
HUB75 Connector
RGB Matrix Power
Sensors
Stemma QT Connector
Reset Pin
Debugging Interface
Serial UART Pins
Analog Connector/Pins
Power Pins
Status LED and NeoPixel
USB-C Connector
Buttons
Address E Line Jumper
Prep the MatrixPortal
Power Prep
Power Terminals
Panel Power
Board Connection
LED Matrix Diffuser
LED Diffusion Acrylic
Measure and Cut the Plastic
Uglu Dashes
Stand
Install CircuitPython
Set up CircuitPython Quick Start!
Further Information
What is CircuitPython?
CircuitPython is based on Python
Why would I use CircuitPython?
CircuitPython Setup
Adafruit CircuitPython Bundle
Internet Connect!
What's a secrets file?
Connect to WiFi
Requests
HTTP GET with Requests
HTTP POST with Requests
Advanced Requests Usage
WiFi Manager
MatrixPortal Library Overview
Network Branch
WiFi Module
Network Module
Graphics Branch
Matrix Module
Graphics Module
© Adafruit Industries https://learn.adafruit.com/adafruit-matrixportal-m4 Page 2 of 96
48
49
50
50
50
51
52
53
54
55
56
57
57
57
57
57
58
58
59
63
64
66
66
67
68
70
71
72
72
73
74
74
74
74
75
75
75
75
76
76
77
78
78
78
80
80
MatrixPortal Module
Library Demos
CircuitPython Pins and Modules
CircuitPython Pins
import board
I2C, SPI, and UART
What Are All the Available Names?
Microcontroller Pin Names
CircuitPython Built-In Modules
MatrixPortal Library Docs
CircuitPython RGB Matrix Library
CircuitPython BLE
CircuitPython BLE UART Example
On-Board Airlift Co-Processor - No Wiring Needed
Update the AirLift Firmware
Install CircuitPython Libraries
Install the Adafruit Bluefruit LE Connect App
Copy and Adjust the Example Program
Talk to the AirLift via the Bluefruit LE Connect App
Arduino IDE Setup
https://adafruit.github.io/arduino-board-index/package_adafruit_index.json
Using with Arduino IDE
Install SAMD Support
Install Adafruit SAMD
Install Drivers (Windows 7 & 8 Only)
Blink
Successful Upload
Compilation Issues
Manually bootloading
Ubuntu & Linux Issue Fix
Arduino Libraries
Install Libraries
Adafruit NeoPixel
Adafruit SPIFlash
Adafruit Protomatter
Adafruit LIS3DH
Adafruit GFX
WiFiNINA
Adafruit ImageReader
Adafruit PixelDust
Using the Protomatter Library
Include Protomatter Library
Setting Up Matrix Pin Usage
Create the Protomatter Object
Begin Protomatter Driver
Draw Shapes & Text Using Adafruit GFX
Adafruit_GFX is the same library that drives many of our LCD and OLED displays…if you’ve done other graphics
projects, you might already be familiar! And if not, we have a separate guide explaining all of the available
drawing functions (https://adafru.it/DtY). Most folks can get a quick start by looking at the “simple” and
© Adafruit Industries https://learn.adafruit.com/adafruit-matrixportal-m4 Page 3 of 96
80
81
83
87
88
88
90
93
94
94
94
94
“doublebuffer_scrolltext” examples and tweaking these for their needs.
Check Refresh Rate
Arduino Sand Demo
Protomatter Library
Using the Accelerometer
Arduino Usage
CircuitPython Usage
Updating ESP32 Firmware
Downloads
Files
Schematic
Fab Print
© Adafruit Industries https://learn.adafruit.com/adafruit-matrixportal-m4 Page 4 of 96
Overview
Folks love Adafruit's wide selection of RGB matrices (https://adafru.it/NAX) and accessories for making
custom colorful LED displays... and Adafruit RGB Matrix Shields and FeatherWings can be quickly soldered
together to make the wiring much easier.
But what if we made it
even easier
than that? Like, no solder, no wiring, just instant plug-and-play? Dream
no more - with the Adafruit Matrix Portal add-on for RGB Matrices , there has never been an easier way to
create powerful internet-connected LED displays.
Plug The Matrix Portal directly into the back of any HUB-75 compatible display (all the ones we stock will
work) from 16x32 up to 64x64 (https://adafru.it/NAX)! Use the included screws to attach the power cable to
the power plugs with a common screwdriver, then power it with any USB C power supply. (For larger
© Adafruit Industries https://learn.adafruit.com/adafruit-matrixportal-m4 Page 5 of 96
projects, power the matrices with a separate 5V power adapter)
Then code up your project in CircuitPython (https://adafru.it/L7b) or Arduino (https://adafru.it/MNa), the
Adafruit Protomatter matrix library works great on the SAMD51 chipset, knowing that you've got the wiring
and level shifting all handled. Here's what you get:
ATSAMD51J19 Cortex M4 processor, 512KB flash, 192K of SRAM, with full Arduino or CircuitPython
support
ESP32 WiFi co-processor with TLS support and SPI interface to the M4, with full Arduino or
CircuitPython support
USB Type C connector for data and power connectivity
I2C STEMMA QT connector for plug-n-play use of any of our STEMMA QT devices or
sensors (https://adafru.it/NmD) can also be used with any Grove I2C devices using this adapter
cable (https://adafru.it/Ndk)
JST 3-pin connector that also has analog input/output, say for adding audio playback to
projects (https://adafru.it/Gpf)
LIS3DH accelerometer for digital sand projects or detecting taps/orientation.
GPIO breakouts including 4 analog outputs with PWM and SPI support for adding other hardware.
Address E line jumper for use with 64x64 matrices (check your matrix to see which pin is used for
address E!
Two user interface buttons + one reset button
Indicator NeoPixel and red LED
Green power indicator LEDs for both 3V and 5V power
2x10 socket connector fits snugly into 2x8 HUB75 ports without worrying about 'off by one' errors.
© Adafruit Industries https://learn.adafruit.com/adafruit-matrixportal-m4 Page 6 of 96
The Matrix Portal uses an ATMEL (Microchip) ATSAMD51J19, and an Espressif ESP32 Wi-Fi coprocessor
with TLS/SSL support built-in. The M4 and ESP32 are a great couple - and each bring their own strengths
to this board. The SAMD51 M4 has native USB, so it can show up like a disk drive, act as a MIDI or HID
keyboard/mouse, and of course bootload and debug over a serial port. It also has DACs, ADC, PWM, and
tons of GPIO, so it can handle the high speed updating of the RGB matrix.
Meanwhile, the ESP32 has secure WiFi capabilities, and plenty of Flash and RAM to buffer sockets. By
letting the ESP32 focus on the complex TLS/SSL computation and socket buffering, it frees up the SAMD51
© Adafruit Industries https://learn.adafruit.com/adafruit-matrixportal-m4 Page 7 of 96
to act as the user interface. You get a great programming experience thanks to the native USB with files
available for drag-n-drop, and you don't have to spend a ton of processor time and memory to do SSL
encryption/decryption and certificate management. It's the best of both worlds!
© Adafruit Industries https://learn.adafruit.com/adafruit-matrixportal-m4 Page 8 of 96
Pinouts
There are so many great features on the Adafruit MatrixPortal M4. Let's take a look at what's available!
Microcontroller and Flash
The main processor chip is the ATSAMD51J19 Cortex
M4 running at 120MHz with 3.3v logic/power. It has 512KB
of Flash and 192KB of RAM.
We also include 2 MB of QSPI Flash for storing images,
sounds, animations, whatever!
WiFi
© Adafruit Industries https://learn.adafruit.com/adafruit-matrixportal-m4 Page 9 of 96
The WiFi capability uses an Espressif ESP32 Wi-Fi
coprocessor with TLS/SSL support built-in.
The ESP32 uses the SPI port for data, and also uses a CS
pin ( board.ESP_CS or Arduino 33 ), Ready/Busy pin
(board.ESP_BUSY or Arduino 31 ), and reset pin
(board.ESP_RESET or Arduino 30 )
HUB75 Connector
There is a 2x8 pin HUB75 connector on the reverse side
that plugs directly into the HUB75 port on your RGB Matrix.
The socket itself is 2x10 so that it fits snug and lined up in
a 2x8 IDC socket. Otherwise its easy to get it 'off by one'
RGB Matrix Power
© Adafruit Industries https://learn.adafruit.com/adafruit-matrixportal-m4 Page 10 of 96
Tabla de contenidos
Otros manuales de Equipos educativos de adafruit learning system
Manuales populares de Equipos educativos de otras marcas
TruCorp
TruCorp AirSim Advance Manual de usuario
LeapFrog
LeapFrog Mr. Pencil's Scribble, Write & Read Manual de usuario
ScienTECH
ScienTECH 2261 Manual de usuario
Rompa
Rompa 20019 Manual de usuario
Duinotech
Duinotech XC4322 Manual de usuario
Enabling Devices
Enabling Devices Spinning Light Show Manual de usuario