raspberry pi lcd display tutorial in stock

If you plan on using an LCD with your Raspberry Pi, there’s a good chance you’ll need to program it in Python at some point. Python is probably the most popular programming language for coding on the Raspberry Pi, and many of the projects and examples you’ll find are written in Python.

In this tutorial, I’ll show you how to connect your LCD and program it in Python, using the RPLCD library. I’ll start with showing you how to connect it in either 8 bit mode or 4 bit mode. Then I’ll explain how to install the library, and provide examples for printing and positioning text, clearing the screen, and controlling the cursor. I’ll also give you examples for scrolling text, creating custom characters, printing data from a sensor, and displaying the date, time, and IP address of your Pi.

BONUS: I made a quick start guide for this tutorial that you can download and go back to later if you can’t set this up right now. It covers all of the steps, diagrams, and code you need to get started.

You can also connect the LCD via I2C, which uses only two wires, but it requires some extra hardware. Check out our article, How to Setup an I2C LCD on the Raspberry Pi to see how.

There are two ways to connect the LCD to your Raspberry Pi – in 4 bit mode or 8 bit mode. 4 bit mode uses 6 GPIO pins, while 8 bit mode uses 10. Since it uses up less pins, 4 bit mode is the most common method, but I’ll explain how to set up and program the LCD both ways.

Each character and command is sent to the LCD as a byte (8 bits) of data. In 8 bit mode, the byte is sent all at once through 8 data wires, one bit per wire. In 4 bit mode, the byte is split into two sets of 4 bits – the upper bits and lower bits, which are sent one after the other over 4 data wires.

Theoretically, 8 bit mode transfers data about twice as fast as 4 bit mode, since the entire byte is sent all at once. However, the LCD driver takes a relatively long time to process the data, so no matter which mode is being used, we don’t really notice a difference in data transfer speed between 8 bit and 4 bit modes.

If this is your first time writing and running a Python program, you might want to read How to Write and Run a Python Program on the Raspberry Pi, which will explain everything you need to know to run the examples below.

The RPLCD library can be installed from the Python Package Index, or PIP. It might already be installed on your Pi, but if not, enter this at the command prompt to install it:

The example programs below use the Raspberry Pi’s physical pin numbers, not the BCM or GPIO numbers. I’m assuming you have your LCD connected the way it is in the diagrams above, but I’ll show you how to change the pin connections if you need to.

Let’s start with a simple program that will display “Hello world!” on the LCD. If you have a different sized LCD than the 16×2 I’m using (like a 20×4), change the number of columns and rows in line 2 of the code. cols= sets the number of columns, and rows= sets the number of rows. You can also change the pins used for the LCD’s RS, E, and data pins. The data pins are set as pins_data=[D0, D1, D2, D3, D4, D5, D6, D7].

The text can be positioned anywhere on the screen using lcd.cursor_pos = (ROW, COLUMN). The rows are numbered starting from zero, so the top row is row 0, and the bottom row is row 1. Similarly, the columns are numbered starting at zero, so for a 16×2 LCD the columns are numbered 0 to 15. For example, the code below places “Hello world!” starting at the bottom row, fourth column:

The RPLCD library provides several functions for controlling the cursor. You can have a block cursor, an underline cursor, or a blinking cursor. Use the following functions to set the cursor:

Text will automatically wrap to the next line if the length of the text is greater than the column length of your LCD. You can also control where the text string breaks to the next line by inserting \n\r where you want the break to occur. The code below will print “Hello” to the top row, and “world!” to the bottom row.

This program will print the IP address of your ethernet connection to the LCD. To print the IP of your WiFi connection, just change eth0 in line 19 to wlan0:

Each character on the LCD is an array of 5×8 of pixels. You can create any pattern or character you can think of, and display it on the screen as a custom character. Check out this website for an interactive tool that creates the bit array used to define custom characters.

First we define the character in lines 4 to 12 of the code below. Then we use the function lcd.create_char(0-7, NAME) to store the character in the LCD’s CGRAM memory. Up to 8 (0-7) characters can be stored at a time. To print the custom character, we use lcd.write_string(unichr(0)), where the number in unichr() is the memory location (0-7) defined in lcd.create_char().

To demonstrate how to print data from a sensor, here’s a program that displays the temperature from a DS18B20 Digital Temperature Sensor. There is some set up to do before you can get this to work on the Raspberry Pi, so check out our tutorial on the DS18B20 to see how.

In general, you take the input variable from your sensor and convert it to an integer to perform any calculations. Then convert the result to a string, and output the string to the display using lcd.write_string(sensor_data()):

Well, that about covers most of what you’ll need to get started programming your LCD with Python. Try combining the programs to get some interesting effects. You can display data from multiple sensors by printing and clearing the screen or positioning the text. You can also make fun animations by scrolling custom characters.

After I posted my Raspberry Pi server room rack temperature monitor project, I received many questions on how to integrate LCD displays with the Pi. This video is the first in a series of tutorials:

R is the resistor value in ohms and Vdd is the supply voltage. VLED and ILED are the typical LED voltage and current respectively as specified in the LCD display datasheet. Even if you display supports 5 V you might want to add a resistor or variable resistor to control the brightness. The same holds true for the contrast pin. I normally use variable resistors for both (see below).

I’ll demonstrate 2 different Python modules for controlling the LCD display. The first is a modified version of lcd.py by Raspberry Pi Spy which can be downloaded below.

You can use any GPIO pins for the LCD RS, E, & D1 – D4. The GPIO to LCD pin mappings are specified in the LCD.py file. If you change from the default below then you have to update the file with your new selections.

Here is some sample code (updated 4/23/16) to demonstrate the Adafruit library. As with the LCD.py module, you can use any GPIO pins. You specify the GPIO to LCD pin mappings when you instantiate the Adafruit_CharLCD class. Please note that super-user privileges are no longer required for GPIO access with the latest version of Raspbian

A potentiometer can be added to the LCD display C pin to control the contrast. The pin is connected to the wiper of the pot which is usually the middle pin. One of the outside pins is connected to ground and the other to Vcc. It doesn’t matter which outside pin goes to Vcc or ground because the pot is acting as a voltage divider either way. As the dial is turned the wiper’s pin voltage will vary from 0 to 5 V and this will cause the contrast to change. 10 KΩ is a good value for the pot. This same wiring will also work to control the LCD display brightness. Instead of of the contrast pin, the wiper would be connected to the LED back light anode. Most LCD display back lights will tolerate 5 V but please double check so you don’t damage the LED. You can alter the 0 – 5 V range by adding a resistor in series with one of the outside pins. This can help fine tune the amount of range provided by the pot. You can use a multimeter to measure the voltage on the wiper and determine how different resistors affect the range. Here is a simple schematic:

The Adafruit IP clock example from the video is no longer compatible with the latest version of the Adafruit LCD_Char library. Here is an updated version of the IP clock program. Please note that sudo is no longer necessary to run the program with the latest version of Raspbian, but you still need the shebang line and chmod +x to give the file executable permissions, if you run it from the command line.

The Adafruit_Python_CharLCD library has been deprecated since this tutorial was released in 2014. Therefore, I’m including an example using the newer Adafruit_CircuitPython_CharLCD library which can run on both the Raspberry Pi and other CircuitPython compatible boards. I have several CircuitPython tutorials. The library can easily be installed using pip:

It is possible to connect multiple LCD displays to a Raspberry Pi. Normally I’d recommend using an I²C display as discussed in my Using an I²C LCD Display with a Raspberry Pi tutorial because the wiring is less complicated. However, LCD displays can be daisy chained in 4 bit mode. The second display is connected to the existing GPIO pins for RS and D1 – D4, but each display must have a unique GPIO pin for Enable.

That’s right! In today’s tutorial I show you how to wire up and program your very own mini LCD display to your Raspberry Pi! By the end the of this video you will be printing your own messages to your very own screen module and will understand all of the Python code behind it. A good, cheap and enjoyable little project for Raspberry Pi – with plenty of scope for your own further developments!

One useful thing is to enable the Raspberry Pi to launch the stock symbol display on boot so you don’t need to run the script by hand each time the Raspberry Pi

There is a possibility when running the display_stock.py script you will get an error related to the numpy package (especially if you’re running on a Pi

I found an LCD in the surplus store that didn"t have much information, but after some searching and playing around, saw that it was based of the popular HD44780U. This is a 16 character LCD, and looks like 16x1 unit

I used Adafruit"s tutorial to set it up - see http://learn.adafruit.com/drive-a-16x2-lcd-directly-with-a-raspberry-pi/overview for more information - I"ll not repeat how to set up the circuit here. The main difference is that this LCD has only 15 leads, not 16, and the last 15th lead is for a non-existent backlit display. Ignore the 16th lead in Adafruit"s setup.

I also used Adafruit"s python library for character LCD displays - Adafruit_CharLCD.py - however, I had to make a few important modifications for my needs. First of all, I made some changes for it to support the 8x2 display (to automatically scroll over to the 2nd line when the first 8 characters have been filled up).

I also modified it to support any arbitrary length string, by displaying 16 (8x2) characters at a time, and then going to the next 16, and so on, until the end.

I also added another method to support scrolling text. With a simple call, the LCD will do a marquee type scrolling of the text. The caller can provide it any arbitrary length string without worrying about scrolling details. I tried to search for any existing work doing this already, but could not, so hopefully this will help others looking for something similar.

I used the pycurl library to invoke yahoo"s api and get the results - thanks to http://www.gummy-stuff.org/Yahoo-data.htm for the pointers in the right direction.

I"ve also attached my modifications to Adafruit_CharLCD.py - replace that in your environment with this file (first back that up, by copying it to Adafruit_CharLCD.py.bak (that"s the convention I use)).

Depending on your display stand, you might find that the LCD display defaults to being upside-down. You can fix this by rotating it with /boot/config.txt.

If some windows in X are cut off at the side/bottom of the screen, this is unfortunately a side-effect of developers assuming a minimum screen resolution of 1024x768 pixels.

At the moment you can’t use HDMI and the LCD together in the X desktop, but you can send the output of certain applications to one screen or the other.

You may need to increase the amount of memory allocated to the GPU to 128MB if the videos are 1080P. Adjust the gpu_mem value in config.txt for this. The Raspberry Pi headline figures are 1080P30 decode, so if you are using two 1080P clips it may not play correctly depending on the complexity of the videos.

Raspberry Pi is an ARM architecture processor based board designed for electronic engineers and hobbyists. The PI is one of most trusted project development platforms out there now. With higher processor speed and 1 GB RAM, the PI can be used for many high profile projects like Image processing and IoT.

For doing any of high profile projects, one need to understand the basic functions of PI. We will be covering all the basic functionalities of Raspberry Pi in these tutorials. In each tutorial we will discuss one of functions of PI. By the end of this Raspberry Pi Tutorial Series, you will be able to do high profile projects by yourself. Go through below tutorials:

In this tutorial, we will Control a 16x2 LCD Display using Raspberry Pi. We will connect the LCD to GPIO (General Purpose Input Output) pins of PI to display characters on it. We will write a program in PYTHON to send the appropriate commands to the LCD through GPIO and display the needed characters on its screen. This screen will come in handy to display sensor values, interrupt status and also for displaying time.

There are different types of LCDs in the market. Graphic LCD is more complex than 16x2 LCD. So here we are going for 16x2 LCD display, you can even use 16x1 LCD if you want. 16x2 LCD has 32 characters in total, 16 in 1st line and another 16 in 2nd line. JHD162 is 16x2 LCD Module characters LCD. We have already interfaced 16x2 LCD with 8051, AVR, Arduino etc. You can find all our 16x2 LCD related project by following this link.

There are 40 GPIO output pins in Raspberry Pi 2. But out of 40, only 26 GPIO pins (GPIO2 to GPIO27) can be programmed. Some of these pins perform some special functions. With special GPIO put aside, we have 17 GPIO remaining.

There are +5V (Pin 2 or 4) and +3.3V (Pin 1 or 17) power output pins on the board, these are for connecting other modules and sensors. We are going to power the 16*2 LCD through the +5V rail.We can send control signal of +3.3v to LCD but for working of LCD we need to power it by +5V. The LCD will not work with +3.3V.

Here we are using Raspberry Pi 2 Model B with Raspbian Jessie OS. All the basic Hardware and Software requirements are previously discussed, you can look it up in the Raspberry Pi Introduction, other than that we need:

As shown in the Circuit Diagram, we have Interfaced Raspberry Pi with LCD display by connecting 10 GPIO pins of PI to the 16*2 LCD’s Control and Data Transfer Pins. We have used GPIO Pin 21, 20, 16, 12, 25, 24, 23, and 18 as a BYTE and created ‘PORT’ function to send data to LCD. Here GPIO 21 is LSB (Least Significant Bit) and GPIO18 is MSB (Most Significant Bit).

16x2 LCD Module has 16 pins, which can be divided into five categories, Power Pins, contrast pin, Control Pins, Data pins and Backlight pins. Here is the brief description about them:

6. Once this E pin goes low, the LCD process the received data and shows the corresponding result. So this pin is set to high before sending data and pulled down to ground after sending data.

As said we are going to send the characters one after the other. The characters are given to LCD by ASCII codes (American standard Code for Information Interchange). The table of ASCII codes is shown below. For example, to show a character “@”, we need to send a hexadecimal code “40”. If we give value 0x73 to the LCD it will display “s”. Like this we are going to send the appropriate codes to the LCD to display the string “CIRCUITDIGEST”.

We are going to import GPIO file from library, below function enables us to program GPIO pins of PI. We are also renaming “GPIO” to “IO”, so in the program whenever we want to refer to GPIO pins we will use the word ‘IO’.

Sometimes, when the GPIO pins, which we are trying to use, might be doing some other functions. In that case, we will receive warnings while executing the program. Below command tells the PI to ignore the warnings and proceed with the program.

We can refer the GPIO pins of PI, either by pin number on board or by their function number. Like ‘PIN 29’ on the board is ‘GPIO5’. So we tell here either we are going to represent the pin here by ‘29’ or ‘5’.

If your display is equipped with an IC2 module, it’s not that difficult to connect an LCD display to a Raspberry Pi. Learn with this tutorial how to connect and to program an 1602 LCD with a Raspberry Pi.

There are many types of LCD displays. In this tutorial we are using the popular and affordable 1602 LCD. The LCD has an IC2 module soldered on it (see the pictures below). If your LCD is of the same type, but has a different size, it won’t be a problem to continue with this tutorial. You’ll just have to correct some parameters in the Python script. But if it is from a different type or it has no I2C module, you better look for another tutorial.Prepare the hardware

– First, you need to have a Raspberry Pi running on the latest version of Raspberry Pi OS. This version includes “Thonny”. We’ll use this user-friendly IDE to write our Python code. If you’re not familiar with Python or with Thonny or GPIO-pins, I suggest to have a look at our tutorials “How to write your first Python program on the Raspberry Pi” and/or “How to use the Raspberry Pi GPIO pins” to have a quick introduction.

In this tutorial we are using the popular and quite basic 16×2 or 1602 LCD. It can display 16 characters per line on 2 lines. Each character is made from a matrix with 5×7 dots. It is equipped with a backlight for easy reading. Besides sending text, thanks to specific commands, we can give instructions to the display, as to switch on/off the backlight for example.

The display we use in this tutorial is equipped with a I2C-module (black part on the picture below). I2C is a communication protocol which allows an easier connection between the display and the Raspberry Pi. Indeed, instead of having to wire all the pins on the top of the screen, we only have to connect the display with 4 wires to our Raspberry Pi.

Each I2C device has its own I2C address. Often this address is hard-wired in the device and will vary from manufacturer to manufacturer. If you don’t know the address of your I2C device, connect the device to your Raspberry Pi (see the next step). Then, open a terminal window and enter following command :

If you bought one of our kits, the hexadecimal address of the LCD is ‘0x27’. We will need the I2C address from the display to insert it in our Python code.

Be careful ! Before starting to connect wires on the GPIO pins of your Raspberry Pi, make sure you properly shut down the Pi and removed the power cable from the board!

To avoid extensive and complicated code writing, libraries are often used. For our LCD, we will also be using a library. We found the most appropriate library at GitHub from Dave Hylands . As these files from this quite specific library don’t come automatically with Python, we have to install them ourselves.

So, before writing the code, we’ll have to upload the files to our Raspberry Pi. You can download a ZIP-folder containing the 2 files to be installed here.

Download and unzip the files. If you did this operation on your computer, upload the files to your Raspberry Pi. And if you don’t know how to do that, have a look at our tutorial ‘How to transfer files between Raspberry Pi and PC‘. Make sure you upload them in the same folder as the new file we will create for our main code. And don’t change the filenames of the library of course.

And before running the script, it’s important to adjust the contrast of your LCD. If the contrast isn’t adjusted well, it’s possible you don’t see appearing anything. You can adjust it by turning with a small screwdriver at the blue potentiometer at the back of your LCD (see the pictures here above). Make sure the backlight of the display is on to see the result. If the LCD’s contrast is adjusted right, you can just see the darker rectangles for the characters appear.

Besides the commands we used in the last lines of our script, there are more possibilities to communicate with the LCD. If you want to learn more about, have a look at this Github webpage.

Compatible and Direct-connect with any revision of Raspberry Pi. (If you are using a Raspberry Pi Zero / Zero 2 W, an additional HDMI cable is required).

Raspberry Pi leads out 40 GPIO pins, while the screen leads out 26 pins. When connecting, pay attention to the corresponding pins and Raspberry Pi pins.

5) Insert the TF card into the Raspberry Pi, power on the Raspberry Pi, and wait for more than 10 seconds to display normally. But the touch is abnormal at that time, and the touch needs to be calibrated as the following steps.

You can perform touch calibration by clicking the Raspberry Pi icon on the taskbar, selecting Preferences -> Calibrate Touchscreen, and following the displayed prompts.

4. After calibration, the following data will be displayed. If you want to save these touch values, you can replace the data in the red circle with the data in the corresponding position in 99-calibration.conf.

Since the ads7846.dtbo provided by Raspberry Pi by default has no de-jitter parameters, you can increase the de-jitter parameters by modifying and replacing ads7846.dtbo

In this tutorial Tony Goodhew explains how to use the basic graphics procedures which are included in the display driver, and for the ambitious makers out there he also provides examples for advanced shapes and graphics!

All the other graphical and text objects we would like to display can be built from this single pixel instruction; such as lines, circles, rectangles, triangles and text strings at different sizes.

This is all carried out with code. Display manufacturers usually supply some of these procedures/methods but leave the rest up to the end user to construct.

The third line here imports the Framebuffer library which includes several very useful routines to draw objects on the display. The garbage collection library, gc, has also been imported so that we can check how much memory is available.

The following methods draw shapes (such as those above) onto the FrameBuffer. They only become visible to the user once the lcd.show() instruction is executed.

If c is not given, get the colour value of the specified pixel – useful for collision detection in a game. If c is given, set the specified pixel to the given colour.

Draw a line from a set of coordinates using the given colour and a thickness of 1 pixel. The line method draws the line up to a second set of coordinates whereas the hline and vline methods draw horizontal and vertical lines respectively up to a given length.

Draw a rectangle at the given location, size and colour. The rect method draws only a 1-pixel outline whereas the fill_rect method draws both the outline and interior.

Write text to the FrameBuffer using the coordinates as the upper-left corner of the text. The colour of the text can be defined by the optional argument but is otherwise a default value of 1. All characters have dimensions of 8x8 pixels and there is currently no way to change the font.

Draw another FrameBuffer on top of the current one at the given coordinates. If key is specified then it should be a colour integer and the corresponding colour will be considered transparent: all pixels with that colour value will not be drawn.

Each program contains the screen driver code, sets up the buttons/joystick (if applicable), sets the width and height variables, loads the essential libraries, defines the colour (R, G, B) and clear (c) procedures, then displays some colour checking text like this:

Using lcd.fill_rect, fill the whole screen green and then fill the middle of the screen black, leaving a 10 pixel border. Put red 10-pixel squares in each corner.

Draw diagonal lines in blue across the screen from opposite corners and a yellow, filled square, 21 pixel wide, near the centre. Draw an orange outline diamond touching the centre points of the sides of the square.

Draw a dark grey rectangle in the centre of the screen. Draw 500 white pixels inside the square, none touching the edge. (Random was explained in the previous display tutorial.)

This is routine is very complicated. It splits the original triangle into two with a horizontal line and then fills them in. If you uncomment all the # lcd.show() lines and sleep instructions it will slow right down and you can see it working (unfortunately, the 2” display needs such a large buffer that there is not enough memory for the filled triangles code):

For the imports we added the math library as this is needed for Sin and Cos in graph plotting. The random library has also been imported, for the randomly generated triangles. These are followed by the basic LCD board setup we covered earlier.

Plotting Sine and Cosine curves requires quite a bit of complicated mathematics, using the math library, but it demonstrates the use of single pixels:

In the centre of the screen display a ‘bull’s eye’ circular target with a ‘gold’ centre, 4 other colours and scores 10, 8, 6, 4 and 2 written in the appropriate positions.

You may have noticed that on some screens the text is very small and difficult to read. In a following tutorial will add an extra font, with more characters, which we can display in different sizes.

This article was written by Tony Goodhew. Tony is a retired teacher of computing who starting writing code back in 1968 when it was called programming - he started with FORTRAN IV on an IBM 1130! An active Raspberry Pi community member, his main interests now are coding in MicroPython, travelling and photography.

This LCD display supports Raspbian, Ubuntu MATE, Snappy Ubuntu Core, OSMC, and Windows 10 IOT Core and so on. Please download your system image from raspberry Pi official website: https://www.raspberrypi.org/downloads/

The 5″ LCD display is an LCD display which connects to the Raspberry Pi through the DSI connector. It is capacitive touch LCD. It is a plug-and-play device which doesn’t need install driver. The physical resolution of this LCD display is 800*480.

The touch screen can be used as a mouse device. When we need to input text data to Raspberry Pi board, normally we have to connect a USB keyboard to Pi and this is really inconvenient.

LCD displays have an optimum viewing angle, and depending on how the screen is mounted it may be necessary to change the orientation of the display to give the best results. By default, the Raspberry Pi display and Raspberry Pi are set up to work best when viewed from slightly above, for example on a desktop. If viewing from below, you can physically rotate the display, and then tell the system software to compensate by running the screen upside down.

HyperPixel 2.1 Round has all the great features of our other HyperPixels - crisp, brilliant IPS display, touchscreen, and high-speed DPI interface—it"s just rounder! You can use it with any Raspberry Pi with a 40 pin header* but it works particularly nicely with the Pi Zero footprint - we"ve designed it so you can mount a Zero neatly behind it, so you can"t see the Pi when you look at it from the front.

This version of HyperPixel would be great for custom interfaces and control panels - mounted on a wall it would make a really neat, minimalist smart home controller or a stylish "what"s playing" display for your sound system. Everything is pre-soldered and ready to go, just pop it onto your Pi, install our software, and away you go!

* Please note that standoffs and booster headers are not included with Hyperpixel Round - scroll down or check out the extras tabs for some links. You will need a booster header if you want to use Hyperpixel Round with a full size Pi!

HyperPixel 2.1 Round uses a high-speed DPI interface, allowing it to shift 5x more pixel data than the usual SPI interface that these small Pi displays normally use. It has a 60 FPS frame rate and a resolution of approximately 229 pixels per inch (480x480px) on its 2.1" display. The display can show 18-bits of colour (262,144 colours).

The touchscreen variant is capacitive touch, that"s more sensitive and responsive to touch than a resistive touch display, and it"s capable of multi-touch!**

Hyperpixel Round will work with any 40-pin version of the Pi, including Pi Zero and Pi Zero W. If you"re using it with a full-size Pi then you"ll need a booster header to raise it up over the Pi"s USB ports and extended standoffs if you"d like to bolt it in place. If you"re using a Pi Zero or Pi Zero W you won"t need a booster header, but we have some special short standoffs that will let you attach everything securely together in an extra slim package.

If you"re using standoffs to fasten your Hyperpixel and your Pi together, just screw them into the posts on the underside of the HyperPixel PCB and then secure with screws through the mounting holes on your Pi.

Please note: when installing HyperPixel 2.1 Round onto your Pi make sure not to press down on the screen surface. We recommend putting the screen face down on a soft surface and gently wiggling the Pi to mate with the extended header (or GPIO header). If you need to remove your Hyperpixel, take care not to pull on the edges of the glass display - it"s best to hold on to the rectangular PCB. As the glass edges of this display overhang the PCB they"re quite exposed, so it"s worth being extra careful with them.

With this version of HyperPixel, we"ve separated the display drivers and touch drivers which should hopefully make it easier to incorporate touch interfaces into your own programs. To download and install the display drivers:

Note that you"ll need another display, keyboard, and mouse to install the software, or you could do it remotely over SSH if you set your Pi up headlessly.

HyperPixel uses basically all of the GPIO pins o communicate with the Pi (including the standard I2C pins) so it"s not generally possible to use it with other HATs and devices that connect via the GPIO...

...but we have provided an alternate I2C interface broken out on the back that will let you use I2C devices (like sensor breakouts) at the same time as HyperPixel. There are instructions how to set this up in our Hyperpixel 4.0 tutorial (scroll down to the bottom).

Raspberry Pi OS Bullseye includes major changes to how DPI display drivers work - a quick hack to get the screen working (with some loss of rotation/touch functionality) is to comment out dtoverlay=vc4-kms-v3d in boot/config.txt. We"re working on full support for Bullseye, but if you"re after an easy, fully featured Hyperpixel experience you should probably stick with Buster for now:

Display HAT Mini features a bright 18-bit capable 320x240 pixel display with vibrant colours and formidable IPS viewing angles, connected via SPI. It"s got four tactile buttons for interacting with your Pi with your digits and a RGB LED for notifications. We"ve also squeezed in a QwST connector (Qwiic / STEMMA QT) and a Breakout Garden header so it"s a doddle to connect up different kinds of breakouts.

It will work with any model of Pi with a 40 pin header, but we think it goes with the Raspberry Pi Zero particularly well - we"ve included a pair of standoffs so you can use to bolt HAT and Pi together to make a sturdy little unit. To accommodate the screen Display HAT Mini is a bit bigger than a standard mini HAT or pHAT - it"s around 5mm taller than a Pi Zero (so a Mini HAT XL or a Mini HAT Pro, if you will).

Display HAT Mini lets you turn a Raspberry Pi into a convenient IoT control panel, a tiny photo frame, digital art display or gif-box, or a desktop display for news headlines, tweets, or other info from online APIs. This screen is a handy 3:2 ratio, useful for retro gaming purposes!

To get started, follow the installation instructions in the Display HAT Mini library. This library contains some examples of how to use the screen, buttons and LED with Pygame. You can also find examples for this screen in our ST7789 Python library, these show you how to write and draw on the screen using PIL to display shapes, text and gifs.

We"ve also been having fun with fbcp-ili9341 - a high level framebuffer driver for SPI-based LCD displays. The Raspberry Pi OS desktop is a leeetle small on a 2.0" screen, but this might be a good option if you"re doing something like building your own custom retro console.

If you have a Breakout Garden breakout without a Qw/ST connector, you can either pop one of these adaptors on the end of your cable, or you can plug a Breakout Extender into the header at the other end of Display HAT Mini (you can find it next to your Pi"s SD card slot).

Please note that because of Display HAT Mini"s extra size, it will overhang adjacent slots on expansion boards like pHAT Stack, Black HAT Hacker, HAT Hacker HAT and Flat HAT Hacker. No shame - every HAT is valid, every HAT is beautiful.

We"ve found two standoffs to be sufficient to keep this HAT firmly in place, but if you want to add standoffs at every corner of your Zero so you can use it to stop a tank or something you can pick up more here.