packet.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2024-2026 Carl Seifert
 * SPDX-FileCopyrightText: 2024-2026 TU Dresden
 * SPDX-License-Identifier: LGPL-2.1-only
 */
 
#pragma once
 
#include <stdint.h>
#include "net/unicoap.h"
 
#ifdef __cplusplus
extern "C" {
#endif


 
/* We don't require a DTLS implementation to be present when the CoAP over DTLS driver is not used.
 * Including DTLS headers without an implementation fails. Hence, we create a local alias
 * that either maps to the system-provided DTLS session struct or to nothing. */
 
#ifndef DOXYGEN
#  if IS_USED(MODULE_UNICOAP_DRIVER_DTLS)
typedef sock_dtls_session_t unicoap_sock_dtls_session_t;
#  else
typedef void unicoap_sock_dtls_session_t;
#  endif
#endif

typedef struct {
    const unicoap_endpoint_t* remote;

    const unicoap_endpoint_t* local;
 
    union {
#if IS_USED(MODULE_UNICOAP_DRIVER_DTLS) || defined(DOXYGEN)
        const sock_dtls_session_t* dtls_session;
#endif
 
        /* MARK: unicoap_driver_extension_point */
    };

    unicoap_message_t* message;

    unicoap_message_properties_t properties;
} unicoap_packet_t;

static inline unicoap_proto_t unicoap_packet_proto(const unicoap_packet_t* packet)
{
    return packet->remote->proto;
}

static inline const void* _packet_get_dtls_session(unicoap_packet_t* packet)
{
#if IS_USED(MODULE_UNICOAP_DRIVER_DTLS)
    return unicoap_packet_proto(packet) == UNICOAP_PROTO_DTLS ? packet->dtls_session : NULL;
#else
    (void)packet;
    return NULL;
#endif
}

static inline void _packet_set_dtls_session(unicoap_packet_t* packet,
                                            const unicoap_sock_dtls_session_t* dtls_session)
{
#if IS_USED(MODULE_UNICOAP_DRIVER_DTLS)
    packet->dtls_session = dtls_session;
#else
    (void)packet;
    (void)dtls_session;
#endif
}
 
#ifdef __cplusplus
}
#endif