ifx-utils.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) 2024-2026 Infineon Technologies AG
// SPDX-License-Identifier: MIT
 
#ifndef IFX_UTILS_H
#define IFX_UTILS_H
 
#include <stdint.h>
 
#include "ifx-utils-lib.h"
 
#if !defined(IFX_MEMCPY) || !defined(IFX_MEMCMP) || !defined(IFX_MEMSET) ||    \
    (!defined(IFX_FREE))
#include <string.h>
#endif
 
#ifndef IFX_MEMCPY
#define IFX_MEMCPY(dest, src, size)                                            \
    memcpy(dest, src, size) /* flawfinder: ignore*/
 
#endif
 
#ifndef IFX_MEMCMP
#define IFX_MEMCMP(first_memory, second_memory, size)                          \
    memcmp(first_memory, second_memory, size)
#endif
 
#ifndef IFX_MEMSET
#define IFX_MEMSET(buffer, value, size) memset(buffer, value, size)
#endif
 
#ifndef IFX_FREE
#define IFX_FREE(buffer) free(buffer)
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define IFX_UNUSED_VARIABLE(var)           (void) var
 
/* Function identifiers */
 
#define IFX_UTILS_CONCAT                   UINT8_C(0x01)
 
#define IFX_ENABLE                         UINT8_C(0x01)
 
#define IFX_DISABLE                        UINT8_C(0x00)
 
#define IFX_LITTLE_ENDIAN                  IFX_ENABLE
 
#define IFX_VALIDATE_NULL_PTR              IFX_ENABLE
 
#define IFX_VALIDATE_NULL_PTR_BLOB(blob)   (blob == NULL || blob->buffer == NULL)
 
#define IFX_VALIDATE_NULL_PTR_MEMORY(data) (data == NULL)
 
#if IFX_LITTLE_ENDIAN
/*#warning "Little Endian Compiler" */
 
#define IFX_GET_LOWER_BYTE(p1_value, p2_value)                                 \
    (p1_value) = ((p2_value) & 0x00FF);
 
#define IFX_GET_UPPER_BYTE(p1_value, p2_value)                                 \
    (p1_value) = (((p2_value) & 0xFF00) >> 8);
 
#define IFX_READ_U16(buffer, value)                                            \
    {                                                                          \
        value = (((*(uint8_t *) buffer) << 8) | (*(uint8_t *) (buffer + 1)));  \
    }
 
#define IFX_UPDATE_U16(buffer, value)                                          \
    {                                                                          \
        *(uint8_t *) buffer = (uint8_t) ((value >> 8) & 0x00FF);               \
        *(uint8_t *) (buffer + 1) = (uint8_t) (value);                         \
    }
 
#else
/*#warning "Big Endian Compiler"*/
 
#define IFX_GET_LOWER_BYTE(p1_value, p2_value)                                 \
    (p1_value) = (((p2_value) & 0xff00) >> 8);
 
#define IFX_GET_UPPER_BYTE(p1_value, p2_value)                                 \
    (p1_value) = ((p2_value) & 0x00FF);
#endif
 
#define IFX_READ_U32(buffer, u32value)                                         \
    {                                                                          \
        u32value = ((((*(uint8_t *) (buffer)) << 24) & 0XFF000000) |           \
                    (((*(uint8_t *) (buffer + 1)) << 16) & 0X00FF0000) |       \
                    (((*(uint8_t *) (buffer + 2)) << 8) & 0X0000FF00) |        \
                    (((*(uint8_t *) (buffer + 3)) & 0X000000FF)));             \
    }
 
#define IFX_UPDATE_U32(buffer, u32value)                                       \
    {                                                                          \
        *(uint8_t *) buffer = (uint8_t) ((u32value >> 24) & 0xFF);             \
        *(uint8_t *) (buffer + 1) = (uint8_t) ((u32value >> 16) & 0xFF);       \
        *(uint8_t *) (buffer + 2) = (uint8_t) ((u32value >> 8) & 0xFF);        \
        *(uint8_t *) (buffer + 3) = (uint8_t) (u32value);                      \
    }
 
typedef struct
{
    uint32_t length;
 
    uint8_t *buffer;
} ifx_blob_t;
 
ifx_status_t ifx_utils_concat(const ifx_blob_t *append_data,
                              ifx_blob_t *result);
 
#ifdef __cplusplus
}
 
#endif /* __cplusplus */
#endif /* IFX_UTILS_H */