Se usó la API de Cloud Translation para traducir esta página.

nl::Weave::WeaveConnection

#include <src/lib/core/WeaveMessageLayer.h>

La definición de la clase Weave Connection

Resumen

Representa una conexión TCP o BLE con otro nodo de Weave.

Tipos públicos
`@58{ kGetPeerDescription_MaxLength = nl::Weave::kWeavePeerDescription_MaxLength }`	enum
`ConnectionClosedFunct)(WeaveConnection *con, WEAVE_ERROR conErr)`	typedef `void(*` Esta función es la devolución de llamada de la aplicación que se invoca cuando se cierra una conexión.
`ConnectionCompleteFunct)(WeaveConnection *con, WEAVE_ERROR conErr)`	typedef `void(*` Esta función es la devolución de llamada de la aplicación que se invoca cuando se completa una configuración de conexión.
`MessageReceiveFunct)(WeaveConnection con, WeaveMessageInfo msgInfo, PacketBuffer *msgBuf)`	typedef `void(*` Esta función es la devolución de llamada de la aplicación que se invoca cuando se recibe un mensaje a través de una conexión de Weave.
`NetworkType{ kNetworkType_Unassigned = 0, kNetworkType_IP = 1, kNetworkType_BLE = 2 }`	enum El tipo de red del objeto de conexión de Weave.
`ReceiveErrorFunct)(WeaveConnection *con, WEAVE_ERROR err)`	typedef `void(*` Esta función es la devolución de llamada de la aplicación que se invoca cuando se encuentra un error al recibir un mensaje de Weave.
`State{ kState_ReadyToConnect = 0, kState_Resolving = 1, kState_Connecting = 2, kState_EstablishingSession = 3, kState_Connected = 4, kState_SendShutdown = 5, kState_Closed = 6 }`	enum El objeto de conexión del estado de Weave.
`TunneledMsgReceiveFunct)(WeaveConnection con, const WeaveMessageInfo msgInfo, PacketBuffer *msgBuf)`	typedef `void(*` Esta función es la devolución de llamada de la aplicación que se invoca cuando se recibe un paquete de datos de túnel a través de la conexión de Weave.

Atributos públicos
`AppState`	`void *` Un puntero al objeto de estado específico de la aplicación.
`AuthMode`	`WeaveAuthMode` [SOLO LECTURA]: El modo de autenticación que se usa a fin de establecer las claves de encriptación predeterminadas para la conexión.
`DefaultEncryptionType`	`uint8_t` El tipo de encriptación predeterminado para los mensajes.
`DefaultKeyId`	`uint16_t` La clave de encriptación predeterminada que se usará para enviar mensajes.
`MessageLayer`	`WeaveMessageLayer *` [Solo lectura] El objeto WeaveMessageLayer asociado.
`NetworkType`	`uint8_t` [READ ONLY] El tipo de red del punto de destino asociado.
`OnConnectionClosed`	`ConnectionClosedFunct`
`OnConnectionComplete`	`ConnectionCompleteFunct`
`OnMessageReceived`	`MessageReceiveFunct`
`OnReceiveError`	`ReceiveErrorFunct`
`OnTunneledMessageReceived`	`TunneledMsgReceiveFunct`
`PeerAddr`	`IPAddress` [READ ONLY] La dirección IP del nodo de intercambio de tráfico.
`PeerNodeId`	`uint64_t` [READ ONLY] El identificador de nodo del par.
`PeerPort`	`uint16_t` [READ ONLY] El número de puerto del nodo de intercambio de tráfico.
`ReceiveEnabled`	`bool` [READ ONLY] Verdadero si la recepción está habilitada; de lo contrario, es falso.
`SendDestNodeId`	`bool` El valor es verdadero si todos los mensajes enviados a través de esta conexión deben incluir un identificador de nodo de destino codificado de forma explícita. De lo contrario, es falso.
`SendSourceNodeId`	`bool` El valor es verdadero si todos los mensajes enviados a través de esta conexión deben incluir un identificador de nodo fuente codificado de forma explícita. De lo contrario, es falso.
`State`	`uint8_t` [READ ONLY] El estado del objeto WeaveConnection.

Funciones públicas
`Abort(void)`	`void` Realiza un cierre correcta de la WeaveConnection basada en TCP o BLE, descartando cualquier dato que esté en tránsito hacia o desde el par.
`AddRef(void)`	`void` Reserva una referencia al objeto WeaveConnection.
`Close(void)`	`WEAVE_ERROR` Realiza un cierre ordenado y sin bloqueo de WeaveConnection basado en TCP o BLE, mostrando todos los datos salientes restantes antes de informar amablemente al host remoto que restablecimos la conexión.
`Close(bool suppressCloseLog)`	`WEAVE_ERROR` Realiza un cierre ordenado y sin bloqueo de WeaveConnection basado en TCP o BLE, mostrando todos los datos salientes restantes antes de informar amablemente al host remoto que restablecimos la conexión.
`Connect(uint64_t peerNodeId)`	`WEAVE_ERROR` Conectarse a un nodo de Weave mediante una dirección IP de tejido derivada del identificador de nodo especificado
`Connect(uint64_t peerNodeId, const IPAddress & peerAddr, uint16_t peerPort)`	`WEAVE_ERROR` Conéctate a un nodo de Weave mediante un identificador de nodo o una dirección IP.
`Connect(uint64_t peerNodeId, WeaveAuthMode authMode, const IPAddress & peerAddr, uint16_t peerPort, InterfaceId intf)`	`WEAVE_ERROR` Conéctate a un nodo de Weave mediante un identificador de nodo o una dirección IP en una interfaz específica.
`Connect(uint64_t peerNodeId, WeaveAuthMode authMode, const char *peerAddr, uint16_t defaultPort)`	`WEAVE_ERROR` Conéctate a un nodo de Weave mediante un identificador de nodo o un nombre de host de string.
`Connect(uint64_t peerNodeId, WeaveAuthMode authMode, const char *peerAddr, uint16_t peerAddrLen, uint16_t defaultPort)`	`WEAVE_ERROR` Conéctate a un nodo de Weave mediante un identificador de nodo o una dirección de par de string.
`Connect(uint64_t peerNodeId, WeaveAuthMode authMode, const char *peerAddr, uint16_t peerAddrLen, uint8_t dnsOptions, uint16_t defaultPort)`	`WEAVE_ERROR` Conéctate a un nodo de Weave mediante un identificador de nodo o una dirección de par de string.
`Connect(uint64_t peerNodeId, WeaveAuthMode authMode, HostPortList hostPortList, InterfaceId intf)`	`WEAVE_ERROR` Conéctate a un nodo de Weave mediante un identificador de nodo o una lista de nombres de host y puertos.
`Connect(uint64_t peerNodeId, WeaveAuthMode authMode, HostPortList hostPortList, uint8_t dnsOptions, InterfaceId intf)`	`WEAVE_ERROR` Conéctate a un nodo de Weave mediante un identificador de nodo o una lista de nombres de host y puertos.
`DisableKeepAlive(void)`	`WEAVE_ERROR` WeaveConnection::DisableKeepAlive,
`DisableReceive(void)`	`void` Inhabilitar la recepción a través de esta WeaveConnection
`EnableKeepAlive(uint16_t interval, uint16_t timeoutCount)`	`WEAVE_ERROR` WeaveConnection::EnableKeepAlive.
`EnableReceive(void)`	`void` Habilita la recepción a través de esta WeaveConnection.
`GetPeerAddressInfo(IPPacketInfo & addrInfo)`	`WEAVE_ERROR` Obtén la información de la dirección IP del par.
`GetPeerDescription(char *buf, size_t bufSize) const`	`void` Construye una string que describe el nodo de par asociado con la conexión.
`GetTCPEndPoint(void) const`	`TCPEndPoint *`
`IsIncoming(void) const`	`bool`
`LogId(void) const`	`uint16_t`
`Release(void)`	`void` Disminuir el recuento de referencia en el objeto WeaveConnection
`ResetUserTimeout(void)`	`WEAVE_ERROR` WeaveConnection::ResetUserTimeout.
`SendMessage(WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` Enviar un mensaje de Weave a través de una conexión establecida.
`SendTunneledMessage(WeaveMessageInfo msgInfo, PacketBuffer msgBuf)`	`WEAVE_ERROR` Función para enviar un paquete de túnel a través de una conexión de Weave.
`SetConnectTimeout(const uint32_t connTimeoutMsecs)`	`void` Establece el tiempo de espera para que Connect se complete correctamente o muestre un error.
`SetIdleTimeout(uint32_t timeoutMS)`	`WEAVE_ERROR` Establece el tiempo de espera de inactividad en la conexión de la capa de red subyacente.
`SetIncoming(bool val)`	`void`
`SetUserTimeout(uint32_t userTimeoutMillis)`	`WEAVE_ERROR` WeaveConnection::SetUserTimeout;
`Shutdown(void)`	`WEAVE_ERROR` Realiza un cierre de envío de TCP ordenado, lo que asegura que la pila de TCP de intercambio de tráfico haya enviado y recibido todos los datos salientes.

Tipos públicos

@58

@58

Propiedades
`kGetPeerDescription_MaxLength`	Longitud máxima de la string (incluido el carácter NUL) que muestra GetPeerDescription().

Conexión definida

void(* ConnectionClosedFunct)(WeaveConnection *con, WEAVE_ERROR conErr)

Esta función es la devolución de llamada de la aplicación que se invoca cuando se cierra una conexión.

Detalles

Parámetros

`[in] con`	Un puntero al objeto WeaveConnection.
`[in] conErr`	Se encontró un WEAVE_ERROR cuando se cerró la conexión.

ConexiónCompletarFunción

void(* ConnectionCompleteFunct)(WeaveConnection *con, WEAVE_ERROR conErr)

Esta función es la devolución de llamada de la aplicación que se invoca cuando se completa una configuración de conexión.

Detalles

Parámetros

`[in] con`	Un puntero al objeto WeaveConnection.
`[in] conErr`	Se encontró un WEAVE_ERROR durante la configuración de conexión.

Función Recibir Mensaje

void(* MessageReceiveFunct)(WeaveConnection *con, WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)

Esta función es la devolución de llamada de la aplicación que se invoca cuando se recibe un mensaje a través de una conexión de Weave.

Detalles

Parámetros

`[in] con`	Un puntero al objeto WeaveConnection.
`[in] msgInfo`	Un puntero para una estructura WeaveMessageInfo que contiene información sobre el mensaje.
`[in] msgBuf`	Un puntero al objeto PacketBuffer que contiene el mensaje.

NetworkType

 NetworkType

El tipo de red del objeto de conexión de Weave.

Propiedades
`kNetworkType_BLE`	Es el tipo de red BLE.
`kNetworkType_IP`	Tipo de red TCP/IP.
`kNetworkType_Unassigned`	Tipo de red sin asignar.

Recibe ErrorFunct

void(* ReceiveErrorFunct)(WeaveConnection *con, WEAVE_ERROR err)

Esta función es la devolución de llamada de la aplicación que se invoca cuando se encuentra un error al recibir un mensaje de Weave.

Detalles

Parámetros

`[in] con`	Un puntero al objeto WeaveConnection.
`[in] err`	Se encontró un WEAVE_ERROR al recibir datos a través de la conexión.

State

 State

El objeto de conexión del estado de Weave.

Propiedades
`kState_Closed`	Indica el estado cuando se cierra la conexión.
`kState_Connected`	Indica el estado en el que se estableció la conexión.
`kState_Connecting`	Indica el estado cuando se intenta establecer la conexión.
`kState_EstablishingSession`	Indica cuándo se establece una sesión segura.
`kState_ReadyToConnect`	Estado después de la inicialización de la conexión de Weave.
`kState_Resolving`	Indica el estado en el que se realiza la resolución del nombre del DNS.
`kState_SendShutdown`	Indica el estado en el que se cierra la conexión.

TúnelMsgReceiveFunct

void(* TunneledMsgReceiveFunct)(WeaveConnection *con, const WeaveMessageInfo *msgInfo, PacketBuffer *msgBuf)

Esta función es la devolución de llamada de la aplicación que se invoca cuando se recibe un paquete de datos de túnel a través de la conexión de Weave.

Detalles

Parámetros

`[in] con`	Un puntero al objeto WeaveConnection.
`[in] msgInfo`	Un puntero al objeto WeaveMessageInfo.
`[in] msgBuf`	Un puntero al objeto PacketBuffer que contiene el paquete en túnel que se recibió.

Atributos públicos

Estado de la aplicación

void * AppState

Un puntero al objeto de estado específico de la aplicación.

Modo de autenticación

WeaveAuthMode AuthMode

[SOLO LECTURA]: El modo de autenticación que se usa a fin de establecer las claves de encriptación predeterminadas para la conexión.

TipoDeEncriptaciónDePredeterminada

uint8_t DefaultEncryptionType

El tipo de encriptación predeterminado para los mensajes.

ID de clave predeterminada

uint16_t DefaultKeyId

La clave de encriptación predeterminada que se usará para enviar mensajes.

Capa de mensajes

WeaveMessageLayer * MessageLayer

[Solo lectura] El objeto WeaveMessageLayer asociado.

NetworkType

uint8_t NetworkType

[READ ONLY] El tipo de red del punto de destino asociado.

OnConnectionClosed

ConnectionClosedFunct OnConnectionClosed

OnConnectionComplete;

ConnectionCompleteFunct OnConnectionComplete

OnMessageReceived

MessageReceiveFunct OnMessageReceived

OnReceiveError

ReceiveErrorFunct OnReceiveError

OnTunneledMessageReceived

TunneledMsgReceiveFunct OnTunneledMessageReceived

PeerAddr

IPAddress PeerAddr

[READ ONLY] La dirección IP del nodo de intercambio de tráfico.

ID del par de intercambio de tráfico

uint64_t PeerNodeId

[READ ONLY] El identificador de nodo del par.

Puerto del par

uint16_t PeerPort

[READ ONLY] El número de puerto del nodo de intercambio de tráfico.

Recibe habilitado

bool ReceiveEnabled

[READ ONLY] Verdadero si la recepción está habilitada; de lo contrario, es falso.

ID de envíoDesDest

bool SendDestNodeId

El valor es verdadero si todos los mensajes enviados a través de esta conexión deben incluir un identificador de nodo de destino codificado de forma explícita. De lo contrario, es falso.

ID de SendSourceNode

bool SendSourceNodeId

El valor es verdadero si todos los mensajes enviados a través de esta conexión deben incluir un identificador de nodo fuente codificado de forma explícita. De lo contrario, es falso.

State

uint8_t State

[READ ONLY] El estado del objeto WeaveConnection.

Funciones públicas

Anular

void Abort(
  void
)

Realiza un cierre correcta de la WeaveConnection basada en TCP o BLE, descartando cualquier dato que esté en tránsito hacia o desde el par.

Una llamada a Abort() finaliza inmediatamente la conexión subyacente. Después de este punto, ya no se puede usar el objeto WeaveConnection para una comunicación adicional.

Llamar a Abort() disminuye el recuento de referencia asociado con el objeto WeaveConnection, independientemente de si la conexión está abierta o activa en el momento en que se llama al método. Si el resultado es que el recuento de referencias llega a cero, los recursos asociados con el objeto de conexión se liberan. Cuando esto sucede, la aplicación no debe tener más interacciones con el objeto.

Consulta también:
Shutdown(), Abort(), AddRef() y Release().

Agregar referencia

void AddRef(
  void
)

Reserva una referencia al objeto WeaveConnection.

El método AddRef() aumenta el recuento de referencias asociado con el objeto WeaveConnection. Para cada llamada a AddRef(), la aplicación es responsable de realizar la llamada correspondiente a Release(), Close() o Abort().

Cerrar

WEAVE_ERROR Close(
  void
)

Realiza un cierre ordenado y sin bloqueo de WeaveConnection basado en TCP o BLE, mostrando todos los datos salientes restantes antes de informar amablemente al host remoto que restablecimos la conexión.

Este método no ofrece ninguna garantía sólida de que el par remoto haya recibido cualquier mensaje saliente no confirmado a nivel del protocolo de la aplicación. Tanto para TCP como BLE, la pila de protocolo subyacente hará su mejor esfuerzo para entregar los datos salientes pendientes antes de restablecer la conexión. En el caso de TCP, se debe usar Shutdown() antes de Close() si se requiere una confirmación de recepción de mensajes en la capa de transporte antes de cerrar la conexión. Las conexiones BLE no proporcionan un equivalente de Shutdown().

En el caso de las conexiones basadas en BLE, Close() cierra WeaveConnection y muestra una respuesta inmediata, pero puede hacer que el objeto BLEEndPoint subyacente persista hasta que se envíen todos los datos salientes. Este es un efecto secundario de la implementación del protocolo de transporte de Weave sobre BLE existente en Weave BleLayer.

Una vez que se llama a Close(), el objeto WeaveConnection ya no se puede usar para una comunicación posterior.

Llamar a Close() disminuye el recuento de referencia asociado con el objeto WeaveConnection, sin importar si la conexión está abierta o activa en el momento en que se llama al método. Si el resultado es que el recuento de referencias llega a cero, los recursos asociados con el objeto de conexión se liberan. Cuando esto sucede, la aplicación no debe tener más interacciones con el objeto.

Detalles
Qué muestra	WEAVE_NO_ERROR incondicionalmente.

Consulta también:
Shutdown(), Abort(), AddRef() y Release().

Cerrar

WEAVE_ERROR Close(
  bool suppressCloseLog
)

Una vez que se llama a Close(), el objeto WeaveConnection ya no se puede usar para una comunicación posterior.

Detalles

Parámetros

[in] suppressCloseLog

Es verdadero si los registros necesitan suprimirse. De lo contrario, es falso.

Qué muestra

WEAVE_NO_ERROR incondicionalmente.

Consulta también:
Shutdown(), Abort(), AddRef() y Release().

Conexión

WEAVE_ERROR Connect(
  uint64_t peerNodeId
)

Conectarse a un nodo de Weave mediante una dirección IP de tejido derivada del identificador de nodo especificado

Detalles

Parámetros

[in] peerNodeId

Es el identificador de nodo del par.

Valores que se muestran

`WEAVE_NO_ERROR`	cuando se inicia correctamente la conexión con el par.
`WEAVE_ERROR_INCORRECT_STATE`	si el estado WeaveConnection es incorrecto.
`WEAVE_ERROR_UNSUPPORTED_AUTH_MODE`	si no se admite el modo de autenticación solicitado.
`WEAVE_ERROR_INVALID_ADDRESS`	si la dirección de destino no se puede deducir del ID de nodo.
`other`	Errores de capa de inet generados por las operaciones de conexión TCPEndPoint.

Conexión

WEAVE_ERROR Connect(
  uint64_t peerNodeId,
  const IPAddress & peerAddr,
  uint16_t peerPort
)

Conéctate a un nodo de Weave mediante un identificador de nodo o una dirección IP.

Detalles

Parámetros

`[in] peerNodeId`	El identificador de nodo del par, kNodeIdNotspecified o 0 si no se conoce.
`[in] peerAddr`	La dirección IP del par, IPAddress::Any si no se conoce.
`[in] peerPort`	El puerto opcional del par. es el predeterminado de WEAVE_PORT.

Valores que se muestran

`WEAVE_NO_ERROR`	cuando se inicia correctamente la conexión con el par.
`WEAVE_ERROR_INCORRECT_STATE`	si el estado WeaveConnection es incorrecto.
`WEAVE_ERROR_UNSUPPORTED_AUTH_MODE`	si no se admite el modo de autenticación solicitado.
`WEAVE_ERROR_INVALID_ADDRESS`	si la dirección de destino no se puede deducir del ID de nodo.
`other`	Errores de capa de inet generados por las operaciones de conexión TCPEndPoint.

Conexión

WEAVE_ERROR Connect(
  uint64_t peerNodeId,
  WeaveAuthMode authMode,
  const IPAddress & peerAddr,
  uint16_t peerPort,
  InterfaceId intf
)

Conéctate a un nodo de Weave mediante un identificador de nodo o una dirección IP en una interfaz específica.

Detalles

Parámetros

`[in] peerNodeId`	El identificador de nodo del par, kNodeIdNotspecified o 0 si no se conoce.
`[in] authMode`	El modo de autenticación deseado para el par. Solo se admiten los modos CASE, PASE y No autenticados.
`[in] peerAddr`	La dirección IP del par, IPAddress::Any si no se conoce.
`[in] peerPort`	El puerto opcional del par. es el predeterminado de WEAVE_PORT.
`[in] intf`	La interfaz opcional que se usará para conectarse al nodo de par. El valor predeterminado es INET_NULL_INTERFACEID.

Valores que se muestran

`WEAVE_NO_ERROR`	cuando se inicia correctamente la conexión con el par.
`WEAVE_ERROR_INCORRECT_STATE`	si el estado WeaveConnection es incorrecto.
`WEAVE_ERROR_UNSUPPORTED_AUTH_MODE`	si no se admite el modo de autenticación solicitado.
`WEAVE_ERROR_INVALID_ADDRESS`	si la dirección de destino no se puede deducir del identificador del nodo.
`other`	Errores de capa de inet generados por las operaciones de conexión TCPEndPoint.

Conexión

WEAVE_ERROR Connect(
  uint64_t peerNodeId,
  WeaveAuthMode authMode,
  const char *peerAddr,
  uint16_t defaultPort
)

Conéctate a un nodo de Weave mediante un identificador de nodo o un nombre de host de string.

Si se proporciona, paresAddr puede ser cualquiera de las siguientes opciones:


:

:

[]:

Nota: Si no se proporciona , se usa defaultPort. Si defaultPort es 0, se usa el WEAVE_PORT predeterminado. Si paresAddr es nulo, la dirección IP de tejido de nodo se derivará del campo parNodeId. Si el parámetro nodeNodeId es kNodeIdNotspecified (0), el identificador del nodo se derivará (si es posible) de la dirección IP del par.

Detalles

Parámetros

`[in] peerNodeId`	El identificador de nodo del par, kNodeIdNotspecified o 0 si no se conoce.
`[in] authMode`	El modo de autenticación deseado para el par. Solo se admiten los modos CASE, PASE y No autenticados.
`[in] peerAddr`	La dirección o el nombre de host del par como una string C terminada en NULL.
`[in] defaultPort`	El puerto predeterminado opcional que se usará para la conexión si no se proporciona en la stringpeerAddr.

Valores que se muestran

`WEAVE_NO_ERROR`	cuando se inicia correctamente la conexión con el par.
`WEAVE_ERROR_INCORRECT_STATE`	si el estado WeaveConnection es incorrecto.
`WEAVE_ERROR_UNSUPPORTED_AUTH_MODE`	si no se admite el modo de autenticación solicitado.
`WEAVE_ERROR_INVALID_ADDRESS`	si la dirección de destino no se puede deducir del ID de nodo.
`other`	Errores de capa de inet generados por las operaciones de conexión TCPEndPoint.

Conexión

WEAVE_ERROR Connect(
  uint64_t peerNodeId,
  WeaveAuthMode authMode,
  const char *peerAddr,
  uint16_t peerAddrLen,
  uint16_t defaultPort
)

Conéctate a un nodo de Weave mediante un identificador de nodo o una dirección de par de string.

Si se proporciona, paresAddr puede ser cualquiera de las siguientes opciones:


:

:

[]:

Nota: Si no se proporciona , se usa defaultPort. Si defaultPort es 0, se usa el puerto predeterminado de Weave. Si paresAddr es nulo, la dirección IP de tejido de nodo se derivará del campo parNodeId. Si el parámetro nodeNodeId es kNodeIdNotspecified (0), el identificador del nodo se derivará (si es posible) de la dirección IP del par.

Detalles

Parámetros

`[in] peerNodeId`	El identificador de nodo del par, kNodeIdNotspecified o 0 si no se conoce.
`[in] authMode`	El modo de autenticación deseado para el par. Solo se admiten los modos CASE, PASE y No autenticados.
`[in] peerAddr`	La dirección o el nombre de host del par como una string C no terminada con NULL
`[in] peerAddrLen`	La longitud de la string "peerAddr".
`[in] defaultPort`	El puerto predeterminado opcional que se usará para la conexión si no se proporciona en la stringpeerAddr.

Valores que se muestran

`WEAVE_NO_ERROR`	cuando se inicia correctamente la conexión con el par.
`WEAVE_ERROR_INCORRECT_STATE`	si el estado WeaveConnection es incorrecto.
`WEAVE_ERROR_UNSUPPORTED_AUTH_MODE`	si no se admite el modo de autenticación solicitado.
`WEAVE_ERROR_INVALID_ADDRESS`	si la dirección de destino no se puede deducir del ID de nodo.
`other`	Errores de capa de inet generados por las operaciones de conexión TCPEndPoint.

Conexión

WEAVE_ERROR Connect(
  uint64_t peerNodeId,
  WeaveAuthMode authMode,
  const char *peerAddr,
  uint16_t peerAddrLen,
  uint8_t dnsOptions,
  uint16_t defaultPort
)

Conéctate a un nodo de Weave mediante un identificador de nodo o una dirección de par de string.

Si se proporciona, paresAddr puede ser cualquiera de las siguientes opciones:


:

:

[]:

Detalles

Parámetros

`[in] peerNodeId`	El identificador de nodo del par, kNodeIdNotspecified o 0 si no se conoce.
`[in] authMode`	El modo de autenticación deseado para el par. Solo se admiten los modos CASE, PASE y No autenticados.
`[in] peerAddr`	La dirección o el nombre de host del par como una string C no terminada con NULL
`[in] peerAddrLen`	La longitud de la string "peerAddr".
`[in] dnsOptions`	Valor entero que controla cómo se realiza la resolución del nombre de host. El valor debe ser el OR de uno o más valores de la enumeración #::nl::Inet::DNSOptions
`[in] defaultPort`	El puerto predeterminado opcional que se usará para la conexión si no se proporciona en la stringpeerAddr.

Valores que se muestran

`WEAVE_NO_ERROR`	cuando se inicia correctamente la conexión con el par.
`WEAVE_ERROR_INCORRECT_STATE`	si el estado WeaveConnection es incorrecto.
`WEAVE_ERROR_UNSUPPORTED_AUTH_MODE`	si no se admite el modo de autenticación solicitado.
`WEAVE_ERROR_INVALID_ADDRESS`	si la dirección de destino no se puede deducir del ID de nodo.
`other`	Errores de capa de inet generados por las operaciones de conexión TCPEndPoint.

Conexión

WEAVE_ERROR Connect(
  uint64_t peerNodeId,
  WeaveAuthMode authMode,
  HostPortList hostPortList,
  InterfaceId intf
)

Conéctate a un nodo de Weave mediante un identificador de nodo o una lista de nombres de host y puertos.

Detalles

Parámetros

`[in] peerNodeId`	Es el identificador de nodo del par.
`[in] authMode`	El modo de autenticación que se usa para la conexión.
`[in] hostPortList`	La lista de nombres de host y puertos.
`[in] intf`	La interfaz opcional que se usará para conectarse al nodo de par. El valor predeterminado es INET_NULL_INTERFACEID.

Valores que se muestran

`WEAVE_NO_ERROR`	cuando se inicia correctamente la conexión con el par.
`WEAVE_ERROR_INCORRECT_STATE`	si el estado WeaveConnection es incorrecto.
`WEAVE_ERROR_UNSUPPORTED_AUTH_MODE`	si no se admite el modo de autenticación solicitado.
`WEAVE_ERROR_INVALID_ADDRESS`	si la dirección de destino no se puede deducir del ID de nodo.
`other`	Errores de capa de inet generados por las operaciones de conexión TCPEndPoint.

Conexión

WEAVE_ERROR Connect(
  uint64_t peerNodeId,
  WeaveAuthMode authMode,
  HostPortList hostPortList,
  uint8_t dnsOptions,
  InterfaceId intf
)

Conéctate a un nodo de Weave mediante un identificador de nodo o una lista de nombres de host y puertos.

Detalles

Parámetros

`[in] peerNodeId`	Es el identificador de nodo del par.
`[in] authMode`	El modo de autenticación que se usa para la conexión.
`[in] hostPortList`	La lista de nombres de host y puertos.
`[in] dnsOptions`	Valor entero que controla cómo se realiza la resolución del nombre de host. El valor debe ser el OR de uno o más valores de la enumeración #::nl::Inet::DNSOptions
`[in] intf`	La interfaz opcional que se usará para conectarse al nodo de par. El valor predeterminado es INET_NULL_INTERFACEID.

Valores que se muestran

`WEAVE_NO_ERROR`	cuando se inicia correctamente la conexión con el par.
`WEAVE_ERROR_INCORRECT_STATE`	si el estado WeaveConnection es incorrecto.
`WEAVE_ERROR_UNSUPPORTED_AUTH_MODE`	si no se admite el modo de autenticación solicitado.
`WEAVE_ERROR_INVALID_ADDRESS`	si la dirección de destino no se puede deducir del ID de nodo.
`other`	Errores de capa de inet generados por las operaciones de conexión TCPEndPoint.

Inhabilitar KeepKeep

WEAVE_ERROR DisableKeepAlive(
  void
)

WeaveConnection::DisableKeepAlive,

Inhabilita los sondeos de keepalive de TCP en la conexión TCP subyacente.

Nota: Solo se puede llamar a este método en una conexión de Weave respaldada por una conexión TCP. Solo se puede llamar a este método cuando la conexión está en un estado que permite enviar.

Este método no realizará ninguna acción si no se habilitaron los keepalives en la conexión.

Detalles

Valores que se muestran

`WEAVE_NO_ERROR`	en la inhabilitación correcta de los sondeos de keepalive de TCP en la conexión
`WEAVE_ERROR_NOT_IMPLEMENTED`	Si esta función se invoca para un extremo incompatible (p.ej., BLE) en la capa de la red.
`WEAVE_ERROR_INCORRECT_STATE`	si el objeto WeaveConnection no tiene el estado correcto para enviar mensajes.
`other`	Los errores de la capa de inet relacionados con el extremo de TCP habilitan la operación keepalive.

InhabilitarRecepción

void DisableReceive(
  void
)

Inhabilitar la recepción a través de esta WeaveConnection

La aplicación utiliza este método para indicar que no está listo para recibir los datos recibidos mediante la conexión TCP. Para volver a habilitar la recepción, la aplicación debe llamar a EnableReceive() a fin de permitir que WeaveConnection entregue los datos recibidos invocando las devoluciones de llamada correctas.

Consulta también:
EnableReceive()

Habilitar keepAlive

WEAVE_ERROR EnableKeepAlive(
  uint16_t interval,
  uint16_t timeoutCount
)

WeaveConnection::EnableKeepAlive.

Habilita los sondeos de keepalive de TCP en la conexión TCP subyacente.

Nota: Solo se puede llamar a este método en una conexión de Weave respaldada por una conexión TCP. - Solo se puede llamar a este método cuando la conexión está en un estado que permite enviar.

Detalles

Parámetros

`[in] interval`	El intervalo (en segundos) entre los sondeos de keepalive. Este valor también controla el tiempo entre el último paquete de datos enviado y la transmisión del primer sondeo de keepalive.
`[in] timeoutCount`	La cantidad máxima de sondeos no confirmados antes de que se considere que falló la conexión.

- Se puede llamar a este método varias veces para ajustar el intervalo de keepalive o el recuento de tiempos de espera.

Detalles

Valores que se muestran

`WEAVE_NO_ERROR`	cuando la habilitación correcta de los sondeos de keepalive de TCP en la conexión
`WEAVE_ERROR_NOT_IMPLEMENTED`	Si esta función se invoca para un extremo incompatible (p.ej., BLE) en la capa de la red.
`WEAVE_ERROR_INCORRECT_STATE`	si el objeto WeaveConnection no tiene el estado correcto para enviar mensajes.
`other`	Los errores de la capa de inet relacionados con el extremo de TCP habilitan la operación keepalive.

Habilitar recepción

void EnableReceive(
  void
)

Habilita la recepción a través de esta WeaveConnection.

La aplicación utiliza este método para indicar al objeto WeaveConnection que está listo para recibir los datos provenientes de la conexión TCP.

Consulta también:
DisableReceive()

GetPeerAddressInfo

WEAVE_ERROR GetPeerAddressInfo(
  IPPacketInfo & addrInfo
)

Obtén la información de la dirección IP del par.

Detalles

Parámetros

[out] addrInfo

Una referencia al objeto IPPacketInfo.

Valores que se muestran

`WEAVE_NO_ERROR`	Si la operación se realiza correctamente
`WEAVE_ERROR_NOT_IMPLEMENTED`	Si esta función se invoca para un extremo incompatible (p.ej., BLE) en la capa de la red.

GetPeerDescription

void GetPeerDescription(
  char *buf,
  size_t bufSize
) const

Construye una string que describe el nodo de par asociado con la conexión.

Detalles

Parámetros

`[in] buf`	Un puntero para un búfer en el que se debe escribir la string. El búfer suministrado debe ser al menos tan grande como kGetPeerDescription_MaxLength. Si se proporciona un búfer más pequeño, la string se truncará para que quepa. El resultado incluirá un carácter de terminación NUL en todos los casos.
`[in] bufSize`	Tamaño del búfer al que apunta un búfer.

ObtenerTCPEndPoint

TCPEndPoint * GetTCPEndPoint(
  void
) const

Entrante

bool IsIncoming(
  void
) const

ID de registro

uint16_t LogId(
  void
) const

Lanzar

void Release(
  void
)

Disminuir el recuento de referencia en el objeto WeaveConnection

El método Release() disminuye el recuento de referencia asociado con el objeto WeaveConnection. Si el resultado es que el recuento de referencias llega a cero, la conexión se cierra y el objeto de conexión se libera. Cuando esto sucede, la aplicación no debe tener más interacciones con el objeto.

Restablecer tiempo de espera del usuario

WEAVE_ERROR ResetUserTimeout(
  void
)

WeaveConnection::ResetUserTimeout.

Restablece la opción de socket de tiempo de espera del usuario TCP a la configuración predeterminada del sistema.

- Este método no realizará ninguna acción si no se estableció el tiempo de espera del usuario en la conexión.

Detalles

Valores que se muestran

`WEAVE_NO_ERROR`	si se restablece correctamente el tiempo de espera del usuario TCP en la conexión.
`WEAVE_ERROR_NOT_IMPLEMENTED`	Si esta función se invoca para un extremo incompatible (p.ej., BLE) en la capa de la red.
`WEAVE_ERROR_INCORRECT_STATE`	si el objeto WeaveConnection no tiene el estado correcto para enviar mensajes.
`other`	Errores de capa inestable en relación con el restablecimiento del extremo TCP del tiempo de espera del usuario TCP.

Enviar mensaje

WEAVE_ERROR SendMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

Enviar un mensaje de Weave a través de una conexión establecida.

Detalles

Parámetros

`[in] msgInfo`	Un puntero para un objeto WeaveMessageInfo.
`[in] msgBuf`	Un puntero al objeto PacketBuffer que contiene el paquete que se enviará.

Valores que se muestran

`WEAVE_NO_ERROR`	Se envía correctamente el mensaje a la capa de red.
`WEAVE_ERROR_INCORRECT_STATE`	si el objeto WeaveConnection no tiene el estado correcto para enviar mensajes.
`WEAVE_ERROR_INVALID_DESTINATION_NODE_ID`	si no se especifica el identificador de nodo de destino.
`WEAVE_ERROR_SENDING_BLOCKED`	si el mensaje es demasiado largo para enviarlo.
`other`	Se produjeron errores de capa relacionados con las operaciones de envío de extremos específicas.

Enviar TúnelDeMensaje

WEAVE_ERROR SendTunneledMessage(
  WeaveMessageInfo *msgInfo,
  PacketBuffer *msgBuf
)

Función para enviar un paquete de túnel a través de una conexión de Weave.

Enviar un mensaje de Weave en túnel a través de una conexión establecida.

Detalles

Parámetros

`[in] msgInfo`	Un puntero para un objeto WeaveMessageInfo.
`[in] msgBuf`	Un puntero al objeto PacketBuffer que contiene el paquete que se enviará.

Valores que se muestran

`WEAVE_NO_ERROR`	Se envía correctamente el mensaje a la capa de red.
`WEAVE_ERROR_INCORRECT_STATE`	si el objeto WeaveConnection no tiene el estado correcto para enviar mensajes.
`WEAVE_ERROR_INVALID_DESTINATION_NODE_ID`	si no se especifica el identificador de nodo de destino.
`WEAVE_ERROR_SENDING_BLOCKED`	si el mensaje es demasiado largo para enviarlo.
`other`	Se produjeron errores de capa relacionados con las operaciones de envío de extremos específicas.

SetConnectTimeout

void SetConnectTimeout(
  const uint32_t connTimeoutMsecs
)

Establece el tiempo de espera para que Connect se complete correctamente o muestre un error.

Detalles

Parámetros

[in] connTimeoutMsecs

Se agotó el tiempo de espera

WEAVE_ERROR SetIdleTimeout(
  uint32_t timeoutMS
)

Establece el tiempo de espera de inactividad en la conexión de la capa de red subyacente.

Detalles

Parámetros

[in] timeoutMS

el tiempo de espera en milisegundos.

Valores que se muestran

`WEAVE_NO_ERROR`	una configuración exitosa del tiempo de espera de inactividad de la conexión
`WEAVE_ERROR_INCORRECT_STATE`	si el objeto WeaveConnection no se encuentra en el estado correcto para recibir mensajes.

Entrante

void SetIncoming(
  bool val
)

SetUserTimeout

WEAVE_ERROR SetUserTimeout(
  uint32_t userTimeoutMillis
)

WeaveConnection::SetUserTimeout;

Configura la opción de socket de tiempo de espera del usuario TCP.

Cuando el valor es superior a 0, especifica la cantidad máxima de tiempo en milisegundos que los datos transmitidos pueden no reconocerse antes de que TCP cierre forzadamente la conexión correspondiente. Si el valor de la opción se especifica como 0, TCP utilizará el valor predeterminado del sistema. Consulta RFC 5482 para obtener más detalles.

Detalles

Parámetros

[in] userTimeoutMillis

Valor del tiempo de espera del usuario Tcp en milisegundos

- Se puede llamar a este método varias veces para ajustar el tiempo de espera del usuario TCP.

Detalles

Valores que se muestran

`WEAVE_NO_ERROR`	si la configuración del tiempo de espera del usuario TCP en la conexión es correcta.
`WEAVE_ERROR_NOT_IMPLEMENTED`	Si esta función se invoca para un extremo incompatible (p.ej., BLE) en la capa de la red.
`WEAVE_ERROR_INCORRECT_STATE`	si el objeto WeaveConnection no tiene el estado correcto para enviar mensajes.
`other`	Se produjeron errores de capa internos relacionados con la configuración del extremo de TCP del tiempo de espera del usuario TCP.

Cierre

WEAVE_ERROR Shutdown(
  void
)

Realiza un cierre de envío de TCP ordenado, lo que asegura que la pila de TCP de intercambio de tráfico haya enviado y recibido todos los datos salientes.

En la mayoría de las implementaciones de TCP (pero no todas) y la recepción del cierre de envío también provoca que el host remoto cierre la conexión, por lo que se cierra. Una llamada posterior a Close() finalizaría WeaveConnection.

Detalles

Valores que se muestran

`WEAVE_NO_ERROR`	cuando se cierre correctamente la conexión de TCP.
`WEAVE_ERROR_NOT_IMPLEMENTED`	Si esta función se invoca para un extremo incompatible (p.ej., BLE) en la capa de la red.
`WEAVE_ERROR_INCORRECT_STATE`	si el objeto WeaveConnection no tiene el estado correcto antes de iniciar el cierre
`other`	Se produjeron errores de capa internos relacionados con las operaciones de cierre de extremos específicas.

Consulta también:
Close() y Abort().