{"id":22920927,"url":"https://github.com/michaelkamprath/adafruit-lcd-backpack-rust","last_synced_at":"2025-05-12T20:25:02.469Z","repository":{"id":215212289,"uuid":"738330217","full_name":"michaelkamprath/adafruit-lcd-backpack-rust","owner":"michaelkamprath","description":"Unofficial Rust driver for Adafruit's LCD I2C Backpack","archived":false,"fork":false,"pushed_at":"2024-10-22T12:50:37.000Z","size":587,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-12T20:24:35.306Z","etag":null,"topics":["adafruit","driver","embedded-rust","i2c","i2c-display","lcd-display","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/michaelkamprath.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-03T01:30:40.000Z","updated_at":"2024-10-22T12:50:41.000Z","dependencies_parsed_at":"2024-01-07T07:21:14.020Z","dependency_job_id":"6d5dfede-f77a-4ad9-b1ea-fbead2153297","html_url":"https://github.com/michaelkamprath/adafruit-lcd-backpack-rust","commit_stats":null,"previous_names":["michaelkamprath/adafruit-lcd-backpack-rust"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelkamprath%2Fadafruit-lcd-backpack-rust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelkamprath%2Fadafruit-lcd-backpack-rust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelkamprath%2Fadafruit-lcd-backpack-rust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelkamprath%2Fadafruit-lcd-backpack-rust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/michaelkamprath","download_url":"https://codeload.github.com/michaelkamprath/adafruit-lcd-backpack-rust/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253815161,"owners_count":21968582,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adafruit","driver","embedded-rust","i2c","i2c-display","lcd-display","rust"],"created_at":"2024-12-14T07:17:39.695Z","updated_at":"2025-05-12T20:25:02.408Z","avatar_url":"https://github.com/michaelkamprath.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# adafruit-lcd-backpack\n\n## THIS LIBRARY IS NO LONGER MAINTAINED\nThis library has not been updated to be compatible with `embedded-hal` version 1.0.0 and later. It is recommended to use the [`i2c-character-display`](https://crates.io/crates/i2c-character-display) driver instead ([repository](https://github.com/michaelkamprath/i2c-character-display)), which is compatible with `embedded-hal` version 1.0.0 and later and supports the Adafruit I2C LCD backpack plus other I2C character displays.\n\n---\n\u003c!-- cargo-sync-readme start --\u003e\n\nRust driver for the [Adafruit I2C LCD backpack](https://www.adafruit.com/product/292) with MCP23008 GPIO expander\n\n_NOTE: This library is not made by Adafruit, and is not supported by them. The use of the Adafruit name\nis for compatibility identification purposes only._\n\n## Overview\nThis crate provides a driver for the Adafruit I2C LCD backpack with MCP23008 GPIO expander. It is designed to be used with the\n[embedded-hal](https://docs.rs/embedded-hal/latest/embedded_hal/index.html) traits for embeded systems. It supports standard\nHD44780 based LCD displays.\n\n## Usage\nTo create a new LCD backpack, use the `new` method. This will return a new LCD backpack object. Pass it the type of LCD display you\nare using, the I2C bus, and the delay object. Both the I2C Bus and Delay objects must implement the relevant embedded-hal traits.\n\n```rust\n// The embedded-hal traits are used to define the I2C bus and delay objects\nuse embedded_hal::{\n    blocking::delay::{DelayMs, DelayUs},\n    blocking::i2c::{Write, WriteRead},\n};\nuse lcd_backpack::{LcdBackpack, LcdDisplayType};\n\n// create the I2C bus per your platform\nlet i2c = ...;\n\n// create the delay object per your platform\nlet delay = ...;\n\n// create the LCD backpack\nlet mut lcd = LcdBackpack::new(LcdDisplayType::Lcd16x2, i2c, delay);\n\n// initialize the LCD\nif let Err(_e) = lcd.init() {\n   panic!(\"Error initializing LCD\");\n}\n```\nThis library supports the `core::fmt::Write` trait, allowing it to be used with the `write!` macro. For example:\n```rust\nuse core::fmt::Write;\n\n// write a string to the LCD\nif let Err(_e) = write!(lcd, \"Hello, world!\") {\n  panic!(\"Error writing to LCD\");\n}\n```\nThe various methods for controlling the LCD are also available. Each returns a `Result` that wraps the LCD backpack object. This\nallows you to chain the methods together. For example:\n\n```rust\n// clear the display and home the cursor before writing a string\nif let Err(_e) = write!(lcd.clear()?.home()?, \"Hello, world!\") {\n panic!(\"Error writing to LCD\");\n}\n```\n\n\u003c!-- cargo-sync-readme end --\u003e\n\n## License\nLicensed under the [MIT](LICENSE-MIT) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelkamprath%2Fadafruit-lcd-backpack-rust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelkamprath%2Fadafruit-lcd-backpack-rust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelkamprath%2Fadafruit-lcd-backpack-rust/lists"}