[Main]
Name=put
Type=Function
Header=cabl_int.h
Definition=int (*put) (@uint8_t@ data);

[Parameters]
data : the byte to send.
Returns : 0 if successful, an error code otherwise.

[Summary]
Send a byte over the cable.

[Description]
The function attempts to send a byte. It's blocking but it the time is over the timeout value, the function returns with an error code.

Timeout value can be changed at any time with the @ticable_set_timeout@ function.

When function returns, it typically returns:
<br>- either ERR_WRITE_ERROR : system error,
<br>- either ERR_WRITE_TIMEOUT : timed out.

[See also]
Error codes are listed in cabl_err.h.
The @TicableLinkCable@ structure.
