mqtt_client_transport.h File Reference

Transport protocol abstraction layer. More...

#include "core/net.h"
#include "mqtt/mqtt_client.h"

Go to the source code of this file.

Functions

error_t mqttClientOpenConnection (MqttClientContext *context)
 Open network connection. More...
 
error_t mqttClientEstablishConnection (MqttClientContext *context, const IpAddr *serverIpAddr, uint16_t serverPort)
 Establish network connection. More...
 
error_t mqttClientShutdownConnection (MqttClientContext *context)
 Shutdown network connection. More...
 
void mqttClientCloseConnection (MqttClientContext *context)
 Close network connection. More...
 
error_t mqttClientSendData (MqttClientContext *context, const void *data, size_t length, size_t *written, uint_t flags)
 Send data using the relevant transport protocol. More...
 
error_t mqttClientReceiveData (MqttClientContext *context, void *data, size_t size, size_t *received, uint_t flags)
 Receive data using the relevant transport protocol. More...
 
error_t mqttClientWaitForData (MqttClientContext *context, systime_t timeout)
 Wait for incoming data. More...
 

Detailed Description

Transport protocol abstraction layer.

License

SPDX-License-Identifier: GPL-2.0-or-later

Copyright (C) 2010-2024 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneTCP Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author
Oryx Embedded SARL (www.oryx-embedded.com)
Version
2.4.0

Definition in file mqtt_client_transport.h.

Function Documentation

◆ mqttClientCloseConnection()

void mqttClientCloseConnection ( MqttClientContext context)

Close network connection.

Parameters
[in]contextPointer to the MQTT client context

Definition at line 409 of file mqtt_client_transport.c.

◆ mqttClientEstablishConnection()

error_t mqttClientEstablishConnection ( MqttClientContext context,
const IpAddr serverIpAddr,
uint16_t  serverPort 
)

Establish network connection.

Parameters
[in]contextPointer to the MQTT client context
[in]serverIpAddrIP address of the MQTT server to connect to
[in]serverPortTCP port number that will be used to establish the connection
Returns
Error code

Definition at line 240 of file mqtt_client_transport.c.

◆ mqttClientOpenConnection()

error_t mqttClientOpenConnection ( MqttClientContext context)

Open network connection.

Parameters
[in]contextPointer to the MQTT client context
Returns
Error code

Definition at line 76 of file mqtt_client_transport.c.

◆ mqttClientReceiveData()

error_t mqttClientReceiveData ( MqttClientContext context,
void *  data,
size_t  size,
size_t *  received,
uint_t  flags 
)

Receive data using the relevant transport protocol.

Parameters
[in]contextPointer to the MQTT client context
[out]dataBuffer into which received data will be placed
[in]sizeMaximum number of bytes that can be received
[out]receivedNumber of bytes that have been received
[in]flagsSet of flags that influences the behavior of this function
Returns
Error code

Definition at line 538 of file mqtt_client_transport.c.

◆ mqttClientSendData()

error_t mqttClientSendData ( MqttClientContext context,
const void *  data,
size_t  length,
size_t *  written,
uint_t  flags 
)

Send data using the relevant transport protocol.

Parameters
[in]contextPointer to the MQTT client context
[in]dataPointer to a buffer containing the data to be transmitted
[in]lengthNumber of bytes to be transmitted
[out]writtenActual number of bytes written (optional parameter)
[in]flagsSet of flags that influences the behavior of this function
Returns
Error code

Definition at line 466 of file mqtt_client_transport.c.

◆ mqttClientShutdownConnection()

error_t mqttClientShutdownConnection ( MqttClientContext context)

Shutdown network connection.

Parameters
[in]contextPointer to the MQTT client context
Returns
Error code

Definition at line 337 of file mqtt_client_transport.c.

◆ mqttClientWaitForData()

error_t mqttClientWaitForData ( MqttClientContext context,
systime_t  timeout 
)

Wait for incoming data.

Parameters
[in]contextPointer to the MQTT client context
[in]timeoutMaximum time to wait before returning
Returns
Error code

Definition at line 621 of file mqtt_client_transport.c.