CPC Journal#

sl_cpc_journal_level_t#

sl_cpc_journal_level_t

Enumeration of journal entry levels.

sl_cpc_user_endpoint_id_t#

sl_cpc_user_endpoint_id_t

Enumeration representing user endpoint.

sl_cpc_endpoint_state_t#

sl_cpc_endpoint_state_t

Enumeration representing the possible endpoint state.

sl_cpc_endpoint_option_t#

sl_cpc_endpoint_option_t

Enumeration representing the possible configurable options for an endpoint.

sl_cpc_on_write_completed_t#

typedef void(* sl_cpc_on_write_completed_t) (sl_cpc_user_endpoint_id_t endpoint_id, void *buffer, void *arg, sl_status_t status) )(sl_cpc_user_endpoint_id_t endpoint_id, void *buffer, void *arg, sl_status_t status)

Typedef for the user - supplied callback function which is called when CPC is done with the provided buffer.

sl_cpc_on_data_reception_t#

typedef void(* sl_cpc_on_data_reception_t) (uint8_t endpoint_id, void *arg) )(uint8_t endpoint_id, void *arg)

Typedef for the user - supplied callback function which is called when CPC receive data on an endpoint.

sl_cpc_on_error_callback_t#

typedef void(* sl_cpc_on_error_callback_t) (uint8_t endpoint_id, void *arg) )(uint8_t endpoint_id, void *arg)

Typedef for the user-supplied callback function which is called when CPC detects a fatal error on an endpoint.

sl_cpc_on_connect_callback_t#

typedef void(* sl_cpc_on_connect_callback_t) (uint8_t endpoint_id, void *arg, sl_status_t status) )(uint8_t endpoint_id, void *arg, sl_status_t status)

Typedef for the user-supplied callback function which is called when CPC connection to a secondary completes, successfully or not.

Note

• If several users connect to the same endpoint on the host side, this callback will only be called only when the first connection occurs.

sl_cpc_journal_init#

void sl_cpc_journal_init (void )

Initialize the CPC journal module.

sl_cpc_journal_print#

void sl_cpc_journal_print (bool print_csv_header, sl_iostream_t * stream)

Print the contents of the CPC journal via the default IOStream.

Note

• Journal entries will be consumed when called

sl_cpc_journal_record#

void sl_cpc_journal_record (sl_cpc_journal_level_t level, const char * string, uint32_t value)

Record a journal entry.

sl_cpc_journal_print_cmd_handler#

void sl_cpc_journal_print_cmd_handler (sl_cli_command_arg_t * arguments)

Command handler to print the contents of the journal.

Note

• Journal entries will be consumed when called

sl_cpc_secondary_app_version#

const char * sl_cpc_secondary_app_version (void )

Called when secondary app version is requested.

The format is up to the user. The string should be null terminated.

sl_cpc_primary_app_version#

const char * sl_cpc_primary_app_version (void )

Called when primary app version is requested.

The format is up to the user. The string should be null terminated.

Note

• : CPC source code contains a weak definition that default to returning "UNDEFINED". If the user provides a strong definition of this function, the user shall return a static string.

Returns

• : String that represents the application version.

sl_cpc_user_is_ok_to_run#

bool sl_cpc_user_is_ok_to_run (const char * primary_app_version, const char * secondary_app_version)

Callback implemented by the user to verify if the secondary application version is compatible with this primary version.

Note

• : If this function is not implemented, then no version check will be performed and CPC API will always be available after the startup sequence.

• : The function prototype is declared as weak. No default weak definition exist.

Returns

• bool : true : CPC is authorized to start normally false : The user decided that the application versions are not compatible. CPC API will be blocked and only a firmware upgrade will be possible

sl_cpc_get_fwu_chunk#

sl_status_t sl_cpc_get_fwu_chunk (uint8_t *const chunk_buffer, const size_t index, const size_t chunk_size, size_t * size, bool * last)

Fetch the next firmware update image chunk from the user.

Note

• : The prototype is declared as weak and no weak definition exist in CPC code. Not providing an implementation by the user is valid, although if the user asks to perform a firmware upgrade, sl_firmware_upgrade_start() will return SL_STATUS_NOT_AVAILABLE

Returns

• sl_status_t : Whether or not the user has written a valid chunk. In the case where the user does not have the requested chunk in hand when this function is called and does not want to block (for example, fetching is from a serial link or an external storage), SL_STATUS_NOT_READY would be returned. The firmware update state machine will retry later to ask the user for the chunk. The index will remain the same at the next call. When a value of SL_STATUS_OK is returned, the state machine will go ahead and send the chunk to the secondary.

sl_cpc_init#

sl_status_t sl_cpc_init (void )

Initialize CPC module.

sl_cpc_process_action#

void sl_cpc_process_action (void )

The bare metal process action function.

sl_cpc_init_user_endpoint#

sl_status_t sl_cpc_init_user_endpoint (sl_cpc_endpoint_handle_t * endpoint_handle, sl_cpc_user_endpoint_id_t id, uint8_t flags)

Dynamically allocate and initialize a user endpoint.

Following the successful initialization of an endpoint, successive attempts to initialize an endpoint of the same ID will fail until the endpoint is freed.

sl_cpc_connect_endpoint#

sl_status_t sl_cpc_connect_endpoint (sl_cpc_endpoint_handle_t * endpoint_handle, uint8_t flags)

Connect endpoint to remote.

(CPC Primary only) Ths function will always block until the remote connects if no flag is specified.

sl_cpc_open_user_endpoint#

sl_status_t sl_cpc_open_user_endpoint (sl_cpc_endpoint_handle_t * endpoint_handle, sl_cpc_user_endpoint_id_t id, uint8_t flags, uint8_t tx_window_size)

Dynamically allocate and open a user endpoint.

Note

• This function will be deprecated in the future. Use sl_cpc_init_user_endpoint() and sl_cpc_listen_endpoint() instead.

sl_cpc_listen_endpoint#

sl_status_t sl_cpc_listen_endpoint (sl_cpc_endpoint_handle_t * endpoint_handle, uint8_t flags)

Put an endpoint in listening mode, waiting for the remote to connect to it.

This function will always block until the remote connects if no flag is specified.

sl_cpc_close_endpoint#

sl_status_t sl_cpc_close_endpoint (sl_cpc_endpoint_handle_t * endpoint_handle)

Close endpoint.

Note

• This function will be deprecated in the future. Use sl_cpc_terminate_endpoint() and sl_cpc_free_endpoint() instead.

sl_cpc_set_endpoint_option#

sl_status_t sl_cpc_set_endpoint_option (sl_cpc_endpoint_handle_t * endpoint_handle, sl_cpc_endpoint_option_t option, void * value)

Set endpoint option.

Returns

• Status code.

Return values

• SL_STATUS_OK: Set endpoint option successfully.

• Other: sl_status_t if error occurred.

Note

• Public options are: SL_CPC_ENDPOINT_ON_CONNECT: Set a callback that will be called when connection is established with the remote.

SL_CPC_ENDPOINT_ON_CONNECT_ARG: Set an on connect argument.

SL_CPC_ENDPOINT_ON_IFRAME_RECEIVE: Set an on iframe receive callback. value is a sl_cpc_on_data_reception_t type.

SL_CPC_ENDPOINT_ON_IFRAME_RECEIVE_ARG: Set an on iframe receive argument.

SL_CPC_ENDPOINT_ON_IFRAME_WRITE_COMPLETED: Set an on iframe write completed callback. value is a sl_cpc_on_write_completed_t type.

SL_CPC_ENDPOINT_ON_ERROR: Set an on error callback. value is a sl_cpc_on_error_callback_t type.

SL_CPC_ENDPOINT_ON_ERROR_ARG: Set an on error callback argument.

SL_CPC_ENDPOINT_SHUTDOWN_TIMEOUT: (RTOS Only) Set shutdown handshake timeout, in ticks.

SL_CPC_ENDPOINT_WRITE_TIMEOUT: (RTOS Only) Set the timeout time for blocking write in ticks.

sl_cpc_shutdown_endpoint#

sl_status_t sl_cpc_shutdown_endpoint (sl_cpc_endpoint_handle_t * endpoint_handle, uint8_t flags)

Shutdown endpoint connection.

Any pending TX frame will attempt to be transmitted.

Note

• In RTOS, this function is blocking by default. Use the SL_CPC_FLAG_NO_BLOCK flag to execute without blocking.

sl_cpc_terminate_endpoint#

sl_status_t sl_cpc_terminate_endpoint (sl_cpc_endpoint_handle_t * endpoint_handle, uint8_t flags)

Terminate an endpoint, effectively dropping any pending TX and RX frame.

In RTOS, this function will always block until all frames have been dropped.

Note

• This function must be called before attempting to reconnect an endpoint to the remote.

sl_cpc_free_endpoint#

sl_status_t sl_cpc_free_endpoint (sl_cpc_endpoint_handle_t * endpoint_handle)

Free the memory associated to an endpoint so it can be reused.

sl_cpc_abort_read#

sl_status_t sl_cpc_abort_read (sl_cpc_endpoint_handle_t * endpoint_handle)

Abort read; Allow unblocking task in blocked by a read.

Note

• This function can be called from an ISR.

sl_cpc_read#

sl_status_t sl_cpc_read (sl_cpc_endpoint_handle_t * endpoint_handle, void ** data, uint16_t * data_length, uint32_t timeout, uint8_t flags)

Read data.

sl_cpc_write#

sl_status_t sl_cpc_write (sl_cpc_endpoint_handle_t * endpoint_handle, void * data, uint16_t data_length, uint8_t flags, void * on_write_completed_arg)

Write data.

Note

• This function cannot be called from an ISR.

• When the write buffer is encrypted, the original content is lost and replaced by its encrypted counterpart.

sl_cpc_get_endpoint_state#

sl_cpc_endpoint_state_t sl_cpc_get_endpoint_state (sl_cpc_endpoint_handle_t * endpoint_handle)

Get endpoint state.

Returns

• Endpoint state.

sl_cpc_get_endpoint_encryption#

bool sl_cpc_get_endpoint_encryption (sl_cpc_endpoint_handle_t * endpoint_handle)

Get endpoint encryption state.

Returns

• Endpoint encryption state.

sl_cpc_free_rx_buffer#

sl_status_t sl_cpc_free_rx_buffer (void * data)

Free buffer returned by sl_cpc_read().

sl_cpc_get_tx_max_payload_length#

uint16_t sl_cpc_get_tx_max_payload_length (sl_cpc_endpoint_handle_t * endpoint_handle)

Get the maximum payload length that the remote can receive.

Returns

• the maximum tx payload length in function of whether the encryption is enabled on the endpoint or not

sl_cpc_is_ok_to_sleep#

bool sl_cpc_is_ok_to_sleep (void )

sl_cpc_sleep_on_isr_exit#

sl_power_manager_on_isr_exit_t sl_cpc_sleep_on_isr_exit (void )

SL_CPC_JOURNAL_RECORD_ERROR#

#define SL_CPC_JOURNAL_RECORD_ERROR

(string, value)

Record a CPC journal entry.

SL_CPC_JOURNAL_RECORD_WARNING#

#define SL_CPC_JOURNAL_RECORD_WARNING

(string, value)

SL_CPC_JOURNAL_RECORD_INFO#

#define SL_CPC_JOURNAL_RECORD_INFO

(string, value)

SL_CPC_JOURNAL_RECORD_DEBUG#

#define SL_CPC_JOURNAL_RECORD_DEBUG

(string, value)

SL_CPC_JOURNAL_RECORD_TRACE#

#define SL_CPC_JOURNAL_RECORD_TRACE

(string, value)

SL_CPC_ENDPOINT_FLAG_NONE#

#define SL_CPC_ENDPOINT_FLAG_NONE

0

sl cpc open endpoint flag none

SL_CPC_ENDPOINT_FLAG_DISABLE_ENCRYPTION#

#define SL_CPC_ENDPOINT_FLAG_DISABLE_ENCRYPTION

(0x01 << 3)

sl cpc open endpoint flag disable encryption

SL_CPC_OPEN_ENDPOINT_FLAG_NONE#

#define SL_CPC_OPEN_ENDPOINT_FLAG_NONE

SL_CPC_ENDPOINT_FLAG_NONE

SL_CPC_OPEN_ENDPOINT_FLAG_DISABLE_ENCRYPTION#

#define SL_CPC_OPEN_ENDPOINT_FLAG_DISABLE_ENCRYPTION

SL_CPC_ENDPOINT_FLAG_DISABLE_ENCRYPTION

SL_CPC_MAJOR_VERSION#

#define SL_CPC_MAJOR_VERSION

4

SL_CPC_MINOR_VERSION#

#define SL_CPC_MINOR_VERSION

5

SL_CPC_PATCH_VERSION#

#define SL_CPC_PATCH_VERSION

0

SL_CPC_USER_ENDPOINT_ID_START#

#define SL_CPC_USER_ENDPOINT_ID_START

((uint8_t)SL_CPC_ENDPOINT_USER_ID_0)

Struct representing a core debug.

sl cpc endpoint id start.

SL_CPC_USER_ENDPOINT_ID_END#

#define SL_CPC_USER_ENDPOINT_ID_END

((uint8_t)SL_CPC_ENDPOINT_USER_ID_9)

sl cpc user endpoint id end.

SL_CPC_USER_ENDPOINT_MAX_COUNT#

#define SL_CPC_USER_ENDPOINT_MAX_COUNT

(SL_CPC_USER_ENDPOINT_ID_END - SL_CPC_USER_ENDPOINT_ID_START + 1)

maximum simultaneous user endpoint.

SL_CPC_FLAG_NO_BLOCK#

#define SL_CPC_FLAG_NO_BLOCK

0x01

sl cpc flag no block.

SLI_CPC_SECURITY_TAG_LENGTH#

#define SLI_CPC_SECURITY_TAG_LENGTH

8

sli cpc security tag length.

SLI_CPC_LDMA_DESCRIPTOR_MAX_SIZE#

#define SLI_CPC_LDMA_DESCRIPTOR_MAX_SIZE

2048

sli cpc ldma desciptor max size.

SLI_CPC_HEADER_SIZE#

#define SLI_CPC_HEADER_SIZE

7

sli cpc header size.

SLI_CPC_PAYLOAD_CRC_SIZE#

#define SLI_CPC_PAYLOAD_CRC_SIZE

2

sli cpc payload crc size.

SL_CPC_TX_PAYLOAD_MAX_LENGTH#

#define SL_CPC_TX_PAYLOAD_MAX_LENGTH

((2 * SLI_CPC_LDMA_DESCRIPTOR_MAX_SIZE) - SLI_CPC_HEADER_SIZE - SLI_CPC_PAYLOAD_CRC_SIZE)

sl cpc tx payload max length.

SL_CPC_TX_PAYLOAD_MAX_LENGTH_WITH_SECURITY#

#define SL_CPC_TX_PAYLOAD_MAX_LENGTH_WITH_SECURITY

(SL_CPC_TX_PAYLOAD_MAX_LENGTH - SLI_CPC_SECURITY_TAG_LENGTH)

sl cpc tx payload max lenght with security.

SL_CPC_TRANSMIT_WINDOW_MIN_SIZE#

#define SL_CPC_TRANSMIT_WINDOW_MIN_SIZE

1

sl cpc transmit window min size.

SL_CPC_TRANSMIT_WINDOW_MAX_SIZE#

#define SL_CPC_TRANSMIT_WINDOW_MAX_SIZE

1

sl cpc transmit window max size.