soe_request.h File Reference

EtherCAT SoE request structure. More...

Go to the source code of this file.

Data Structures
struct	ec_soe_request
	Sercos-over-EtherCAT request. More...

Functions
void	ec_soe_request_init (ec_soe_request_t *)
	SoE request constructor.
void	ec_soe_request_clear (ec_soe_request_t *)
	SoE request destructor.
int	ec_soe_request_copy (ec_soe_request_t *, const ec_soe_request_t *)
	Copy another SoE request. More...
void	ec_soe_request_set_drive_no (ec_soe_request_t *, uint8_t)
	Set drive number.
void	ec_soe_request_set_idn (ec_soe_request_t *, uint16_t)
	Set IDN.
int	ec_soe_request_alloc (ec_soe_request_t *, size_t)
	Pre-allocates the data memory. More...
int	ec_soe_request_copy_data (ec_soe_request_t *, const uint8_t *, size_t)
	Copies SoE data from an external source. More...
int	ec_soe_request_append_data (ec_soe_request_t *, const uint8_t *, size_t)
	Copies SoE data from an external source. More...
int	ec_soe_request_read (ec_soe_request_t *)
	Request a read operation.
int	ec_soe_request_write (ec_soe_request_t *)
	Request a write operation.
int	ec_soe_request_timed_out (const ec_soe_request_t *)
	Checks, if the timeout was exceeded. More...

Detailed Description

EtherCAT SoE request structure.

Definition in file soe_request.h.

Function Documentation

ec_soe_request_copy()

int ec_soe_request_copy	(	ec_soe_request_t *	req,
		const ec_soe_request_t *	other
	)

Copy another SoE request.

Returns

Zero on success, otherwise a negative error code.

Parameters

req	SoE request.
other	Other SoE request to copy from.

Definition at line 84 of file soe_request.c.

ec_soe_request_alloc()

int ec_soe_request_alloc	(	ec_soe_request_t *	req,
		size_t	size
	)

Pre-allocates the data memory.

If the mem_size is already bigger than size, nothing is done.

Returns

0 on success, otherwise -ENOMEM.

Parameters

req	SoE request.
size	Data size to allocate.

Definition at line 144 of file soe_request.c.

ec_soe_request_copy_data()

int ec_soe_request_copy_data	(	ec_soe_request_t *	req,
		const uint8_t *	source,
		size_t	size
	)

Copies SoE data from an external source.

If the mem_size is to small, new memory is allocated.

Return values

0	Success.
<0	Error code.

Parameters

req	SoE request.
source	Source data.
size	Number of bytes in source.

Definition at line 173 of file soe_request.c.

ec_soe_request_append_data()

int ec_soe_request_append_data	(	ec_soe_request_t *	req,
		const uint8_t *	source,
		size_t	size
	)

Copies SoE data from an external source.

If the mem_size is to small, new memory is allocated.

Return values

0	Success.
<0	Error code.

Parameters

req	SoE request.
source	Source data.
size	Number of bytes in source.

Definition at line 197 of file soe_request.c.

ec_soe_request_timed_out()

int ec_soe_request_timed_out

(

const ec_soe_request_t *

req

)

Checks, if the timeout was exceeded.

Returns

non-zero if the timeout was exceeded, else zero.

Parameters

req	SDO request.

Definition at line 258 of file soe_request.c.