1. Introduction
This manual provides comprehensive instructions for the diymore 1.3 inch OLED Display HAT, an advanced expansion board designed to enhance your Raspberry Pi or Jetson Nano projects. Featuring a crisp 128x64 pixel OLED display with an embedded SH1106 driver, this HAT offers versatile communication options including 4-wire SPI, 3-wire SPI, and I2C interfaces. It also integrates a 5-position joystick and three pushbuttons for intuitive user interaction, making it ideal for various embedded applications requiring a compact visual interface and input controls.
2. Product Overview
The diymore 1.3 inch OLED Display HAT is a compact and powerful display solution. It connects directly to the 40PIN GPIO header of your Raspberry Pi or Jetson Nano, providing a clear blue display for system information, sensor readings, or custom graphics. The integrated joystick and buttons allow for easy menu navigation and input without requiring additional external components.

Figure 2.1: The 1.3 inch OLED HAT connected to a Raspberry Pi, displaying system information.

Figure 2.2: Front view of the OLED HAT, highlighting the display, 5-position joystick, and three user-programmable pushbuttons (KEY1, KEY2, KEY3).

Figure 2.3: Back view of the OLED HAT, illustrating the 40-pin GPIO connector and the configuration jumpers for 4-wire SPI, 3-wire SPI, or I2C interfaces.
3. Specifications
| Feature | Description |
|---|---|
| Display Type | OLED |
| Display Size | 1.3 inch (diagonal) |
| Resolution | 128x64 pixels |
| Display Color | Blue |
| Driver IC | SH1106 |
| Interface | 4-wire SPI, 3-wire SPI, I2C (configurable) |
| Operating Voltage | 3.3V |
| GPIO Header | Standard Raspberry Pi 40PIN |
| Input Controls | 1x 5-position joystick, 3x pushbuttons (KEY1, KEY2, KEY3) |
| Dimensions | 6.5 cm x 3 cm (approx. 2.6 in x 1.2 in) |
| Compatibility | Raspberry Pi series boards (2B/3B/Zero/W), Jetson Nano |

Figure 3.1: Physical dimensions of the OLED HAT.
4. Setup and Installation
Follow these steps to properly install and set up your OLED Display HAT:
- Unpack the Contents: Carefully remove the OLED HAT and any included mounting hardware (standoffs, screws, nuts) from its packaging.
- Interface Configuration: The HAT supports 4-wire SPI, 3-wire SPI, and I2C interfaces. The desired interface is configured via onboard resistors (jumpers or solder pads). Refer to the back of the board (Figure 2.3) and the provided development resources for specific instructions on how to select your preferred communication protocol. Ensure the correct interface is selected before connecting to your host device.
- Physical Connection: Align the 40PIN GPIO connector on the OLED HAT with the corresponding GPIO pins on your Raspberry Pi or Jetson Nano. Gently press down to ensure a secure connection.
- Mounting (Optional): Use the provided standoffs and screws to securely mount the OLED HAT to your Raspberry Pi board, if desired. This provides stability and protects the connections.
- Software Setup: The display requires software libraries and drivers to function. Refer to the official development resources (examples for Arduino/Raspberry Pi/Jetson Nano/STM32) for detailed instructions on installing the necessary software, libraries, and example code for your specific platform and chosen interface. This typically involves enabling the SPI or I2C interface on your host device and installing the SH1106 driver library.

Figure 4.1: The OLED HAT and its accompanying mounting hardware.
5. Operating Instructions
Once the hardware is connected and the software environment is set up, you can begin operating your OLED Display HAT:
- Power On: Power on your Raspberry Pi or Jetson Nano. The OLED display should initialize according to your software configuration.
- Display Content: Use the provided software examples or develop your own code to display text, graphics, or system information on the 128x64 pixel screen.
- Using the Joystick and Buttons: The 5-position joystick (Up, Down, Left, Right, Center press) and the three pushbuttons (KEY1, KEY2, KEY3) can be programmed to control your applications, navigate menus, or trigger specific functions. Consult the development resources for programming examples that demonstrate how to read input from these controls.
- Programming: The HAT comes with development resources and manual (examples for Arduino/Raspberry Pi/Jetson Nano/STM32). These resources will guide you through writing code to interact with the SH1106 driver and the input controls.
6. Maintenance
To ensure the longevity and optimal performance of your OLED Display HAT, consider the following maintenance tips:
- Cleaning: Gently wipe the display surface with a soft, dry, anti-static cloth. Avoid using harsh chemicals or abrasive materials that could scratch the screen.
- Handling: Always handle the board by its edges to avoid touching the electronic components or the display surface directly.
- Static Electricity: Take precautions against electrostatic discharge (ESD) when handling the board, as static can damage sensitive electronic components.
- Storage: When not in use, store the HAT in an anti-static bag in a cool, dry place away from direct sunlight and extreme temperatures.
7. Troubleshooting
If you encounter issues with your OLED Display HAT, try the following troubleshooting steps:
- No Display:
- Ensure the HAT is securely seated on the Raspberry Pi's GPIO pins.
- Verify that the Raspberry Pi is powered on.
- Check your software code for errors and ensure the correct display driver (SH1106) and interface (SPI/I2C) are initialized.
- Confirm that the interface configuration (onboard resistors/jumpers) matches your software settings.
- Incorrect Display/Garbled Text:
- Double-check your software initialization parameters, such as resolution and communication protocol.
- Ensure the correct libraries for the SH1106 driver are installed and up to date.
- Joystick/Buttons Not Responding:
- Verify that your software is correctly reading input from the GPIO pins connected to the joystick and buttons.
- Check for any physical obstructions or damage to the controls.
- Power Issues: Ensure your Raspberry Pi is receiving adequate power, especially if other peripherals are connected.
8. User Tips
While no specific user tips were provided in the available data, here are some general recommendations for working with OLED HATs:
- Start with Examples: Always begin by running the provided example code for your specific platform (Raspberry Pi, Jetson Nano, Arduino, STM32) to confirm basic functionality before developing custom applications.
- Consult Online Communities: For advanced projects or specific programming challenges, online forums and communities dedicated to Raspberry Pi, Jetson Nano, and OLED displays can be invaluable resources.
- Power Management: OLED displays can be susceptible to burn-in if static images are displayed for extended periods. Implement screen savers or dynamic content to mitigate this risk.
9. Warranty and Support
For any technical assistance, warranty claims, or further inquiries regarding your diymore 1.3 inch OLED Display HAT, please contact the seller directly through the platform where the purchase was made. Ensure you have your order details readily available to facilitate a quicker resolution.





