Add MCP23008 support.

Author: mpbraendli

README.md

@@ -90,7 +90,7 @@ display.write_str(msg, delay.as_mut()).await;
 
 ### Features
 - 4-bit & 8-bit modes are supported
-- Support for i2c backpacks
+- Support for I2C backpacks based on PCF8574 and MCP23008 port expanders
 - Non-blocking API
 
 ### Todo

src/bus/i2c.rs

@@ -3,6 +3,21 @@ use embedded_hal::blocking::i2c::Write;
 
 use crate::{bus::DataBus, error::Result};
 
+/// This module supports I2C backpacks with a PCF8574 IC.
+/// Connections as follows:
+///
+/// <table>
+/// <tr><th>PCF8574 pin</th><th>name</th><th>LCD pin</th></tr>
+/// <tr><td>P0</td><td>RS</td><td>4</td></tr>
+/// <tr><td>P1</td><td>RW</td><td>5</td></tr>
+/// <tr><td>P2</td><td>E</td><td>6</td></tr>
+/// <tr><td>P3</td><td>Backlight</td><td></td></tr>
+/// <tr><td>P4</td><td>DB4</td><td>11</td></tr>
+/// <tr><td>P5</td><td>DB5</td><td>12</td></tr>
+/// <tr><td>P6</td><td>DB6</td><td>13</td></tr>
+/// <tr><td>P7</td><td>DB7</td><td>14</td></tr>
+/// </table>
+
 pub struct I2CBus<I2C: Write> {
 	i2c_bus: I2C,
 	address: u8,

src/bus/i2c_mcp23008.rs

@@ -0,0 +1,108 @@
+use embedded_hal::blocking::delay::{DelayMs, DelayUs};
+use embedded_hal::blocking::i2c::Write;
+
+use crate::{bus::DataBus, error::Result};
+
+/// This module supports I2C backpacks with a MCP23008 IC, like
+/// the one from adafruit.
+/// Connections as follows:
+///
+/// <table>
+/// <tr><th>MCP23008 pin</th><th>name</th><th>LCD pin</th></tr>
+/// <tr><td>0</td><td>N/C</td><td></td></tr>
+/// <tr><td>1</td><td>RS</td><td>4</td></tr>
+/// <tr><td>2</td><td>E</td><td>6</td></tr>
+/// <tr><td>3</td><td>DB4</td><td>11</td></tr>
+/// <tr><td>4</td><td>DB5</td><td>12</td></tr>
+/// <tr><td>5</td><td>DB6</td><td>13</td></tr>
+/// <tr><td>6</td><td>DB7</td><td>14</td></tr>
+/// <tr><td>7</td><td>Backlight</td><td></td></tr>
+/// </table>
+
+pub struct I2CMCP23008Bus<I2C: Write> {
+    i2c_bus: I2C,
+    address: u8,
+    backlight: u8,
+}
+
+const REG_IODIR : u8 = 0x00;
+const REG_GPIO : u8 = 0x09;
+
+impl<I2C: Write> I2CMCP23008Bus<I2C> {
+    /// Create a new instance of the MCP23008 I2C driver. The address of those
+    /// devices is 0b010_0xxx where x is configured by bootstrap pins.
+    pub fn new(i2c_bus: I2C, address: u8, backlight: bool) -> Result<I2CMCP23008Bus<I2C>> {
+        let backlight = if backlight { 0b1000_0000 } else { 0 };
+        let mut mcp23008 = I2CMCP23008Bus { i2c_bus, address, backlight };
+        // Set to reset values according to datasheet
+        mcp23008.write_reg(REG_IODIR, 0b1111_1111)?;
+        for reg in 0x01u8..0x0A {
+            mcp23008.write_reg(reg, 0)?;
+        }
+        // Configure pins 1..=7 as outputs, see pin mapping above
+        mcp23008.write_reg(REG_IODIR, 0b0000_0001)?;
+        Ok(mcp23008)
+    }
+
+    /// Turns the backlight on or off based on the value of backlight.
+    pub fn set_backlight(&mut self, backlight: bool) -> Result<()> {
+        self.backlight = if backlight { 0b1000_0000 } else { 0 };
+        self.set_pins(self.backlight)
+    }
+
+    fn write_reg(&mut self, reg: u8, value: u8) -> Result<()> {
+        let data = [reg, value];
+        self.i2c_bus.write(self.address, &data)
+            .map_err(|_| crate::error::Error)
+    }
+
+    fn set_pins(&mut self, pins: u8) -> Result<()> {
+        self.write_reg(REG_GPIO, pins)
+    }
+}
+
+impl<I2C: Write> DataBus for I2CMCP23008Bus<I2C> {
+    fn write<D: DelayUs<u16> + DelayMs<u8>>(
+        &mut self,
+        byte: u8,
+        data: bool,
+        delay: &mut D,
+    ) -> Result<()> {
+        let rs = if data { 0b10 } else { 0b00 };
+        let en = 0b0000_0100;
+        let backlight = self.backlight;
+
+        let upper_nibble = (byte & 0xF0) >> 4;
+        let lower_nibble = byte & 0x0F;
+
+        // upper nibble: [d7 d6 d5 d4]
+        // Pulse EN
+        // lower nibble: [d3 d2 d1 d0]
+        // Pulse EN
+
+        let pins = rs | backlight | (upper_nibble << 3);
+        self.set_pins(pins)?;
+
+        delay.delay_ms(1);
+
+        let pins = rs | en | backlight | (upper_nibble << 3);
+        self.set_pins(pins)?;
+
+        delay.delay_ms(1);
+
+        let pins = rs | backlight | (lower_nibble << 3);
+        self.set_pins(pins)?;
+
+        delay.delay_ms(1);
+
+        let pins = rs | en | backlight | (lower_nibble << 3);
+        self.set_pins(pins)?;
+
+        delay.delay_ms(1);
+
+        let pins = backlight | (lower_nibble << 3);
+        self.set_pins(pins)?;
+
+        Ok(())
+    }
+}

src/bus/mod.rs

@@ -3,10 +3,12 @@ use embedded_hal::blocking::delay::{DelayMs, DelayUs};
 mod eightbit;
 mod fourbit;
 mod i2c;
+mod i2c_mcp23008;
 
 pub use self::eightbit::EightBitBus;
 pub use self::fourbit::FourBitBus;
 pub use self::i2c::I2CBus;
+pub use self::i2c_mcp23008::I2CMCP23008Bus;
 
 use crate::error::Result;
 

src/lib.rs

@@ -8,7 +8,7 @@ use embedded_hal::blocking::i2c;
 use embedded_hal::digital::v2::OutputPin;
 
 pub mod bus;
-use bus::{DataBus, EightBitBus, FourBitBus, I2CBus};
+use bus::{DataBus, EightBitBus, FourBitBus, I2CBus, I2CMCP23008Bus};
 
 pub mod error;
 use error::Result;
@@ -176,13 +176,15 @@ impl<RS: OutputPin, EN: OutputPin, D4: OutputPin, D5: OutputPin, D6: OutputPin,
 
 impl<I2C: i2c::Write> HD44780<I2CBus<I2C>> {
 	/// Create an instance of a `HD44780` from an i2c write peripheral,
-	/// the `HD44780` I2C address and a struct implementing the delay trait.
+	/// I2C address and a struct implementing the delay trait.
+	/// The `HD44780` is driven through a PCF8574 I2C port expander.
 	/// - The delay instance is used to sleep between commands to
 	/// ensure the `HD44780` has enough time to process commands.
 	/// - The i2c peripheral is used to send data to the `HD44780` and to set
 	/// its register select and enable pins.
 	///
-	/// This mode operates on an I2C bus, using an I2C to parallel port expander
+	/// This mode operates on an I2C bus, using a PCF8574 I2C to port expander
+	/// The IC connections are described in `I2CBus`
 	///
 	pub fn new_i2c<D: DelayUs<u16> + DelayMs<u8>>(
 		i2c_bus: I2C,
@@ -202,10 +204,51 @@ impl<I2C: i2c::Write> HD44780<I2CBus<I2C>> {
 	}
 }
 
+impl<I2C: i2c::Write> HD44780<I2CMCP23008Bus<I2C>> {
+    /// Create an instance of a `HD44780` from an i2c write peripheral,
+    /// I2C address and a struct implementing the delay trait.
+    /// The `HD44780` is driven through a MCP23008 I2C port expander.
+    /// - The delay instance is used to sleep between commands to
+    /// ensure the `HD44780` has enough time to process commands.
+    /// - The i2c peripheral is used to send data to the `HD44780` and to set
+    /// its register select and enable pins.
+    ///
+    /// This mode operates on an I2C bus, using an I2C to parallel port expander based on MCP23008.
+    /// The IC connections are described in `I2CMCP23008Bus`
+    ///
+    pub fn new_i2c_mcp23008<D: DelayUs<u16> + DelayMs<u8>>(
+        i2c_bus: I2C,
+        address: u8,
+        backlight: bool,
+        delay: &mut D,
+    ) -> Result<HD44780<I2CMCP23008Bus<I2C>>> {
+        let mut hd = HD44780 {
+            bus: I2CMCP23008Bus::new(i2c_bus, address, backlight)?,
+            entry_mode: EntryMode::default(),
+            display_mode: DisplayMode::default(),
+			display_size: DisplaySize::default(),
+        };
+
+        hd.init_4bit(delay)?;
+
+        return Ok(hd);
+    }
+}
+
 impl<B> HD44780<B>
 where
 	B: DataBus,
 {
+    /// Gets a reference to the underlying bus for this display.
+    pub fn get_ref(&self) -> &B {
+        &self.bus
+    }
+
+    /// Gets a mutable reference to the underlying bus for this display.
+    pub fn get_mut(&mut self) -> &mut B {
+        &mut self.bus
+    }
+
 	/// Unshifts the display and sets the cursor position to 0
 	///
 	/// ```rust,ignore