OPTIGA Trust M  1.1.0
C++ library for Optiga Trust M Chip Security Controller
ifx_i2c_transport_layer.c File Reference

This file implements the APIs for transport layer of the Infineon I2C Protocol Stack library. More...

Include dependency graph for ifx_i2c_transport_layer.c:

Functions

optiga_lib_status_t ifx_i2c_tl_init (ifx_i2c_context_t *p_ctx, ifx_i2c_event_handler_t handler)
 Function for initializing the module. More...
 
optiga_lib_status_t ifx_i2c_tl_transceive (ifx_i2c_context_t *p_ctx, uint8_t *p_packet, uint16_t packet_len, uint8_t *p_recv_packet, uint16_t *p_recv_packet_len)
 Function to transmit and receive a packet. More...
 
_STATIC_H optiga_lib_status_t ifx_i2c_tl_resend_packets (ifx_i2c_context_t *p_ctx)
 
_STATIC_H uint8_t ifx_i2c_tl_calculate_pctr (const ifx_i2c_context_t *p_ctx)
 
_STATIC_H optiga_lib_status_t ifx_i2c_tl_send_next_fragment (ifx_i2c_context_t *p_ctx)
 
_STATIC_H optiga_lib_status_t ifx_i2c_tl_send_chaining_error (ifx_i2c_context_t *p_ctx)
 
_STATIC_H optiga_lib_status_t ifx_i2c_tl_check_chaining_error (uint8_t current_chaning, uint8_t previous_chaining)
 
_STATIC_H optiga_lib_status_t presence_bit_check (const ifx_i2c_context_t *p_ctx, uint8_t pctr)
 
_STATIC_H void ifx_i2c_dl_event_handler (ifx_i2c_context_t *p_ctx, optiga_lib_status_t event, const uint8_t *p_data, uint16_t data_len)
 

Detailed Description

This file implements the APIs for transport layer of the Infineon I2C Protocol Stack library.

Copyright (c) 2019 Infineon Technologies AG

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE

\endcopyright

Author
Infineon Technologies AG

Function Documentation

◆ ifx_i2c_dl_event_handler()

_STATIC_H void ifx_i2c_dl_event_handler ( ifx_i2c_context_t p_ctx,
optiga_lib_status_t  event,
const uint8_t *  p_data,
uint16_t  data_len 
)
Here is the call graph for this function:

◆ ifx_i2c_tl_calculate_pctr()

_STATIC_H uint8_t ifx_i2c_tl_calculate_pctr ( const ifx_i2c_context_t p_ctx)

◆ ifx_i2c_tl_check_chaining_error()

_STATIC_H optiga_lib_status_t ifx_i2c_tl_check_chaining_error ( uint8_t  current_chaning,
uint8_t  previous_chaining 
)

◆ ifx_i2c_tl_init()

optiga_lib_status_t ifx_i2c_tl_init ( ifx_i2c_context_t p_ctx,
ifx_i2c_event_handler_t  handler 
)

Function for initializing the module.

Function initializes and enables the module and registers an event handler to receive events from this module.

Precondition
  • This function must be called before using the module.
Note
  • None
Parameters
[in,out]p_ctxPointer to ifx i2c context.
[in]handlerFunction pointer to the event handler of the upper layer.
Return values
IFX_I2C_STACK_SUCCESSIf initialization was successful.
IFX_I2C_STACK_ERRORIf the module is already initialized.
Here is the call graph for this function:

◆ ifx_i2c_tl_resend_packets()

_STATIC_H optiga_lib_status_t ifx_i2c_tl_resend_packets ( ifx_i2c_context_t p_ctx)
Here is the call graph for this function:

◆ ifx_i2c_tl_send_chaining_error()

_STATIC_H optiga_lib_status_t ifx_i2c_tl_send_chaining_error ( ifx_i2c_context_t p_ctx)
Here is the call graph for this function:

◆ ifx_i2c_tl_send_next_fragment()

_STATIC_H optiga_lib_status_t ifx_i2c_tl_send_next_fragment ( ifx_i2c_context_t p_ctx)
Here is the call graph for this function:

◆ ifx_i2c_tl_transceive()

optiga_lib_status_t ifx_i2c_tl_transceive ( ifx_i2c_context_t p_ctx,
uint8_t *  p_packet,
uint16_t  packet_len,
uint8_t *  p_recv_packet,
uint16_t *  p_recv_packet_len 
)

Function to transmit and receive a packet.

  • The function returns immediately.
  • One of the following events is propagated to the event handler registered with ifx_i2c_tl_init
Precondition
  • This function must be called before using the module.
Note
  • None
Parameters
[in,out]p_ctxPointer to ifx i2c context.
[in]p_packetBuffer containing the packet header.
[in]packet_lenPacket header length.
[in]p_recv_packetBuffer containing the packet payload.
[in]p_recv_packet_lenPacket payload length.
Return values
IFX_I2C_STACK_SUCCESSIf function was successful.
IFX_I2C_STACK_ERRORIf the module is busy.
Here is the call graph for this function:

◆ presence_bit_check()

_STATIC_H optiga_lib_status_t presence_bit_check ( const ifx_i2c_context_t p_ctx,
uint8_t  pctr 
)