#protocols #ppp #alloc #heap #compatible #required #point-to-point

no-std ppproto

Point-to-Point Protocol (PPP) for embedded systems. no-std compatible, no alloc (heap) required.

6 releases

new 0.2.1 Nov 14, 2024
0.2.0 Oct 6, 2024
0.1.2 Aug 29, 2023
0.0.0 Mar 7, 2023

#670 in Embedded development

Download history 62/week @ 2024-07-25 32/week @ 2024-08-01 24/week @ 2024-08-08 24/week @ 2024-08-15 22/week @ 2024-08-22 34/week @ 2024-08-29 24/week @ 2024-09-05 40/week @ 2024-09-12 56/week @ 2024-09-19 44/week @ 2024-09-26 205/week @ 2024-10-03 106/week @ 2024-10-10 80/week @ 2024-10-17 113/week @ 2024-10-24 142/week @ 2024-10-31 68/week @ 2024-11-07

415 downloads per month
Used in embassy-net-ppp

MIT/Apache

48KB
1.5K SLoC

ppproto

Rust implementation of the Point-to-Point Protocol (PPP) for embedded systems. no-std compatible, no alloc (heap) required.

Relevant RFCs

  • RFC 1661 - The Point-to-Point Protocol (PPP)
  • RFC 1332 - The PPP Internet Protocol Control Protocol (IPCP)
  • RFC 1334 - PPP Authentication Protocols

Testing against pppd

Put this in /etc/ppp/pap-secrets, where myhostname is the hostname of your machine.

myuser myhostname mypass 192.168.7.10
socat -v -x PTY,link=pty1,rawer PTY,link=pty2,rawer
pppd $PWD/pty1 115200 192.168.7.1: ms-dns 8.8.4.4 ms-dns 8.8.8.8 nodetach debug local persist silent noproxyarp
RUST_LOG=trace cargo run --bin simple -- --device pty2
ping 192.168.7.10

Testing against a real modem

  • minicom -D /dev/ttyUSB0 -b 115200
  • put whatever AT commands you need to connect (such as ATD*99#)
  • Control+A Q
  • RUST_LOG=trace cargo run --bin simple -- --device /dev/ttyUSB0

If you want to "MITM" the serial communications to see the raw bytes coming and going, you can do this:

socat -v -x /dev/ttyUSB0 PTY,link=pty,rawer

and then use $PWD/pty instead of /dev/ttyUSB0

License

This work is licensed under either of

at your option.

Dependencies

~0.7–1.2MB
~27K SLoC