itsscb/esp32-book
1
0
Fork 0
mirror of https://github.com/ImplFerris/esp32-book.git synced 2025-09-24 14:31:13 +00:00
Code Issues Packages Projects Releases Wiki Activity

ultrasonci migrate esp-hal 1.0.0-beta

Browse Source
This commit is contained in:
ImplFerris 2025-03-14 21:45:04 +05:30
parent a97bc85613
commit f7ba860f5b
4 changed files with 115 additions and 65 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/buzzer/play-songs/code.md
View File

@ -10,7 +10,7 @@ To create the project, use the `esp-generate` command. Run the following:
esp-generate --chip esp32 buzzer-song
```
This will open a screen asking you to select options. For now, we dont need to select any options. In the latest esp-hal, ledc requires us to enable the unstable features.
This will open a screen asking you to select options. In the latest esp-hal, ledc requires us to enable the unstable features.
- So you select the option "Enable unstable HAL features."

2
src/led/code.md
View File

@ -12,7 +12,7 @@ To create the project, use the `esp-generate` command. Run the following:
esp-generate --chip esp32 led-fader
```
This will open a screen asking you to select options. For now, we dont need to select any options. In the latest esp-hal, ledc requires us to enable the unstable features.
This will open a screen asking you to select options. In the latest esp-hal, ledc requires us to enable the unstable features.
- So you select the option "Enable unstable HAL features."

88
src/ultrasonic/code.md
View File

@ -13,7 +13,11 @@ To create the project, use the `esp-generate` command. Run the following:
esp-generate --chip esp32 ultrasonic
```
This will open a screen asking you to select options. For now, we dont need to select any options. Just save it by pressing "s" in the keyboard.
This will open a screen asking you to select options. In the latest esp-hal, ledc requires us to enable the unstable features.
- So you select the option "Enable unstable HAL features."
Then save it by pressing "s" in the keyboard.
## Setup the LED Pin and configure PWM
You should understand this code by now. If not, please complete the Fading [LED section](../led/index.md) first.
@ -21,21 +25,24 @@ You should understand this code by now. If not, please complete the Fading [LED
Quick recap: Here, we're configuring the PWM for the LED, which allows us to control the brightness by adjusting the duty cycle.
```rust
let led = peripherals.GPIO33;
let ledc = Ledc::new(peripherals.LEDC);
let mut hstimer0 = ledc.timer::<HighSpeed>(timer::Number::Timer0);
hstimer0
// let led = peripherals.GPIO2; // uses onboard LED
let led = peripherals.GPIO33;
// Configure LEDC
let mut ledc = Ledc::new(peripherals.LEDC);
ledc.set_global_slow_clock(LSGlobalClkSource::APBClk);
let mut lstimer0 = ledc.timer::<LowSpeed>(timer::Number::Timer0);
lstimer0
.configure(timer::config::Config {
duty: timer::config::Duty::Duty5Bit,
clock_source: timer::HSClockSource::APBClk,
frequency: 24.kHz(),
clock_source: timer::LSClockSource::APBClk,
frequency: Rate::from_khz(24),
})
.unwrap();
let mut channel0 = ledc.channel(channel::Number::Channel0, led);
channel0
.configure(channel::config::Config {
timer: &hstimer0,
timer: &lstimer0,
duty_pct: 10,
pin_config: channel::config::PinConfig::PushPull,
})
@ -46,14 +53,17 @@ channel0
We will configure GPIO 5 as an output pin with its initial state set to LOW. If you're wondering why it's an output, it's because we are sending a signal from the ESP32 to the ultrasonic module. This pin is connected to the Trig pin of the ultrasonic module.
```rust
let mut trig = Output::new(peripherals.GPIO5, Level::Low);
let mut trig = Output::new(peripherals.GPIO5, Level::Low, OutputConfig::default());
```
## Setup the Echo Pin
We will configure GPIO 18 as an input pin since the ultrasonic module sends the signal back to the ESP32. The initial state of this pin will be set to Pull Down to ensure it starts in the low state.
```rust
let echo = Input::new(peripherals.GPIO18, Pull::Down);
let echo = Input::new(
peripherals.GPIO18,
InputConfig::default().with_pull(Pull::Down),
);
```
## 🦇 Light it Up
@ -123,53 +133,67 @@ if let Err(e) = channel0.set_duty(duty_pct) {
#![no_std]
#![no_main]
use esp_backtrace as _;
use esp_hal::clock::CpuClock;
use esp_hal::gpio::{InputConfig, OutputConfig};
use esp_hal::ledc::{LSGlobalClkSource, LowSpeed};
use esp_hal::main;
use esp_hal::time::Rate;
use esp_hal::{
delay::Delay,
gpio::{Input, Level, Output, Pull},
ledc::{
channel::{self, ChannelIFace},
timer::{self, TimerIFace},
HighSpeed, Ledc,
Ledc,
},
prelude::*,
rtc_cntl::Rtc,
};
#[entry]
#[panic_handler]
fn panic(_: &core::panic::PanicInfo) -> ! {
loop {}
}
#[main]
fn main() -> ! {
let peripherals = esp_hal::init({
let mut config = esp_hal::Config::default();
config.cpu_clock = CpuClock::max();
config
});
// generator version: 0.3.1
let config = esp_hal::Config::default().with_cpu_clock(CpuClock::max());
let peripherals = esp_hal::init(config);
// let led = peripherals.GPIO2; // uses onboard LED
let led = peripherals.GPIO33;
let ledc = Ledc::new(peripherals.LEDC);
let mut hstimer0 = ledc.timer::<HighSpeed>(timer::Number::Timer0);
hstimer0
// Configure LEDC
let mut ledc = Ledc::new(peripherals.LEDC);
ledc.set_global_slow_clock(LSGlobalClkSource::APBClk);
let mut lstimer0 = ledc.timer::<LowSpeed>(timer::Number::Timer0);
lstimer0
.configure(timer::config::Config {
duty: timer::config::Duty::Duty5Bit,
clock_source: timer::HSClockSource::APBClk,
frequency: 24.kHz(),
clock_source: timer::LSClockSource::APBClk,
frequency: Rate::from_khz(24),
})
.unwrap();
let mut channel0 = ledc.channel(channel::Number::Channel0, led);
channel0
.configure(channel::config::Config {
timer: &hstimer0,
timer: &lstimer0,
duty_pct: 10,
pin_config: channel::config::PinConfig::PushPull,
})
.unwrap();
// For HC-SR04 Ultrasonic
let mut trig = Output::new(peripherals.GPIO5, Level::Low);
let echo = Input::new(peripherals.GPIO18, Pull::Down);
let mut trig = Output::new(peripherals.GPIO5, Level::Low, OutputConfig::default());
let echo = Input::new(
peripherals.GPIO18,
InputConfig::default().with_pull(Pull::Down),
);
let delay = Delay::new(); // We can use this since we are using unstable features
let delay = Delay::new();
let rtc = Rtc::new(peripherals.LPWR);
loop {
@ -207,13 +231,13 @@ fn main() -> ! {
};
if let Err(e) = channel0.set_duty(duty_pct) {
esp_println::println!("Failed to set duty cycle: {:?}", e);
// esp_println::println!("Failed to set duty cycle: {:?}", e);
panic!("Failed to set duty cycle: {:?}", e);
}
delay.delay_millis(60);
}
}
```
## Clone the existing project

88
src/ultrasonic/using-buzzer.md
View File

@ -8,12 +8,26 @@ The circuit is almost the same as before. The only difference is that you need t
<img style="display: block; margin: auto;" alt="hc-sr04 with buzzer and ESP32 circuit" src="./images/ESP32-HC-SR04-circuit-buzzer.png"/>
### Generate project using esp-generate
You have done this step already in the quick start section.
To create the project, use the `esp-generate` command. Run the following:
```sh
esp-generate --chip esp32 ultrasonic
```
This will open a screen asking you to select options. We don't need unstable or any other features. So just save it by pressing "s" in the keyboard.
## Code
We will set GPIO 33 as our output pin with an initial Low state. This is the same as the LED code; the only change is the variable name.
```rust
let mut buzzer = Output::new(peripherals.GPIO33, Level::Low);
let mut buzzer = Output::new(peripherals.GPIO33, Level::Low, OutputConfig::default());
```
We won't need the timer or PWM configurations we used for the LED. Instead, we will set the buzzer to High (it will make a sound when it is High) if the distance is less than 30cm; otherwise, it will remain Low.
@ -32,53 +46,50 @@ if distance < 30.0 {
#![no_std]
#![no_main]
use esp_backtrace as _;
use esp_hal::{
delay::Delay,
gpio::{Input, Level, Output, Pull},
prelude::*,
rtc_cntl::Rtc,
};
use esp_hal::clock::CpuClock;
use esp_hal::gpio::{Input, InputConfig, Level, Output, OutputConfig, Pull};
use esp_hal::main;
use esp_hal::time::{Duration, Instant};
#[entry]
#[panic_handler]
fn panic(_: &core::panic::PanicInfo) -> ! {
loop {}
}
#[main]
fn main() -> ! {
let peripherals = esp_hal::init({
let mut config = esp_hal::Config::default();
config.cpu_clock = CpuClock::max();
config
});
// generator version: 0.3.1
let mut buzzer = Output::new(peripherals.GPIO33, Level::Low);
let config = esp_hal::Config::default().with_cpu_clock(CpuClock::max());
let peripherals = esp_hal::init(config);
let mut buzzer = Output::new(peripherals.GPIO33, Level::Low, OutputConfig::default());
// For HC-SR04 Ultrasonic
let mut trig = Output::new(peripherals.GPIO5, Level::Low);
let echo = Input::new(peripherals.GPIO18, Pull::Down);
let delay = Delay::new();
let rtc = Rtc::new(peripherals.LPWR);
let mut trig = Output::new(peripherals.GPIO5, Level::Low, OutputConfig::default());
let echo = Input::new(
peripherals.GPIO18,
InputConfig::default().with_pull(Pull::Down),
);
loop {
delay.delay_millis(5);
blocking_delay(Duration::from_millis(5));
// Trigger ultrasonic waves
trig.set_low();
delay.delay_micros(2);
blocking_delay(Duration::from_micros(2));
trig.set_high();
delay.delay_micros(10);
blocking_delay(Duration::from_micros(10));
trig.set_low();
// Measure the duration the signal remains high
while echo.is_low() {}
let time1 = rtc.current_time();
let time1 = Instant::now();
while echo.is_high() {}
let time2 = rtc.current_time();
let pulse_width = match (time2 - time1).num_microseconds() {
Some(pw) => pw as f64,
None => continue,
};
let pulse_width = time1.elapsed().as_micros();
// Derive distance from the pulse width
let distance = (pulse_width * 0.0343) / 2.0;
let distance = (pulse_width as f64 * 0.0343) / 2.0;
// esp_println::println!("Pulse Width: {}", pulse_width);
// esp_println::println!("Distance: {}", distance);
@ -88,7 +99,22 @@ fn main() -> ! {
buzzer.set_low();
}
delay.delay_millis(60);
blocking_delay(Duration::from_millis(60));
}
}
fn blocking_delay(duration: Duration) {
let delay_start = Instant::now();
while delay_start.elapsed() < duration {}
}
```
## Clone the existing project
You can clone (or refer) project I created and navigate to the `ultrasonic-alert` folder.
```sh
git clone https://github.com/ImplFerris/esp32-projects/ultrasonic
cd esp32-projects/ultrasonic-alert
```