st7565
This crate aims to provide an embedded-graphics compatible driver for displays based on the ST7565 chipset.
The following example is intended for the DOGM132W-5 display connected to an nRF52840 microcontroller.
Note the MODE_3 of the SPI. The DOGM132W-5 display expects the clock to be configured
with CPOL=1 and CPHA=1, which is also called SPI Mode 3.
```rust // Create DOGM132W-5 spi bus let dispspi = SPIInterface::new( hal::Spim::new( peripherals.SPIM0, hal::spim::Pins { sck: dispscl, mosi: Some(dispsi), miso: None, }, hal::spim::Frequency::M8, hal::spim::MODE3, 0, ), dispa0, dispcs, );
// Create DOGM132W-5 display driver let mut pagebuffer = GraphicsPageBuffer::new(); let mut disp = ST7565::new(dispspi, DOGM132W5).intographicsmode(&mut pagebuffer); disp.reset(&mut disprst, &mut timer).unwrap(); disp.flush().unwrap(); disp.setdisplayon(true).unwrap();
// Draw on it using the embeddedgraphics library Circle::new(Point::new(10, 6), 20) .intostyled(PrimitiveStyle::with_stroke(BinaryColor::On, 2)) .draw(&mut disp) .unwrap(); disp.flush().unwrap(); ```
Note the DOGM132W5 object. This is the display specification that contains all the display specific configuration options that need to be applied to the ST7565 chip.
Further note the into_graphics_mode() call, which switches the driver from its initial
mode to the embedded-graphics driver mode.
The disp object can then be used as a DrawTarget in embedded-graphics calls.
After drawing something, a flush() call has to be issued to actually
send the modified data to the display.
The example above uses the DOGM132W5 struct in the [ST7565::new()] call.
To initialize the ST7565 driver struct with a different display, a new display
specification has to be created. This can be done by creating an empty struct that
implements the [DisplaySpecs] trait.
For example, the definition of the DOGM132W5 struct looks like this:
rust
pub struct DOGM132W5;
impl DisplaySpecs<132, 32, 4> for DOGM132W5 {
const FLIP_ROWS: bool = false;
const FLIP_COLUMNS: bool = true;
const INVERTED: bool = false;
const BIAS_MODE_1: bool = false;
const POWER_CONTROL: PowerControlMode = PowerControlMode {
booster_circuit: true,
voltage_regulator_circuit: true,
voltage_follower_circuit: true,
};
const VOLTAGE_REGULATOR_RESISTOR_RATIO: u8 = 0b011;
const ELECTRONIC_VOLUME: u8 = 0b011111;
const BOOSTER_RATIO: BoosterRatio = BoosterRatio::StepUp2x3x4x;
}
The exact values for the respective display have to be taken from the display's manual.
If you created a specification for a new display, please open a pull request on https://github.com/Finomnis/st7565/pulls to make it available to the public.
