Skip to content

Display the current Quadstick keys configuration on an e-ink display

License

Notifications You must be signed in to change notification settings

felipe-dos-santos81/quadstick-display

Repository files navigation

Quadstick e-ink display

Display the current Quadstick keys configuration on an e-ink display.

Useful as a quick reference for the current key bindings when playing games.

Legal Disclaimer

  • Quadstick is a trademark of Quadstick.
  • Raspberry Pi is a trademark of the Raspberry Pi Foundation.
  • Waveshare is a trademark of Waveshare Electronics.

All other trademarks mentioned herein are the property of their respective owners.

Handling Quadstick CSV files

Initialization Screen Upload and keys selection must be done through the web interface Display a given key-set can be done through the web
Init screen display_web_interface.jpg Key settings screen

Note: The CSV file stored on the Quadstick is the ones that must be used to upload.

The arrow represents the air flow direction

Sip is represented by left arrow Puff is represented by right arrow Sip soft and Puff soft are represented by the soft text
mp_sip.jpg mp_puff.jpg mq_puff_soft.jpg

3D Printed case View

Rear view Connectors view
3d_box_rear.jpeg 3d_box_connectors.jpeg

Hardware

Wiring

Waveshare Raspberry Pi
VCC Pin 1
GND Pin 6
DIN (MOSI) Pin 19
CLK (SCLK) Pin 23
CS (Chip Select) Pin 24
DC (Data/Command) Pin 22
RST (Reset) Pin 11
BUSY Pin 18

Raspberry Pi Pinout

Raspberry Pi Zero 2 W Pinout Waveshare 4.2 inch e-ink display
raspberry_pi_pinout.jpeg display_pinout.jpeg

Software

Download the Raspberry Pi Imager.

Use it to flash the Raspberry Pi OS Lite image to a microSD card.

For Raspberry Pi Zero 2 W: 64 Bit > Raspberry Pi OS (other) > Raspberry Pi OS Lite (64-bit)
For Raspberry Pi Zero W: 32 Bit > Raspberry Pi OS (other) > Raspberry Pi OS Lite (32-bit)

Expand for detailed instructions with screenshots

Raspberry Pi Imager Steps

Select Device #1 Select Device #2
rasp_img0.jpg rasp_img1.jpg
Choose OS #1 Choose OS #2
rasp_img2.jpg rasp_img3.jpg

On Raspberry Pi OS (other) category with NO Desktop Environment


Choose Storage Edit Settings #1
rasp_img4.jpg rasp_img5.jpg

Change the custom settings by clicking on the Edit Settings button


Raspberry Pi Custom Settings Steps

On the General tab
  1. Set the hostname to 'qs-display'
  2. Set the username and password as you prefer
  3. Set the Wi-Fi SSID, password and country code
    rasp_img6.jpg

Raspberry Pi Zero's support 2G Wi-Fi only

On the Services tab
  1. Enable SSH
    rasp_img7.jpg
  2. Press Save and then Write to flash the image to the microSD card

Note: SSH can be used with password or public-key based authentication.

Installing

Download the installer package from the releases

Copy the installer package file to the Raspberry Pi

How to copy the file to Raspberry Pi On Windows
  1. Download and install WinSCP
  2. Open WinSCP and enter the Raspberry Pi IP address, username and password
  3. Navigate to the folder where the installer file is located
  4. Drag and drop the file to the Raspberry Pi
How to copy the file to Raspberry Pi On Linux and MacOS
  1. Open a terminal
  2. Use scp to copy the file to the Raspberry Pi
scp quadstick-display.sh <username>@<raspberry_pi_ip>:/home/<username>

Access the Raspberry Pi using SSH

How to access the Raspberry Pi On Windows
  1. Download and install PuTTY
  2. Open PuTTY and enter the Raspberry Pi IP address
  3. Click Open and enter the username and password
  4. You should now be connected to the Raspberry Pi
How to access the Raspberry Pi On Linux and MacOS
  1. Open a terminal
  2. Use ssh to connect to the Raspberry Pi
  3. Enter the username and password
  4. You should now be connected to the Raspberry Pi

Install the installer package on the Raspberry Pi

chmod +x quadstick-display.sh && ./quadstick-display.sh