iotc_connection_data.h

/* Copyright 2018-2019 Google LLC
 *
 * This is part of the Google Cloud IoT Device SDK for Embedded C.
 * It is licensed under the BSD 3-Clause license; you may not use this file
 * except in compliance with the License.
 *
 * You may obtain a copy of the License at:
 *  https://opensource.org/licenses/BSD-3-Clause
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef __IOTC_CONNECTION_DATA_H__
#define __IOTC_CONNECTION_DATA_H__

#include <iotc_mqtt.h>
#include "iotc_types.h"

#ifdef __cplusplus
extern "C" {
#endif

/**
 * @enum iotc_connection_state_e
 * @brief All possible states of the connection process and lifecycle.
 */
typedef enum iotc_connection_state_e {
  /** The connection is not established and there is no pending
   * connect operation in libiotc. */
  IOTC_CONNECTION_STATE_UNINITIALIZED = 0,
  /** The connect operation started. */
  IOTC_CONNECTION_STATE_OPENING,
  /** The connect operation is successfully finished. */
  IOTC_CONNECTION_STATE_OPENED,
  /** The disconnect operation started. */
  IOTC_CONNECTION_STATE_CLOSING,
  /** The connection is closed. */
  IOTC_CONNECTION_STATE_CLOSED,
  /** Can't open connection. */
  IOTC_CONNECTION_STATE_OPEN_FAILED
} iotc_connection_state_t;

/**
 * @enum iotc_session_type_e
 * @brief MQTT session types. Note that CONTINUE isn't currently supported
 * by IoT Core.
 */
typedef enum iotc_session_type_e {
  /** MQTT clean session. */
  IOTC_SESSION_CLEAN,
  /** MQTT unclean session. */
  IOTC_SESSION_CONTINUE
} iotc_session_type_t;

/**
 * @struct  iotc_connection_data_t
 * @brief The connection parameters received by the <code>iotc_connect()</code>
 * callback.
 *
 * The application may reuse these parameters to request another connection
 * from within the callback.
 *
 * @see iotc_connect
 */
typedef struct iotc_connection_data_s {
  /** MQTT service hostname. */
  char* host;
  /** MQTT connect username. */
  char* username;
  /** MQTT connect password. */
  char* password;
  /** MQTT connect client id. */
  char* client_id;
  /** MQTT service host port. */
  uint16_t port;
  /** MQTT connect connection timeout in seconds. */
  uint16_t connection_timeout;
  /** MQTT keepalive timeout in seconds. */
  uint16_t keepalive_timeout;
  /** Tracks current connection state. */
  iotc_connection_state_t connection_state;
  /** Denote clean or continued MQTT session types. */
  iotc_session_type_t session_type;
  /** Unused. */
  char* will_topic;
  /** Unused. */
  char* will_message;
  /** Unused. */
  iotc_mqtt_qos_t will_qos;
  /** Unused. */
  iotc_mqtt_retain_t will_retain;
} iotc_connection_data_t;

#ifdef __cplusplus
}
#endif

#endif /* __IOTC_CONNECTION_DATA_H__ */