Download the PHP package dept-of-scrapyard-robotics/jd79661 without Composer

Introduction

PHP Package for the JD79661 four-color ePaper (electronic ink) display controller. The JD79661 drives black/white/red/yellow panels, packing all four colors into a single RAM at 2 bits per pixel.

Compatible SPI Interfaces

The JD79661 display communicates with your device over SPI, the Serial Peripheral Interface.

You can interface with displays such as the JD79661 with this package the following ways:

• A Linux Single-Board Computer's exposed GPIO pins using the dedicated SPI MOSI/SCK and CS pins as well as GPIO pins for DC, RST and BUSY.
• An MPSSE-enabled USB-to-Serial device such as an FT232H generally using D0 and SCK, D1 for MOSI, D2 for MISO and D3 for CS, plus GPIO for RST/DC/BUSY and connected to nearly any Linux or MacOS USB port.

A BUSY input is required, the same as DC and RST. A full four-color refresh takes several seconds, and the driver blocks on the BUSY line to know when the panel has finished the update.

Dependencies

This package makes use of modules within:

• The ScrapyardIO Framework

This package also requires one of the following extensions in order to interface with SPI

• POSI Extension v^0.4.0 or newer
• FTDI Extension v^0.4.0 or newer

In addition, an extension wrapper package is needed

For ext-posi

• Microscrap POSIX Package v0.4.0 or newer
• Microscrap Native SPI Package v0.4.0 or newer
• Microscrap Native GPIO Package v0.4.0 or newer

For ext-ftdi

• Microscrap FTDI Package v0.4.0 or newer
• Microscrap MPSSE Package v0.4.0 or newer

Installing from Composer

Inside the root of your PHP Project, simply require the JD79661 package from composer

Framework Configuration

If you would like to use the ScrapyardIO Framework to bootstrap your display without wasting lines configuring your display right in the script you can add your desired configuration to scrapyard-io.php, such as in this example:

SPI

Basic Usage

Native (POSIX) SPI driver. (Single Board Computers)

USB (MPSSE) driver using SPI. (Linux and MacOS)

Alternative Usage

Using Through the Display Library (as a QuadColorePaperDisplay)

Using Through the Display Framework (with an autoloaded config) (as a QuadColorePaperDisplay)

Display API

The setters in this API interface with the device directly (register writes), so you can use property access while still working against the panel itself.

Readable Properties (Getters)

There are no readable magic properties exposed for the JD79661 in this package.

Writable Properties (Setters)

• $display->panel_setting = new JD79661PanelSetting(...); Sets the panel setting register (PSR).

• $display->power_setting = new JD79661PowerSetting(...); Sets the power setting register (PWR).

• $display->power_off_sequence = new JD79661PowerOffSequence(...); Sets the power-off sequence (POFS).

• $display->booster_soft_start = new JD79661BoosterSoftStart(...); Sets the booster soft-start configuration (BTST).

• $display->vcom_data_interval = new JD79661VcomDataInterval(...); Sets the VCOM and data interval (CDI).

• $display->tcon = new JD79661TCON(...); Sets the gate/source non-overlap timing (TCON).

• $display->pll_control = new JD79661PLLControl(...); Sets the PLL clock frequency (PLL).

• $display->power = true; Powers the panel on (true) or off (false).

Drawing on the Display

Draw with a Screen, which wraps a GFXRenderer over a ChannelSortedFrameBuffer matched to the panel's FormatSpec, then ships the bytes on render(). ePaper is a single slow full refresh, so paint one complete composition and render once.

Colors are EInkColor cases: WHITE, BLACK, RED and YELLOW. The driver merges them into the panel's single 2bpp RAM at transmit time.