cleanup

Author: nonik0

Cargo.toml

@@ -18,12 +18,4 @@ autobins = false # needed to override for examples with own manifest files
 
 [dependencies]
 embedded-hal = "1.0.0"
-avr-progmem = { version = "0.4.0", optional = true }
-
-#[[example]]
-#name = "arduino-uno"
-#path = "examples/arduino-uno/src/main.rs"
-
-[[example]]
-name = "esp32-s3"
-path = "examples/esp32-s3/src/bin/main.rs"   
+avr-progmem = { version = "0.4.0", optional = true }

README.md

@@ -7,7 +7,7 @@
 [![lint](https://github.com/nonik0/hcms-29xx/actions/workflows/lint.yml/badge.svg)](https://github.com/nonik0/hcms-29xx/actions/workflows/lint.yml)
 [![build](https://github.com/nonik0/hcms-29xx/actions/workflows/build.yml/badge.svg)](https://github.com/nonik0/hcms-29xx/actions/workflows/build.yml)
 
-Platform agnostic driver for [HCMS-29XX](https://docs.broadcom.com/doc/HCMS-29xx-Series-High-Performance-CMOS-5-x-7-Alphanumeric-Displays) and [HCMS-39XX](https://docs.broadcom.com/doc/AV02-0868EN) display ICs.  Many thanks for @Andy4495's existing [HCMS39XX](https://github.com/Andy4495/HCMS39xx) Arduino/C++ library, which I used for a reference implementation as well as for the font data.
+A platform agnostic driver for [HCMS-29XX](https://docs.broadcom.com/doc/HCMS-29xx-Series-High-Performance-CMOS-5-x-7-Alphanumeric-Displays) and [HCMS-39XX](https://docs.broadcom.com/doc/AV02-0868EN) display ICs. Many thanks to @Andy4495's existing [HCMS39XX](https://github.com/Andy4495/HCMS39xx) Arduino/C++ library, which I used for a reference implementation as well as for the font data.
 
 ## Features:
  * Single dependency on embedded-hal v1.0
@@ -27,6 +27,58 @@ For AVR targets:
 
 ```toml
 hcms-29xx { "0.1.0", features=["avr-progmem"] }
+```
+
+## How to Use
+
+Hcmx29xxx requires four pins to control the display IC: Data (Din), Register Select (RS), Clock (CLK), and Chip Enable (CE). The other pins, Blank (BL), Oscillator Select (SEL), and Reset (RST) are optional. If not given, their logic levels must be set appropriately, e.g. BL low, SEL high, and RST high.
+
+Specifying only required pins:
+
+```rust
+let mut display = hcms_29xx::Hcms29xx::<NUM_CHARS, _, _, _, _>::new(
+    HalOutputPin1,   // Data pin
+    HalOutputPin2,   // RS pin
+    HalOutputPin3,   // Clock pin
+    HalOutputPin4,   // CE pin
+    UnconfiguredPin, // Optional: Blank pin
+    UnconfiguredPin, // Optional: OscSel pin
+    UnconfiguredPin, // Optional: Reset pin
+)
+.unwrap();
+
+display.begin().unwrap();
+display.display_unblank().unwrap();
+display
+    .set_peak_current(hcms_29xx::PeakCurrent::Max12_8Ma)
+    .unwrap();
+display.set_brightness(15).unwrap();
+display.print_ascii_bytes(b"hello!").unwrap();
+```
+
+Specifying all pins:
+
+```rust
+let mut display = hcms_29xx::Hcms29xx::<NUM_CHARS, _, _, _, _, _, _, _>::new(
+    HalOutputPin1, // Data pin
+    HalOutputPin2, // RS pin
+    HalOutputPin3, // Clock pin
+    HalOutputPin4, // CE pin
+    HalOutputPin5, // Optional: Blank pin
+    HalOutputPin6, // Optional: OscSel pin
+    HalOutputPin7, // Optional: Reset pin
+)
+.unwrap();
+
+display.begin().unwrap();
+display.display_unblank().unwrap();
+display.print_ascii_bytes(b"goodbye!").unwrap();
+```
+
+## Examples
+
+There are currently two included examples. One is for Arduino Uno, based on [avr-hal](https://github.com/Rahix/avr-hal/) and the other is for ESP32-S3, based on [esp-hal](https://github.com/esp-rs/esp-hal). Follow the appropriate documentation for each HAL to get an environment set up and simply run "cargo build
 
 ## TODO
+- [ ] Improve generic type interface (UnconfiguredPin improvements, better constructor, etc.)
 - [ ] Katakana font

examples/esp32-s3/Cargo.toml

@@ -6,7 +6,6 @@ edition = "2021"
 
 [[bin]]
 name = "esp32-s3"
-path = "src/bin/main.rs"
 
 [dependencies]
 critical-section = "1.2.0"