alex/rp-hal-boards
1
0
Fork 0
mirror of https://github.com/italicsjenga/rp-hal-boards.git synced 2025-01-11 21:11:31 +11:00
Code Issues Packages Projects Releases Wiki Activity

Added documentation for the OLED example and fixed formatting.

Browse source
This commit is contained in:
Weird Constructor 2022-01-12 19:22:09 +01:00
parent 2f418bbf8f
commit 2f1e77d0b2
1 changed files with 50 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
boards/rp-pico/examples/pico_i2c_oled_display_ssd1306.rs
View file

@ -1,5 +1,41 @@
//! # Pico (monochome) OLED Display with SSD1306 Driver Example //! # Pico (monochome) OLED Display with SSD1306 Driver Example
//! //!
//! This example assumes you got an OLED Display with an SSD1306 driver
//! connected to your Raspberry Pi Pico. The +3.3V voltage source of the
//! Raspberry Pi Pico will be used, and the output pins 21 and 22 of the board
//! (on the lower right).
//!
//! It will demonstrate how to get an I2C device and use it with the ssd1306 crate.
//! Additionally you can also see how to format a number into a string using
//! [core::fmt].
//!
//! The following diagram will show how things should be connected.
//! These displays usually can take 3.3V up to 5V.
//!
//! ```text
//! VCC SCL
//! /------------\ /----------\
//! | GND \ / SDA |
//! _|USB|_ | /-----\ | | /--------+--\
//! |1 R 40| | / __|__|__|__|___ | |
//! |2 P 39| | / | ____________ | | |
//! |3 38|- GND --|-/ | |Hello worl| | | |
//! |4 P 37| | | |Hello Rust| | | |
//! |5 I 36|-+3.3V -/ | |counter: 1| | | |
//! |6 C | | | | | | |
//! |7 O | | """""""""""" | | |
//! | | """"""""""""""" | |
//! | | (SSD1306 OLED Display) | |
//! ......... / /
//! | | / /
//! | 22|-GP17 I2C0 SCL---------------------/ /
//! |20 21|-GP16 I2C0 SDA-----------------------/
//! """""""
//! Symbols:
//! - (+) crossing lines, not connected
//! - (o) connected lines
//! ```
//!
//! See the `Cargo.toml` file for Copyright and licence details. //! See the `Cargo.toml` file for Copyright and licence details.
#![no_std] #![no_std]
@ -59,15 +95,15 @@ fn main() -> ! {
// Configure the clocks // Configure the clocks
// //
// The default is to generate a 125 MHz system clock // The default is to generate a 125 MHz system clock
let clocks = let clocks = hal::clocks::init_clocks_and_plls(
hal::clocks::init_clocks_and_plls(
rp_pico::XOSC_CRYSTAL_FREQ, rp_pico::XOSC_CRYSTAL_FREQ,
pac.XOSC, pac.XOSC,
pac.CLOCKS, pac.CLOCKS,
pac.PLL_SYS, pac.PLL_SYS,
pac.PLL_USB, pac.PLL_USB,
&mut pac.RESETS, &mut pac.RESETS,
&mut watchdog) &mut watchdog,
)
.ok() .ok()
.unwrap(); .unwrap();
@ -102,8 +138,7 @@ fn main() -> ! {
let interface = I2CDisplayInterface::new(i2c); let interface = I2CDisplayInterface::new(i2c);
// Create a driver instance and initialize: // Create a driver instance and initialize:
let mut display = let mut display = Ssd1306::new(interface, DisplaySize128x64, DisplayRotation::Rotate0)
Ssd1306::new(interface, DisplaySize128x64, DisplayRotation::Rotate0)
.into_buffered_graphics_mode(); .into_buffered_graphics_mode();
display.init().unwrap(); display.init().unwrap();
@ -159,7 +194,7 @@ impl FmtBuf {
fn new() -> Self { fn new() -> Self {
Self { Self {
buf: [0; 64], buf: [0; 64],
ptr: 0 ptr: 0,
} }
} }
@ -181,5 +216,4 @@ impl core::fmt::Write for FmtBuf {
} }
} }
// End of file // End of file