PPP (Point-to-Point Protocol) More...

#include "core/net.h"
#include "ppp/pap.h"
#include "ppp/chap.h"

Data Structures
struct	PppSettings
	PPP settings. More...

struct	PppFsm
	PPP finite state machine. More...

struct	PppConfig
	PPP configuration options. More...

struct	_PppContext
	PPP context. More...

Macros
#define	PppPacket struct _PppPacket

#define	PppContext struct _PppContext

#define	PPP_SUPPORT DISABLED

#define	PPP_TX_BUFFER_SIZE 4096

#define	PPP_RX_BUFFER_SIZE 8192

#define	PPP_MAX_USERNAME_LEN 31

#define	PPP_MAX_PASSWORD_LEN 31

#define	PPP_TICK_INTERVAL 500

#define	PPP_POLLING_INTERVAL 50

#define	PPP_RESTART_TIMER 3000

#define	PPP_MAX_CONFIGURE 10

#define	PPP_MAX_TERMINATE 2

#define	PPP_MAX_FAILURE 5

#define	PPP_MASK_CHAR 0x20

#define	PPP_ESC_CHAR 0x7D

#define	PPP_FLAG_CHAR 0x7E

#define	PPP_DEFAULT_MRU 1500

#define	PPP_DEFAULT_ACCM 0xFFFFFFFF

#define	PPP_DEFAULT_MAGIC_NUMBER 0

#define	PPP_MIN_MRU 32

#define	PPP_MAX_MRU 1500

#define	PPP_MAX_CONF_REQ_SIZE 128

#define	PPP_FRAME_HEADER_SIZE 4

#define	PPP_FCS_SIZE 2

#define	PPP_MAX_FRAME_SIZE (PPP_FRAME_HEADER_SIZE + PPP_MAX_MRU + PPP_FCS_SIZE)

#define	PPP_ADDR_FIELD 0xFF

#define	PPP_CTRL_FIELD 0x03
	PPP Control field. More...

Typedefs
typedef error_t(*	PppRandCallback) (uint8_t *data, size_t length)
	Random data generation callback function. More...

typedef bool_t(*	PppAuthCallback) (NetInterface interface, const char_t username)
	PPP authentication callback function. More...

Enumerations
enum	PppPhase { PPP_PHASE_DEAD = 0, PPP_PHASE_ESTABLISH = 1, PPP_PHASE_AUTHENTICATE = 2, PPP_PHASE_NETWORK = 3, PPP_PHASE_TERMINATE = 4 }
	PPP phases. More...

enum	PppState { PPP_STATE_0_INITIAL = 0, PPP_STATE_1_STARTING = 1, PPP_STATE_2_CLOSED = 2, PPP_STATE_3_STOPPED = 3, PPP_STATE_4_CLOSING = 4, PPP_STATE_5_STOPPING = 5, PPP_STATE_6_REQ_SENT = 6, PPP_STATE_7_ACK_RCVD = 7, PPP_STATE_8_ACK_SENT = 8, PPP_STATE_9_OPENED = 9 }
	LCP/NCP states. More...

enum	PppProtocol { PPP_PROTOCOL_IP = 0x0021, PPP_PROTOCOL_IPV6 = 0x0057, PPP_PROTOCOL_IPCP = 0x8021, PPP_PROTOCOL_IPV6CP = 0x8057, PPP_PROTOCOL_LCP = 0xC021, PPP_PROTOCOL_PAP = 0xC023, PPP_PROTOCOL_LQR = 0xC025, PPP_PROTOCOL_CHAP = 0xC223 }
	Protocol field values. More...

enum	PppCode { PPP_CODE_CONFIGURE_REQ = 1, PPP_CODE_CONFIGURE_ACK = 2, PPP_CODE_CONFIGURE_NAK = 3, PPP_CODE_CONFIGURE_REJ = 4, PPP_CODE_TERMINATE_REQ = 5, PPP_CODE_TERMINATE_ACK = 6, PPP_CODE_CODE_REJ = 7, PPP_CODE_PROTOCOL_REJ = 8, PPP_CODE_ECHO_REQ = 9, PPP_CODE_ECHO_REP = 10, PPP_CODE_DISCARD_REQ = 11 }
	Code field values. More...

enum	PppAuthProtocol { PPP_AUTH_PROTOCOL_PAP = 0x01, PPP_AUTH_PROTOCOL_CHAP_MD5 = 0x02, PPP_AUTH_PROTOCOL_MS_CHAP = 0x04, PPP_AUTH_PROTOCOL_MS_CHAP_2 = 0x08 }
	PPP authentication protocols. More...

Functions
void	pppGetDefaultSettings (PppSettings *settings)
	Initialize settings with default values. More...

error_t	pppInit (PppContext context, const PppSettings settings)
	PPP initialization. More...

error_t	pppSetTimeout (NetInterface *interface, systime_t timeout)
	Set timeout value for blocking operations. More...

error_t	pppSetAuthInfo (NetInterface interface, const char_t username, const char_t *password)
	Set PPP authentication information. More...

bool_t	pppCheckPassword (NetInterface interface, const char_t password)
	Password verification. More...

error_t	pppSendAtCommand (NetInterface interface, const char_t data)
	Send AT command. More...

error_t	pppReceiveAtCommand (NetInterface interface, char_t data, size_t size)
	Wait for an incoming AT command. More...

error_t	pppConnect (NetInterface *interface)
	Establish a PPP connection. More...

error_t	pppClose (NetInterface *interface)
	Close a PPP connection. More...

void	pppTick (NetInterface *interface)
	PPP timer handler. More...

void	pppProcessFrame (NetInterface interface, uint8_t frame, size_t length, NetRxAncillary *ancillary)
	Process an incoming PPP frame. More...

error_t	pppSendFrame (NetInterface interface, NetBuffer buffer, size_t offset, uint16_t protocol)
	Send a PPP frame. More...

size_t	pppParseFrameHeader (const uint8_t frame, size_t length, uint16_t protocol)
	Parse PPP frame header. More...

uint16_t	pppCalcFcs (const uint8_t *data, size_t length)
	FCS calculation. More...

uint16_t	pppCalcFcsEx (const NetBuffer *buffer, size_t offset, size_t length)
	Calculate FCS over a multi-part buffer. More...

NetBuffer *	pppAllocBuffer (size_t length, size_t *offset)
	Allocate a buffer to hold a PPP frame. More...

Variables
__packed_struct	_PppPacket
	LCP/NCP packet header. More...

uint8_t	identifier

uint16_t	length

uint8_t	data []

typedef	__packed_struct
	Configure-Request, Configure-Ack, Configure-Nak and Configure-Reject packets. More...

uint8_t	options []

	PppConfigurePacket

	PppTerminatePacket

uint8_t	rejectedPacket []

	PppCodeRejPacket

uint16_t	rejectedProtocol

uint8_t	rejectedInfo []

	PppProtocolRejPacket

uint32_t	magicNumber

	PppEchoPacket

	PppDiscardReqPacket

	PppOption

systime_t	pppTickCounter

Detailed Description

PPP (Point-to-Point Protocol)

License

SPDX-License-Identifier: GPL-2.0-or-later

This file is part of CycloneTCP Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author: Oryx Embedded SARL (www.oryx-embedded.com)

Version: 2.5.4

Definition in file ppp.h.

Macro Definition Documentation

◆ PPP_ADDR_FIELD

#define PPP_ADDR_FIELD 0xFF

Definition at line 150 of file ppp.h.

◆ PPP_CTRL_FIELD

#define PPP_CTRL_FIELD 0x03

PPP Control field.

Definition at line 152 of file ppp.h.

◆ PPP_DEFAULT_ACCM

#define PPP_DEFAULT_ACCM 0xFFFFFFFF

Definition at line 130 of file ppp.h.

◆ PPP_DEFAULT_MAGIC_NUMBER

#define PPP_DEFAULT_MAGIC_NUMBER 0

Definition at line 132 of file ppp.h.

◆ PPP_DEFAULT_MRU

#define PPP_DEFAULT_MRU 1500

Definition at line 128 of file ppp.h.

◆ PPP_ESC_CHAR

#define PPP_ESC_CHAR 0x7D

Definition at line 124 of file ppp.h.

◆ PPP_FCS_SIZE

#define PPP_FCS_SIZE 2

Definition at line 145 of file ppp.h.

◆ PPP_FLAG_CHAR

#define PPP_FLAG_CHAR 0x7E

Definition at line 125 of file ppp.h.

◆ PPP_FRAME_HEADER_SIZE

#define PPP_FRAME_HEADER_SIZE 4

Definition at line 143 of file ppp.h.

◆ PPP_MASK_CHAR

#define PPP_MASK_CHAR 0x20

Definition at line 123 of file ppp.h.

◆ PPP_MAX_CONF_REQ_SIZE

#define PPP_MAX_CONF_REQ_SIZE 128

Definition at line 140 of file ppp.h.

◆ PPP_MAX_CONFIGURE

#define PPP_MAX_CONFIGURE 10

Definition at line 103 of file ppp.h.

◆ PPP_MAX_FAILURE

#define PPP_MAX_FAILURE 5

Definition at line 117 of file ppp.h.

◆ PPP_MAX_FRAME_SIZE

#define PPP_MAX_FRAME_SIZE (PPP_FRAME_HEADER_SIZE + PPP_MAX_MRU + PPP_FCS_SIZE)

Definition at line 147 of file ppp.h.

◆ PPP_MAX_MRU

#define PPP_MAX_MRU 1500

Definition at line 137 of file ppp.h.

◆ PPP_MAX_PASSWORD_LEN

#define PPP_MAX_PASSWORD_LEN 31

Definition at line 75 of file ppp.h.

◆ PPP_MAX_TERMINATE

#define PPP_MAX_TERMINATE 2

Definition at line 110 of file ppp.h.

◆ PPP_MAX_USERNAME_LEN

#define PPP_MAX_USERNAME_LEN 31

Definition at line 68 of file ppp.h.

◆ PPP_MIN_MRU

#define PPP_MIN_MRU 32

Definition at line 135 of file ppp.h.

◆ PPP_POLLING_INTERVAL

#define PPP_POLLING_INTERVAL 50

Definition at line 89 of file ppp.h.

◆ PPP_RESTART_TIMER

#define PPP_RESTART_TIMER 3000

Definition at line 96 of file ppp.h.

◆ PPP_RX_BUFFER_SIZE

#define PPP_RX_BUFFER_SIZE 8192

Definition at line 61 of file ppp.h.

◆ PPP_SUPPORT

#define PPP_SUPPORT DISABLED

Definition at line 47 of file ppp.h.

◆ PPP_TICK_INTERVAL

#define PPP_TICK_INTERVAL 500

Definition at line 82 of file ppp.h.

◆ PPP_TX_BUFFER_SIZE

#define PPP_TX_BUFFER_SIZE 4096

Definition at line 54 of file ppp.h.

◆ PppContext

#define PppContext struct _PppContext

Definition at line 38 of file ppp.h.

◆ PppPacket

#define PppPacket struct _PppPacket

Definition at line 37 of file ppp.h.

Typedef Documentation

◆ PppAuthCallback

typedef bool_t(* PppAuthCallback) (NetInterface *interface, const char_t *username)

PPP authentication callback function.

Definition at line 376 of file ppp.h.

◆ PppRandCallback

typedef error_t(* PppRandCallback) (uint8_t *data, size_t length)

Random data generation callback function.

Definition at line 369 of file ppp.h.

Enumeration Type Documentation

◆ PppAuthProtocol

enum PppAuthProtocol

PPP authentication protocols.

Enumerator
PPP_AUTH_PROTOCOL_PAP
PPP_AUTH_PROTOCOL_CHAP_MD5
PPP_AUTH_PROTOCOL_MS_CHAP
PPP_AUTH_PROTOCOL_MS_CHAP_2

Definition at line 234 of file ppp.h.

◆ PppCode

enum PppCode

Code field values.

Enumerator
PPP_CODE_CONFIGURE_REQ	Configure-Request.
PPP_CODE_CONFIGURE_ACK	Configure-Ack.
PPP_CODE_CONFIGURE_NAK	Configure-Nak.
PPP_CODE_CONFIGURE_REJ	Configure-Reject.
PPP_CODE_TERMINATE_REQ	Terminate-Request.
PPP_CODE_TERMINATE_ACK	Terminate-Ack.
PPP_CODE_CODE_REJ	Code-Reject.
PPP_CODE_PROTOCOL_REJ	Protocol-Reject.
PPP_CODE_ECHO_REQ	Echo-Request.
PPP_CODE_ECHO_REP	Echo-Reply.
PPP_CODE_DISCARD_REQ	Discard-Request.

Definition at line 214 of file ppp.h.

◆ PppPhase

enum PppPhase

PPP phases.

Enumerator
PPP_PHASE_DEAD	Link dead.
PPP_PHASE_ESTABLISH	Link establishment phase.
PPP_PHASE_AUTHENTICATE	Authentication phase.
PPP_PHASE_NETWORK	Network-layer protocol phase.
PPP_PHASE_TERMINATE	Link termination phase.

Definition at line 164 of file ppp.h.

◆ PppProtocol

enum PppProtocol

Protocol field values.

Enumerator
PPP_PROTOCOL_IP	Internet Protocol.
PPP_PROTOCOL_IPV6	Internet Protocol version 6.
PPP_PROTOCOL_IPCP	IP Control Protocol.
PPP_PROTOCOL_IPV6CP	IPv6 Control Protocol.
PPP_PROTOCOL_LCP	Link Control Protocol.
PPP_PROTOCOL_PAP	Password Authentication Protocol.
PPP_PROTOCOL_LQR	Link Quality Report.
PPP_PROTOCOL_CHAP	Challenge Handshake Authentication Protocol.

Definition at line 197 of file ppp.h.

◆ PppState

enum PppState

LCP/NCP states.

Enumerator
PPP_STATE_0_INITIAL
PPP_STATE_1_STARTING
PPP_STATE_2_CLOSED
PPP_STATE_3_STOPPED
PPP_STATE_4_CLOSING
PPP_STATE_5_STOPPING
PPP_STATE_6_REQ_SENT
PPP_STATE_7_ACK_RCVD
PPP_STATE_8_ACK_SENT
PPP_STATE_9_OPENED

Definition at line 178 of file ppp.h.

Function Documentation

◆ pppAllocBuffer()

NetBuffer* pppAllocBuffer	(	size_t	length,
		size_t *	offset
	)

Allocate a buffer to hold a PPP frame.

Parameters

[in]	length	Desired payload length
[out]	offset	Offset to the first byte of the payload

Returns: The function returns a pointer to the newly allocated buffer. If the system is out of resources, NULL is returned

Definition at line 1305 of file ppp.c.

◆ pppCalcFcs()

uint16_t pppCalcFcs	(	const uint8_t *	data,
		size_t	length
	)

FCS calculation.

Parameters

[in]	data	Pointer to the data over which to calculate the FCS
[in]	length	Number of bytes to process

Returns: Resulting FCS value

Definition at line 1220 of file ppp.c.

◆ pppCalcFcsEx()

uint16_t pppCalcFcsEx	(	const NetBuffer *	buffer,
		size_t	offset,
		size_t	length
	)

Calculate FCS over a multi-part buffer.

Parameters

[in]	buffer	Pointer to the multi-part buffer
[in]	offset	Offset from the beginning of the buffer
[in]	length	Number of bytes to process

Returns: Resulting FCS value

Definition at line 1248 of file ppp.c.

◆ pppCheckPassword()

bool_t pppCheckPassword	(	NetInterface *	interface,
		const char_t *	password
	)

Password verification.

Parameters

[in]	interface	Underlying network interface
[in]	password	NULL-terminated string containing the password to be checked

Returns: TRUE if the password is valid, else FALSE

Definition at line 283 of file ppp.c.

◆ pppClose()

error_t pppClose ( NetInterface * interface )

Close a PPP connection.

Parameters

[in] interface Underlying network interface

Returns: Error code

Definition at line 744 of file ppp.c.

◆ pppConnect()

error_t pppConnect ( NetInterface * interface )

Establish a PPP connection.

Parameters

[in] interface Underlying network interface

Returns: Error code

Definition at line 475 of file ppp.c.

◆ pppGetDefaultSettings()

void pppGetDefaultSettings ( PppSettings * settings )

Initialize settings with default values.

Parameters

[out] settings Structure that contains PPP settings

Definition at line 98 of file ppp.c.

◆ pppInit()

error_t pppInit	(	PppContext *	context,
		const PppSettings *	settings
	)

PPP initialization.

Parameters

[in]	context	Pointer to the PPP context
[in]	settings	PPP specific settings

Returns: Error code

Definition at line 124 of file ppp.c.

◆ pppParseFrameHeader()

size_t pppParseFrameHeader	(	const uint8_t *	frame,
		size_t	length,
		uint16_t *	protocol
	)

Parse PPP frame header.

Parameters

[in]	frame	Pointer to the PPP frame
[in]	length	Length of the frame, in bytes
[out]	protocol	Value of the Protocol field

Returns: If the PPP header was successfully parsed, the function returns the size of the PPP header, in bytes. If a parsing error occurred, zero is returned

Definition at line 1148 of file ppp.c.

◆ pppProcessFrame()

void pppProcessFrame	(	NetInterface *	interface,
		uint8_t *	frame,
		size_t	length,
		NetRxAncillary *	ancillary
	)

Process an incoming PPP frame.

Parameters

[in]	interface	Underlying network interface
[in]	frame	Incoming PPP frame to process
[in]	length	Total frame length
[in]	ancillary	Additional options passed to the stack along with the packet

Definition at line 909 of file ppp.c.

◆ pppReceiveAtCommand()

error_t pppReceiveAtCommand	(	NetInterface *	interface,
		char_t *	data,
		size_t	size
	)

Wait for an incoming AT command.

Parameters

[in]	interface	Underlying network interface
[out]	data	Buffer where to store the incoming AT command
[in]	size	Size of the buffer, in bytes

Returns: Error code

Definition at line 394 of file ppp.c.

◆ pppSendAtCommand()

error_t pppSendAtCommand	(	NetInterface *	interface,
		const char_t *	data
	)

Send AT command.

Parameters

[in]	interface	Underlying network interface
[in]	data	NULL-terminated string that contains the AT command to be sent

Returns: Error code

Definition at line 330 of file ppp.c.

◆ pppSendFrame()

error_t pppSendFrame	(	NetInterface *	interface,
		NetBuffer *	buffer,
		size_t	offset,
		uint16_t	protocol
	)

Send a PPP frame.

Parameters

[in]	interface	Underlying network interface
[in]	buffer	Multi-part buffer containing the data
[in]	offset	Offset to the first data byte
[in]	protocol	Protocol field value

Returns: Error code

Definition at line 1035 of file ppp.c.

◆ pppSetAuthInfo()

error_t pppSetAuthInfo	(	NetInterface *	interface,
		const char_t *	username,
		const char_t *	password
	)

Set PPP authentication information.

Parameters

[in]	interface	Underlying network interface
[in]	username	NULL-terminated string containing the user name to be used
[in]	password	NULL-terminated string containing the password to be used

Returns: Error code

Definition at line 236 of file ppp.c.

◆ pppSetTimeout()

error_t pppSetTimeout	(	NetInterface *	interface,
		systime_t	timeout
	)

Set timeout value for blocking operations.

Parameters

[in]	interface	Underlying network interface
[in]	timeout	Maximum time to wait

Returns: Error code

Definition at line 199 of file ppp.c.

◆ pppTick()

void pppTick ( NetInterface * interface )

PPP timer handler.

This routine must be periodically called by the TCP/IP stack to manage retransmissions

Parameters

[in] interface Underlying network interface

Definition at line 864 of file ppp.c.

Variable Documentation

◆ __packed_struct

typedef __packed_struct

Initial value:

{

uint8_t code

Configure-Request, Configure-Ack, Configure-Nak and Configure-Reject packets.

LCP/NCP option.

PPP Discard-Request packet.

Echo-Request and Echo-Reply packet.

Protocol-Reject packet.

Code-Reject packet.

Terminate-Request and Terminate-Ack packet.

Definition at line 268 of file ppp.h.

◆ _PppPacket

__packed_struct _PppPacket

Initial value:

{

uint8_t code

LCP/NCP packet header.

Definition at line 255 of file ppp.h.

◆ data

uint8_t data[]

Definition at line 260 of file ppp.h.

◆ identifier

uint8_t identifier

Definition at line 258 of file ppp.h.

◆ length

uint8_t length

Definition at line 259 of file ppp.h.

◆ magicNumber

uint32_t magicNumber

Definition at line 326 of file ppp.h.

◆ options

uint8_t options[]

Definition at line 273 of file ppp.h.

◆ PppCodeRejPacket

PppCodeRejPacket

Definition at line 300 of file ppp.h.

◆ PppConfigurePacket

PppConfigurePacket

Definition at line 274 of file ppp.h.

◆ PppDiscardReqPacket

PppDiscardReqPacket

Definition at line 342 of file ppp.h.

◆ PppEchoPacket

PppEchoPacket

Definition at line 328 of file ppp.h.

◆ PppOption

PppOption

Definition at line 354 of file ppp.h.

◆ PppProtocolRejPacket

PppProtocolRejPacket

Definition at line 314 of file ppp.h.

◆ PppTerminatePacket

PppTerminatePacket

Definition at line 287 of file ppp.h.

◆ pppTickCounter

systime_t pppTickCounter

extern

Definition at line 53 of file ppp.c.

◆ rejectedInfo

uint8_t rejectedInfo[]

Definition at line 313 of file ppp.h.

◆ rejectedPacket

uint8_t rejectedPacket[]

Definition at line 299 of file ppp.h.

◆ rejectedProtocol

uint16_t rejectedProtocol

Definition at line 312 of file ppp.h.

Data Structures

Macros

Typedefs

Enumerations

Functions

Variables

Detailed Description

License

Macro Definition Documentation

◆ PPP_ADDR_FIELD

◆ PPP_CTRL_FIELD

◆ PPP_DEFAULT_ACCM

◆ PPP_DEFAULT_MAGIC_NUMBER

◆ PPP_DEFAULT_MRU

◆ PPP_ESC_CHAR

◆ PPP_FCS_SIZE

◆ PPP_FLAG_CHAR

◆ PPP_FRAME_HEADER_SIZE

◆ PPP_MASK_CHAR

◆ PPP_MAX_CONF_REQ_SIZE

◆ PPP_MAX_CONFIGURE

◆ PPP_MAX_FAILURE

◆ PPP_MAX_FRAME_SIZE

◆ PPP_MAX_MRU

◆ PPP_MAX_PASSWORD_LEN

◆ PPP_MAX_TERMINATE

◆ PPP_MAX_USERNAME_LEN

◆ PPP_MIN_MRU

◆ PPP_POLLING_INTERVAL

◆ PPP_RESTART_TIMER

◆ PPP_RX_BUFFER_SIZE

◆ PPP_SUPPORT

◆ PPP_TICK_INTERVAL

◆ PPP_TX_BUFFER_SIZE

◆ PppContext

◆ PppPacket

Typedef Documentation

◆ PppAuthCallback

◆ PppRandCallback

Enumeration Type Documentation

◆ PppAuthProtocol

◆ PppCode

◆ PppPhase

◆ PppProtocol

◆ PppState

Function Documentation

◆ pppAllocBuffer()

◆ pppCalcFcs()

◆ pppCalcFcsEx()

◆ pppCheckPassword()

◆ pppClose()

◆ pppConnect()

◆ pppGetDefaultSettings()

◆ pppInit()

◆ pppParseFrameHeader()

◆ pppProcessFrame()

◆ pppReceiveAtCommand()

◆ pppSendAtCommand()

◆ pppSendFrame()

◆ pppSetAuthInfo()

◆ pppSetTimeout()

◆ pppTick()

Variable Documentation

◆ __packed_struct

◆ _PppPacket

◆ data

◆ identifier

◆ length

◆ magicNumber

◆ options

◆ PppCodeRejPacket

◆ PppConfigurePacket

◆ PppDiscardReqPacket

◆ PppEchoPacket

◆ PppOption

◆ PppProtocolRejPacket

◆ PppTerminatePacket

◆ pppTickCounter

◆ rejectedInfo

◆ rejectedPacket