mirror of
https://github.com/FreeRTOS/FreeRTOS.git
synced 2025-05-31 00:01:05 +08:00
bd9db07f28
This adds coreMQTT, coreJSON, and Device Shadow as submodules to the following directories: coreMQTT: FreeRTOS-Plus/Source/Application-Protocols/coreMQTT coreJSON: FreeRTOS-Plus/Source/coreJSON Device Shadow: FreeRTOS/FreeRTOS-Plus/Source/AWS/device-shadow-for-aws-iot-embedded-sdk Platform sources and includes that are utilized by these libraries are also moved from lts-development branch to master: FreeRTOS-Plus/Source/FreeRTOS-IoT-Libraries-LTS-Beta2/c_sdk/platform (lts-development) -> FreeRTOS-Plus/Source/Application-Protocols/platform (master) Co-authored-by: abhidixi11 <44424462+abhidixi11@users.noreply.github.com> Co-authored-by: leegeth <51681119+leegeth@users.noreply.github.com> Co-authored-by: Muneeb Ahmed <54290492+muneebahmed10@users.noreply.github.com> Co-authored-by: Carl Lundin <53273776+lundinc2@users.noreply.github.com>
73 lines
3.0 KiB
C
73 lines
3.0 KiB
C
/*
|
|
* Copyright (C) 2020 Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef TRANSPORT_INTERFACE_H_
|
|
#define TRANSPORT_INTERFACE_H_
|
|
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
|
|
/**
|
|
* @brief The NetworkContext is an incomplete type. An implementation of this
|
|
* interface must define NetworkContext as per the requirements. This context
|
|
* is passed into the network interface functions.
|
|
*/
|
|
struct NetworkContext;
|
|
typedef struct NetworkContext NetworkContext_t;
|
|
|
|
/**
|
|
* @brief Transport interface for receiving data on the network.
|
|
*
|
|
* @param[in] pNetworkContext Implementation-defined network context.
|
|
* @param[in] pBuffer Buffer to receive the data into.
|
|
* @param[in] bytesToRecv Number of bytes requested from the network.
|
|
*
|
|
* @return The number of bytes received or a negative error code.
|
|
*/
|
|
typedef int32_t ( * TransportRecv_t )( NetworkContext_t * pNetworkContext,
|
|
void * pBuffer,
|
|
size_t bytesToRecv );
|
|
|
|
/**
|
|
* @brief Transport interface for sending data over the network.
|
|
*
|
|
* @param[in] pNetworkContext Implementation-defined network context.
|
|
* @param[in] pBuffer Buffer containing the bytes to send over the network stack.
|
|
* @param[in] bytesToSend Number of bytes to send over the network.
|
|
*
|
|
* @return The number of bytes sent or a negative error code.
|
|
*/
|
|
typedef int32_t ( * TransportSend_t )( NetworkContext_t * pNetworkContext,
|
|
const void * pBuffer,
|
|
size_t bytesToSend );
|
|
|
|
/**
|
|
* @brief The transport layer interface.
|
|
*/
|
|
typedef struct TransportInterface
|
|
{
|
|
TransportRecv_t recv; /**< Transport receive interface. */
|
|
TransportSend_t send; /**< Transport send interface. */
|
|
NetworkContext_t * pNetworkContext; /**< Implementation-defined network context. */
|
|
} TransportInterface_t;
|
|
|
|
#endif /* ifndef TRANSPORT_INTERFACE_H_ */
|