Firmware SDK
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
bc_module_sigfox

Driver for BigClown SigFox Module. More...

Enumerations

enum  bc_module_sigfox_revision_t {
  BC_MODULE_SIGFOX_REVISION_R1 = 0,
  BC_MODULE_SIGFOX_REVISION_R2 = 1
}
 SigFox Module hardware revision. More...
 
enum  bc_module_sigfox_event_t {
  BC_MODULE_SIGFOX_EVENT_READY = 0,
  BC_MODULE_SIGFOX_EVENT_ERROR = 1,
  BC_MODULE_SIGFOX_EVENT_SEND_RF_FRAME_START = 2,
  BC_MODULE_SIGFOX_EVENT_SEND_RF_FRAME_DONE = 3,
  BC_MODULE_SIGFOX_EVENT_READ_DEVICE_ID = 4,
  BC_MODULE_SIGFOX_EVENT_READ_DEVICE_PAC = 5
}
 Callback events. More...
 

Functions

void bc_module_sigfox_init (bc_module_sigfox_t *self, bc_module_sigfox_revision_t revision)
 Initialize BigClown SigFox Module. More...
 
void bc_module_sigfox_set_event_handler (bc_module_sigfox_t *self, void(*event_handler)(bc_module_sigfox_t *, bc_module_sigfox_event_t, void *), void *event_param)
 Set callback function. More...
 
bool bc_module_sigfox_is_ready (bc_module_sigfox_t *self)
 Check if modem is ready for commands. More...
 
bool bc_module_sigfox_send_rf_frame (bc_module_sigfox_t *self, const void *buffer, size_t length)
 Send RF frame command. More...
 
bool bc_module_sigfox_read_device_id (bc_module_sigfox_t *self)
 Read device ID command. More...
 
bool bc_module_sigfox_get_device_id (bc_module_sigfox_t *self, char *buffer, size_t buffer_size)
 Get device ID (can be called only in BC_WSSFM10R1AT_EVENT_READ_DEVICE_ID event) More...
 
bool bc_module_sigfox_read_device_pac (bc_module_sigfox_t *self)
 Read device PAC command. More...
 
bool bc_module_sigfox_get_device_pac (bc_module_sigfox_t *self, char *buffer, size_t buffer_size)
 Get device PAC (can be called only in BC_WSSFM10R1AT_EVENT_READ_DEVICE_ID event) More...
 
bool bc_module_sigfox_continuous_wave (bc_module_sigfox_t *self)
 Generate continuous wave command. More...
 

Detailed Description

Driver for BigClown SigFox Module.

Enumeration Type Documentation

Callback events.

Enumerator
BC_MODULE_SIGFOX_EVENT_READY 

Ready event.

BC_MODULE_SIGFOX_EVENT_ERROR 

Error event.

BC_MODULE_SIGFOX_EVENT_SEND_RF_FRAME_START 

RF frame transmission started event.

BC_MODULE_SIGFOX_EVENT_SEND_RF_FRAME_DONE 

RF frame transmission finished event.

BC_MODULE_SIGFOX_EVENT_READ_DEVICE_ID 

Device ID has been read event.

BC_MODULE_SIGFOX_EVENT_READ_DEVICE_PAC 

Device PAC has been read event.

Definition at line 25 of file bc_module_sigfox.h.

SigFox Module hardware revision.

Enumerator
BC_MODULE_SIGFOX_REVISION_R1 

Hardware revision R1.

BC_MODULE_SIGFOX_REVISION_R2 

Hardware revision R2.

Definition at line 13 of file bc_module_sigfox.h.

Function Documentation

bool bc_module_sigfox_continuous_wave ( bc_module_sigfox_t *  self)

Generate continuous wave command.

Parameters
[in]selfInstance
Returns
true If command was accepted for processing
false If command was denied for processing

Definition at line 94 of file bc_module_sigfox.c.

Here is the call graph for this function:

bool bc_module_sigfox_get_device_id ( bc_module_sigfox_t *  self,
char *  buffer,
size_t  buffer_size 
)

Get device ID (can be called only in BC_WSSFM10R1AT_EVENT_READ_DEVICE_ID event)

Parameters
[in]selfInstance
[out]bufferPointer to destination buffer
[in]buffer_sizeSize of destination buffer
Returns
true If device ID was retrieved
false If device ID could not be retrieved

Definition at line 64 of file bc_module_sigfox.c.

Here is the call graph for this function:

bool bc_module_sigfox_get_device_pac ( bc_module_sigfox_t *  self,
char *  buffer,
size_t  buffer_size 
)

Get device PAC (can be called only in BC_WSSFM10R1AT_EVENT_READ_DEVICE_ID event)

Parameters
[in]selfInstance
[out]bufferPointer to destination buffer
[in]buffer_sizeSize of destination buffer
Returns
true If device PAC was retrieved
false If device PAC could not be retrieved

Definition at line 84 of file bc_module_sigfox.c.

Here is the call graph for this function:

void bc_module_sigfox_init ( bc_module_sigfox_t *  self,
bc_module_sigfox_revision_t  revision 
)

Initialize BigClown SigFox Module.

Parameters
[in]selfInstance

Definition at line 7 of file bc_module_sigfox.c.

Here is the call graph for this function:

bool bc_module_sigfox_is_ready ( bc_module_sigfox_t *  self)

Check if modem is ready for commands.

Parameters
[in]selfInstance
Returns
true If ready
false If not ready

Definition at line 34 of file bc_module_sigfox.c.

Here is the call graph for this function:

bool bc_module_sigfox_read_device_id ( bc_module_sigfox_t *  self)

Read device ID command.

Parameters
[in]selfInstance
Returns
true If command was accepted for processing
false If command was denied for processing

Definition at line 54 of file bc_module_sigfox.c.

Here is the call graph for this function:

bool bc_module_sigfox_read_device_pac ( bc_module_sigfox_t *  self)

Read device PAC command.

Parameters
[in]selfInstance
Returns
true If command was accepted for processing
false If command was denied for processing

Definition at line 74 of file bc_module_sigfox.c.

Here is the call graph for this function:

bool bc_module_sigfox_send_rf_frame ( bc_module_sigfox_t *  self,
const void *  buffer,
size_t  length 
)

Send RF frame command.

Parameters
[in]selfInstance
[in]bufferPointer to data to be transmitted
[in]lengthLength of data to be transmitted in bytes (must be from 1 to 12 bytes)
Returns
true If command was accepted for processing
false If command was denied for processing

Definition at line 44 of file bc_module_sigfox.c.

Here is the call graph for this function:

void bc_module_sigfox_set_event_handler ( bc_module_sigfox_t *  self,
void(*)(bc_module_sigfox_t *, bc_module_sigfox_event_t, void *)  event_handler,
void *  event_param 
)

Set callback function.

Parameters
[in]selfInstance
[in]event_handlerFunction address
[in]event_paramOptional event parameter (can be NULL)

Definition at line 27 of file bc_module_sigfox.c.