Modem Pipe

Modem Pipe. More...

Typedefs
typedef void(*	modem_pipe_api_callback) (struct modem_pipe *pipe, enum modem_pipe_event event, void *user_data)

Enumerations
enum	modem_pipe_event { MODEM_PIPE_EVENT_OPENED = 0 , MODEM_PIPE_EVENT_RECEIVE_READY , MODEM_PIPE_EVENT_CLOSED }
	Modem pipe event. More...

Functions
int	modem_pipe_open (struct modem_pipe *pipe)
	Open pipe.
int	modem_pipe_open_async (struct modem_pipe *pipe)
	Open pipe asynchronously.
void	modem_pipe_attach (struct modem_pipe *pipe, modem_pipe_api_callback callback, void *user_data)
	Attach pipe to callback.
int	modem_pipe_transmit (struct modem_pipe *pipe, const uint8_t *buf, size_t size)
	Transmit data through pipe.
int	modem_pipe_receive (struct modem_pipe *pipe, uint8_t *buf, size_t size)
	Reveive data through pipe.
void	modem_pipe_release (struct modem_pipe *pipe)
	Clear callback.
int	modem_pipe_close (struct modem_pipe *pipe)
	Close pipe.
int	modem_pipe_close_async (struct modem_pipe *pipe)
	Close pipe asynchronously.

Detailed Description

Modem Pipe.

Typedef Documentation

modem_pipe_api_callback

typedef void(* modem_pipe_api_callback) (struct modem_pipe *pipe, enum modem_pipe_event event, void *user_data)

#include <zephyr/modem/pipe.h>

Enumeration Type Documentation

modem_pipe_event

enum modem_pipe_event

#include <zephyr/modem/pipe.h>

Modem pipe event.

Enumerator
MODEM_PIPE_EVENT_OPENED
MODEM_PIPE_EVENT_RECEIVE_READY
MODEM_PIPE_EVENT_CLOSED

Function Documentation

modem_pipe_attach()

void modem_pipe_attach	(	struct modem_pipe *	pipe,
		modem_pipe_api_callback	callback,
		void *	user_data
	)

#include <zephyr/modem/pipe.h>

Attach pipe to callback.

Parameters

pipe	Pipe instance
callback	Callback called when pipe event occurs
user_data	Free to use user data passed with callback

Note

The MODEM_PIPE_EVENT_RECEIVE_READY event is invoked immediately if pipe has pending data ready to receive.

modem_pipe_close()

int modem_pipe_close

(

struct modem_pipe *

pipe

)

#include <zephyr/modem/pipe.h>

Close pipe.

Parameters

pipe	Pipe instance

Return values

0	if pipe open was called closed or pipe was already closed
-errno	code otherwise

modem_pipe_close_async()

int modem_pipe_close_async

(

struct modem_pipe *

pipe

)

#include <zephyr/modem/pipe.h>

Close pipe asynchronously.

Parameters

pipe	Pipe instance

Note

The MODEM_PIPE_EVENT_CLOSED event is invoked immediately if pipe is already closed.

Return values

0	if pipe close was called successfully or pipe was already closed
-errno	code otherwise

modem_pipe_open()

int modem_pipe_open

(

struct modem_pipe *

pipe

)

#include <zephyr/modem/pipe.h>

Open pipe.

Parameters

pipe	Pipe instance

Return values

0	if pipe was successfully opened or was already open
-errno	code otherwise

modem_pipe_open_async()

int modem_pipe_open_async

(

struct modem_pipe *

pipe

)

#include <zephyr/modem/pipe.h>

Open pipe asynchronously.

Parameters

pipe	Pipe instance

Note

The MODEM_PIPE_EVENT_OPENED event is invoked immediately if pipe is already opened.

Return values

0	if pipe open was called successfully or pipe was already open
-errno	code otherwise

modem_pipe_receive()

int modem_pipe_receive	(	struct modem_pipe *	pipe,
		uint8_t *	buf,
		size_t	size
	)

#include <zephyr/modem/pipe.h>

Reveive data through pipe.

Parameters

pipe	Pipe to receive from
buf	Destination for reveived data
size	Capacity of destination for recevied data

Returns

Number of bytes received from pipe if any

-EPERM if pipe is closed

-errno code on error

Warning

This call must be non-blocking

modem_pipe_release()

void modem_pipe_release

(

struct modem_pipe *

pipe

)

#include <zephyr/modem/pipe.h>

Clear callback.

Parameters

pipe	Pipe instance

modem_pipe_transmit()

int modem_pipe_transmit	(	struct modem_pipe *	pipe,
		const uint8_t *	buf,
		size_t	size
	)

#include <zephyr/modem/pipe.h>

Transmit data through pipe.

Parameters

pipe	Pipe to transmit through
buf	Destination for reveived data
size	Capacity of destination for recevied data

Returns

Number of bytes placed in pipe

Warning

This call must be non-blocking