esp-hal/esp32c6-hal/examples/i2c_display.rs
Scott Mabin db409ffe7b
Unify the system peripheral (#832)
* Unify the system peripheral

Whilst the PCR, SYSTEM and DPORT peripherals are different, we currently
use them all in the same way. This PR unifies the peripheral name in the
hal to `SYSTEM`. The idea is that they all do the same sort of thing, so
we can collect them under the same name, and later down the line we can
being to expose differences under an extended API.

The benifits to this are imo quite big, the examples now are all identical,
which makes things easier for esp-wifi, and paves a path towards the
multichip hal.

Why not do this in the PAC? Imo the pac should be as close to the
hardware as possible, and the HAL is where we should abstractions such
as this.

* changelog
2023-09-29 08:14:50 -07:00

122 lines
3.1 KiB
Rust

//! I2C Display example
//!
//! This example prints some text on an SSD1306-based
//! display (via I2C)
//!
//! The following wiring is assumed:
//! - SDA => GPIO1
//! - SCL => GPIO2
#![no_std]
#![no_main]
use embedded_graphics::{
mono_font::{
ascii::{FONT_6X10, FONT_9X18_BOLD},
MonoTextStyleBuilder,
},
pixelcolor::BinaryColor,
prelude::*,
text::{Alignment, Text},
};
use esp32c6_hal::{
clock::ClockControl,
gpio::IO,
i2c::I2C,
peripherals::Peripherals,
prelude::*,
timer::TimerGroup,
};
use esp_backtrace as _;
use nb::block;
use ssd1306::{prelude::*, I2CDisplayInterface, Ssd1306};
#[entry]
fn main() -> ! {
let peripherals = Peripherals::take();
let system = peripherals.SYSTEM.split();
let clocks = ClockControl::boot_defaults(system.clock_control).freeze();
let timer_group0 = TimerGroup::new(peripherals.TIMG0, &clocks);
let mut timer0 = timer_group0.timer0;
let io = IO::new(peripherals.GPIO, peripherals.IO_MUX);
// Create a new peripheral object with the described wiring
// and standard I2C clock speed
let i2c = I2C::new(
peripherals.I2C0,
io.pins.gpio1,
io.pins.gpio2,
100u32.kHz(),
&clocks,
);
// Start timer (5 second interval)
timer0.start(5u64.secs());
// Initialize display
let interface = I2CDisplayInterface::new(i2c);
let mut display = Ssd1306::new(interface, DisplaySize128x64, DisplayRotation::Rotate0)
.into_buffered_graphics_mode();
display.init().unwrap();
// Specify different text styles
let text_style = MonoTextStyleBuilder::new()
.font(&FONT_6X10)
.text_color(BinaryColor::On)
.build();
let text_style_big = MonoTextStyleBuilder::new()
.font(&FONT_9X18_BOLD)
.text_color(BinaryColor::On)
.build();
loop {
// Fill display bufffer with a centered text with two lines (and two text
// styles)
Text::with_alignment(
"esp-hal",
display.bounding_box().center() + Point::new(0, 0),
text_style_big,
Alignment::Center,
)
.draw(&mut display)
.unwrap();
Text::with_alignment(
"Chip: ESP32-C6",
display.bounding_box().center() + Point::new(0, 14),
text_style,
Alignment::Center,
)
.draw(&mut display)
.unwrap();
// Write buffer to display
display.flush().unwrap();
// Clear display buffer
display.clear(BinaryColor::Off).unwrap();
// Wait 5 seconds
block!(timer0.wait()).unwrap();
// Write single-line centered text "Hello World" to buffer
Text::with_alignment(
"Hello World!",
display.bounding_box().center(),
text_style_big,
Alignment::Center,
)
.draw(&mut display)
.unwrap();
// Write buffer to display
display.flush().unwrap();
// Clear display buffer
display.clear(BinaryColor::Off).unwrap();
// Wait 5 seconds
block!(timer0.wait()).unwrap();
}
}