aboutsummaryrefslogtreecommitdiff
path: root/examples/std/src
diff options
context:
space:
mode:
Diffstat (limited to 'examples/std/src')
-rw-r--r--examples/std/src/bin/net.rs103
-rw-r--r--examples/std/src/bin/serial.rs59
-rw-r--r--examples/std/src/bin/tick.rs31
-rw-r--r--examples/std/src/serial_port.rs71
-rw-r--r--examples/std/src/tuntap.rs225
5 files changed, 489 insertions, 0 deletions
diff --git a/examples/std/src/bin/net.rs b/examples/std/src/bin/net.rs
new file mode 100644
index 000000000..5a726e5d2
--- /dev/null
+++ b/examples/std/src/bin/net.rs
@@ -0,0 +1,103 @@
1#![feature(type_alias_impl_trait)]
2#![feature(min_type_alias_impl_trait)]
3#![feature(impl_trait_in_bindings)]
4#![allow(incomplete_features)]
5
6use clap::{AppSettings, Clap};
7use embassy::executor::Spawner;
8use embassy::io::AsyncWriteExt;
9use embassy::util::Forever;
10use embassy_net::*;
11use embassy_std::Executor;
12use heapless::Vec;
13use log::*;
14
15#[path = "../tuntap.rs"]
16mod tuntap;
17
18use crate::tuntap::TunTapDevice;
19
20static DEVICE: Forever<TunTapDevice> = Forever::new();
21static CONFIG: Forever<DhcpConfigurator> = Forever::new();
22
23#[derive(Clap)]
24#[clap(version = "1.0")]
25#[clap(setting = AppSettings::ColoredHelp)]
26struct Opts {
27 /// TAP device name
28 #[clap(long, default_value = "tap0")]
29 tap: String,
30}
31
32#[embassy::task]
33async fn net_task() {
34 embassy_net::run().await
35}
36
37#[embassy::task]
38async fn main_task(spawner: Spawner) {
39 let opts: Opts = Opts::parse();
40
41 // Init network device
42 let device = TunTapDevice::new(&opts.tap).unwrap();
43
44 // Static IP configuration
45 let config = StaticConfigurator::new(Config {
46 address: Ipv4Cidr::new(Ipv4Address::new(192, 168, 69, 2), 24),
47 dns_servers: Vec::new(),
48 gateway: Some(Ipv4Address::new(192, 168, 69, 1)),
49 });
50
51 // DHCP configruation
52 let config = DhcpConfigurator::new();
53
54 // Init network stack
55 embassy_net::init(DEVICE.put(device), CONFIG.put(config));
56
57 // Launch network task
58 spawner.spawn(net_task()).unwrap();
59
60 // Then we can use it!
61 let mut rx_buffer = [0; 4096];
62 let mut tx_buffer = [0; 4096];
63 let mut socket = TcpSocket::new(&mut rx_buffer, &mut tx_buffer);
64
65 socket.set_timeout(Some(embassy_net::SmolDuration::from_secs(10)));
66
67 let remote_endpoint = (Ipv4Address::new(192, 168, 69, 74), 8000);
68 info!("connecting to {:?}...", remote_endpoint);
69 let r = socket.connect(remote_endpoint).await;
70 if let Err(e) = r {
71 warn!("connect error: {:?}", e);
72 return;
73 }
74 info!("connected!");
75 loop {
76 let r = socket.write_all(b"Hello!\n").await;
77 if let Err(e) = r {
78 warn!("write error: {:?}", e);
79 return;
80 }
81 }
82}
83
84#[no_mangle]
85fn _embassy_rand(buf: &mut [u8]) {
86 use rand_core::{OsRng, RngCore};
87 OsRng.fill_bytes(buf);
88}
89
90static EXECUTOR: Forever<Executor> = Forever::new();
91
92fn main() {
93 env_logger::builder()
94 .filter_level(log::LevelFilter::Debug)
95 .filter_module("async_io", log::LevelFilter::Info)
96 .format_timestamp_nanos()
97 .init();
98
99 let executor = EXECUTOR.put(Executor::new());
100 executor.run(|spawner| {
101 spawner.spawn(main_task(spawner)).unwrap();
102 });
103}
diff --git a/examples/std/src/bin/serial.rs b/examples/std/src/bin/serial.rs
new file mode 100644
index 000000000..1b22dc0de
--- /dev/null
+++ b/examples/std/src/bin/serial.rs
@@ -0,0 +1,59 @@
1#![feature(min_type_alias_impl_trait)]
2#![feature(impl_trait_in_bindings)]
3#![feature(type_alias_impl_trait)]
4#![allow(incomplete_features)]
5
6#[path = "../serial_port.rs"]
7mod serial_port;
8
9use async_io::Async;
10use embassy::io::AsyncBufReadExt;
11use embassy::util::Forever;
12use embassy_std::Executor;
13use log::*;
14use nix::sys::termios;
15
16use self::serial_port::SerialPort;
17
18#[embassy::task]
19async fn run() {
20 // Open the serial port.
21 let baudrate = termios::BaudRate::B115200;
22 let port = SerialPort::new("/dev/ttyACM0", baudrate).unwrap();
23 //let port = Spy::new(port);
24
25 // Use async_io's reactor for async IO.
26 // This demonstrates how embassy's executor can drive futures from another IO library.
27 // Essentially, async_io::Async converts from AsRawFd+Read+Write to futures's AsyncRead+AsyncWrite
28 let port = Async::new(port).unwrap();
29
30 // This implements futures's AsyncBufRead based on futures's AsyncRead
31 let port = futures::io::BufReader::new(port);
32
33 // We can then use FromStdIo to convert from futures's AsyncBufRead+AsyncWrite
34 // to embassy's AsyncBufRead+AsyncWrite
35 let mut port = embassy::io::FromStdIo::new(port);
36
37 info!("Serial opened!");
38
39 loop {
40 let mut buf = [0u8; 256];
41 let n = port.read(&mut buf).await.unwrap();
42 info!("read {:?}", &buf[..n]);
43 }
44}
45
46static EXECUTOR: Forever<Executor> = Forever::new();
47
48fn main() {
49 env_logger::builder()
50 .filter_level(log::LevelFilter::Debug)
51 .filter_module("async_io", log::LevelFilter::Info)
52 .format_timestamp_nanos()
53 .init();
54
55 let executor = EXECUTOR.put(Executor::new());
56 executor.run(|spawner| {
57 spawner.spawn(run()).unwrap();
58 });
59}
diff --git a/examples/std/src/bin/tick.rs b/examples/std/src/bin/tick.rs
new file mode 100644
index 000000000..6f30edb34
--- /dev/null
+++ b/examples/std/src/bin/tick.rs
@@ -0,0 +1,31 @@
1#![feature(min_type_alias_impl_trait)]
2#![feature(impl_trait_in_bindings)]
3#![feature(type_alias_impl_trait)]
4#![allow(incomplete_features)]
5
6use embassy::time::{Duration, Timer};
7use embassy::util::Forever;
8use embassy_std::Executor;
9use log::*;
10
11#[embassy::task]
12async fn run() {
13 loop {
14 info!("tick");
15 Timer::after(Duration::from_secs(1)).await;
16 }
17}
18
19static EXECUTOR: Forever<Executor> = Forever::new();
20
21fn main() {
22 env_logger::builder()
23 .filter_level(log::LevelFilter::Debug)
24 .format_timestamp_nanos()
25 .init();
26
27 let executor = EXECUTOR.put(Executor::new());
28 executor.run(|spawner| {
29 spawner.spawn(run()).unwrap();
30 });
31}
diff --git a/examples/std/src/serial_port.rs b/examples/std/src/serial_port.rs
new file mode 100644
index 000000000..7ac1b1edb
--- /dev/null
+++ b/examples/std/src/serial_port.rs
@@ -0,0 +1,71 @@
1use nix::fcntl::OFlag;
2use nix::sys::termios;
3use nix::Error;
4use std::io;
5use std::os::unix::io::{AsRawFd, RawFd};
6
7pub struct SerialPort {
8 fd: RawFd,
9}
10
11impl SerialPort {
12 pub fn new<'a, P: ?Sized + nix::NixPath>(
13 path: &P,
14 baudrate: termios::BaudRate,
15 ) -> io::Result<Self> {
16 let fd = nix::fcntl::open(
17 path,
18 OFlag::O_RDWR | OFlag::O_NOCTTY | OFlag::O_NONBLOCK,
19 nix::sys::stat::Mode::empty(),
20 )
21 .map_err(to_io_error)?;
22
23 let mut cfg = termios::tcgetattr(fd).map_err(to_io_error)?;
24 cfg.input_flags = termios::InputFlags::empty();
25 cfg.output_flags = termios::OutputFlags::empty();
26 cfg.control_flags = termios::ControlFlags::empty();
27 cfg.local_flags = termios::LocalFlags::empty();
28 termios::cfmakeraw(&mut cfg);
29 cfg.input_flags |= termios::InputFlags::IGNBRK;
30 cfg.control_flags |= termios::ControlFlags::CREAD;
31 //cfg.control_flags |= termios::ControlFlags::CRTSCTS;
32 termios::cfsetospeed(&mut cfg, baudrate).map_err(to_io_error)?;
33 termios::cfsetispeed(&mut cfg, baudrate).map_err(to_io_error)?;
34 termios::cfsetspeed(&mut cfg, baudrate).map_err(to_io_error)?;
35 // Set VMIN = 1 to block until at least one character is received.
36 cfg.control_chars[termios::SpecialCharacterIndices::VMIN as usize] = 1;
37 termios::tcsetattr(fd, termios::SetArg::TCSANOW, &cfg).map_err(to_io_error)?;
38 termios::tcflush(fd, termios::FlushArg::TCIOFLUSH).map_err(to_io_error)?;
39
40 Ok(Self { fd })
41 }
42}
43
44impl AsRawFd for SerialPort {
45 fn as_raw_fd(&self) -> RawFd {
46 self.fd
47 }
48}
49
50impl io::Read for SerialPort {
51 fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
52 nix::unistd::read(self.fd, buf).map_err(to_io_error)
53 }
54}
55
56impl io::Write for SerialPort {
57 fn write(&mut self, buf: &[u8]) -> io::Result<usize> {
58 nix::unistd::write(self.fd, buf).map_err(to_io_error)
59 }
60
61 fn flush(&mut self) -> io::Result<()> {
62 Ok(())
63 }
64}
65
66fn to_io_error(e: Error) -> io::Error {
67 match e {
68 Error::Sys(errno) => errno.into(),
69 e => io::Error::new(io::ErrorKind::InvalidInput, e),
70 }
71}
diff --git a/examples/std/src/tuntap.rs b/examples/std/src/tuntap.rs
new file mode 100644
index 000000000..dd453deb3
--- /dev/null
+++ b/examples/std/src/tuntap.rs
@@ -0,0 +1,225 @@
1use async_io::Async;
2use libc;
3use log::*;
4use smoltcp::wire::EthernetFrame;
5use std::io;
6use std::io::{Read, Write};
7use std::os::unix::io::{AsRawFd, RawFd};
8
9pub const SIOCGIFMTU: libc::c_ulong = 0x8921;
10pub const SIOCGIFINDEX: libc::c_ulong = 0x8933;
11pub const ETH_P_ALL: libc::c_short = 0x0003;
12pub const TUNSETIFF: libc::c_ulong = 0x400454CA;
13pub const IFF_TUN: libc::c_int = 0x0001;
14pub const IFF_TAP: libc::c_int = 0x0002;
15pub const IFF_NO_PI: libc::c_int = 0x1000;
16
17#[repr(C)]
18#[derive(Debug)]
19struct ifreq {
20 ifr_name: [libc::c_char; libc::IF_NAMESIZE],
21 ifr_data: libc::c_int, /* ifr_ifindex or ifr_mtu */
22}
23
24fn ifreq_for(name: &str) -> ifreq {
25 let mut ifreq = ifreq {
26 ifr_name: [0; libc::IF_NAMESIZE],
27 ifr_data: 0,
28 };
29 for (i, byte) in name.as_bytes().iter().enumerate() {
30 ifreq.ifr_name[i] = *byte as libc::c_char
31 }
32 ifreq
33}
34
35fn ifreq_ioctl(
36 lower: libc::c_int,
37 ifreq: &mut ifreq,
38 cmd: libc::c_ulong,
39) -> io::Result<libc::c_int> {
40 unsafe {
41 let res = libc::ioctl(lower, cmd as _, ifreq as *mut ifreq);
42 if res == -1 {
43 return Err(io::Error::last_os_error());
44 }
45 }
46
47 Ok(ifreq.ifr_data)
48}
49
50#[derive(Debug)]
51pub struct TunTap {
52 fd: libc::c_int,
53 ifreq: ifreq,
54 mtu: usize,
55}
56
57impl AsRawFd for TunTap {
58 fn as_raw_fd(&self) -> RawFd {
59 self.fd
60 }
61}
62
63impl TunTap {
64 pub fn new(name: &str) -> io::Result<TunTap> {
65 unsafe {
66 let fd = libc::open(
67 "/dev/net/tun\0".as_ptr() as *const libc::c_char,
68 libc::O_RDWR | libc::O_NONBLOCK,
69 );
70 if fd == -1 {
71 return Err(io::Error::last_os_error());
72 }
73
74 let mut ifreq = ifreq_for(name);
75 ifreq.ifr_data = IFF_TAP | IFF_NO_PI;
76 ifreq_ioctl(fd, &mut ifreq, TUNSETIFF)?;
77
78 let socket = libc::socket(libc::AF_INET, libc::SOCK_DGRAM, libc::IPPROTO_IP);
79 if socket == -1 {
80 return Err(io::Error::last_os_error());
81 }
82
83 let ip_mtu = ifreq_ioctl(socket, &mut ifreq, SIOCGIFMTU);
84 libc::close(socket);
85 let ip_mtu = ip_mtu? as usize;
86
87 // SIOCGIFMTU returns the IP MTU (typically 1500 bytes.)
88 // smoltcp counts the entire Ethernet packet in the MTU, so add the Ethernet header size to it.
89 let mtu = ip_mtu + EthernetFrame::<&[u8]>::header_len();
90
91 Ok(TunTap { fd, mtu, ifreq })
92 }
93 }
94}
95
96impl Drop for TunTap {
97 fn drop(&mut self) {
98 unsafe {
99 libc::close(self.fd);
100 }
101 }
102}
103
104impl io::Read for TunTap {
105 fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
106 let len = unsafe { libc::read(self.fd, buf.as_mut_ptr() as *mut libc::c_void, buf.len()) };
107 if len == -1 {
108 Err(io::Error::last_os_error())
109 } else {
110 Ok(len as usize)
111 }
112 }
113}
114
115impl io::Write for TunTap {
116 fn write(&mut self, buf: &[u8]) -> io::Result<usize> {
117 let len = unsafe { libc::write(self.fd, buf.as_ptr() as *mut libc::c_void, buf.len()) };
118 if len == -1 {
119 Err(io::Error::last_os_error())
120 } else {
121 Ok(len as usize)
122 }
123 }
124
125 fn flush(&mut self) -> io::Result<()> {
126 Ok(())
127 }
128}
129
130pub struct TunTapDevice {
131 device: Async<TunTap>,
132 waker: Option<Waker>,
133}
134
135impl TunTapDevice {
136 pub fn new(name: &str) -> io::Result<TunTapDevice> {
137 Ok(Self {
138 device: Async::new(TunTap::new(name)?)?,
139 waker: None,
140 })
141 }
142}
143
144use core::task::Waker;
145use embassy_net::{DeviceCapabilities, LinkState, Packet, PacketBox, PacketBoxExt, PacketBuf};
146use std::task::Context;
147
148impl crate::Device for TunTapDevice {
149 fn is_transmit_ready(&mut self) -> bool {
150 true
151 }
152
153 fn transmit(&mut self, pkt: PacketBuf) {
154 // todo handle WouldBlock
155 match self.device.get_mut().write(&pkt) {
156 Ok(_) => {}
157 Err(e) if e.kind() == io::ErrorKind::WouldBlock => {
158 info!("transmit WouldBlock");
159 }
160 Err(e) => panic!("transmit error: {:?}", e),
161 }
162 }
163
164 fn receive(&mut self) -> Option<PacketBuf> {
165 let mut pkt = PacketBox::new(Packet::new()).unwrap();
166 loop {
167 match self.device.get_mut().read(&mut pkt[..]) {
168 Ok(n) => {
169 return Some(pkt.slice(0..n));
170 }
171 Err(e) if e.kind() == io::ErrorKind::WouldBlock => {
172 let ready = if let Some(w) = self.waker.as_ref() {
173 let mut cx = Context::from_waker(w);
174 let ready = self.device.poll_readable(&mut cx).is_ready();
175 ready
176 } else {
177 false
178 };
179 if !ready {
180 return None;
181 }
182 }
183 Err(e) => panic!("read error: {:?}", e),
184 }
185 }
186 }
187
188 fn register_waker(&mut self, w: &Waker) {
189 match self.waker {
190 // Optimization: If both the old and new Wakers wake the same task, we can simply
191 // keep the old waker, skipping the clone. (In most executor implementations,
192 // cloning a waker is somewhat expensive, comparable to cloning an Arc).
193 Some(ref w2) if (w2.will_wake(w)) => {}
194 _ => {
195 // clone the new waker and store it
196 if let Some(old_waker) = core::mem::replace(&mut self.waker, Some(w.clone())) {
197 // We had a waker registered for another task. Wake it, so the other task can
198 // reregister itself if it's still interested.
199 //
200 // If two tasks are waiting on the same thing concurrently, this will cause them
201 // to wake each other in a loop fighting over this WakerRegistration. This wastes
202 // CPU but things will still work.
203 //
204 // If the user wants to have two tasks waiting on the same thing they should use
205 // a more appropriate primitive that can store multiple wakers.
206 old_waker.wake()
207 }
208 }
209 }
210 }
211
212 fn capabilities(&mut self) -> DeviceCapabilities {
213 let mut caps = DeviceCapabilities::default();
214 caps.max_transmission_unit = self.device.get_ref().mtu;
215 caps
216 }
217
218 fn link_state(&mut self) -> LinkState {
219 LinkState::Up
220 }
221
222 fn ethernet_address(&mut self) -> [u8; 6] {
223 [0x02, 0x03, 0x04, 0x05, 0x06, 0x07]
224 }
225}