Low-Level functions

Low-level module consists of callback-only functions, which are called by middleware and must be implemented by final application.

Tip

Check Porting guide for actual implementation

group LWCELL_LL

Low-level communication functions.

Typedefs

typedef size_t (*lwcell_ll_send_fn)(const void *data, size_t len)

Function prototype for AT output data.

Param data

[in] Pointer to data to send. This parameter can be set to NULL, indicating to the low-level that (if used) DMA could be started to transmit data to the device

Param len

[in] Number of bytes to send. This parameter can be set to 0 to indicate that internal buffer can be flushed to stream. This is implementation defined and feature might be ignored

Return

Number of bytes sent

typedef uint8_t (*lwcell_ll_reset_fn)(uint8_t state)

Function prototype for hardware reset of GSM device.

Param state

[in] State indicating reset. When set to 1, reset must be active (usually pin active low), or set to 0 when reset is cleared

Return

1 on successful action, 0 otherwise

Functions

lwcellr_t lwcell_ll_init(lwcell_ll_t *ll)

Callback function called from initialization process.

Note

This function may be called multiple times if AT baudrate is changed from application. It is important that every configuration except AT baudrate is configured only once!

Note

This function may be called from different threads in GSM stack when using OS. When LWCELL_CFG_INPUT_USE_PROCESS is set to 1, this function may be called from user UART thread.

Parameters

ll – [inout] Pointer to lwcell_ll_t structure to fill data for communication functions

Returns

lwcellOK on success, member of lwcellr_t enumeration otherwise

lwcellr_t lwcell_ll_deinit(lwcell_ll_t *ll)

Callback function to de-init low-level communication part.

Parameters

ll – [inout] Pointer to lwcell_ll_t structure to fill data for communication functions

Returns

lwcellOK on success, member of lwcellr_t enumeration otherwise

struct lwcell_ll_t

#include <lwcell_types.h>

Low level user specific functions.

Public Members

lwcell_ll_send_fn send_fn

Callback function to transmit data

lwcell_ll_reset_fn reset_fn

Reset callback function

uint32_t baudrate

UART baudrate value

struct lwcell_ll_t::[anonymous] uart

UART communication parameters