Funciones de Transmisión de Telegramas.

Funciones para la trasmisión y recepción de datos al sensor a través de telegramas. Más...

Funciones
LMSAPI_API int LMSAPI_ENTRY	lmsapi_read_from_laser (LMSAPI_CONNECTION *connection, uint8_t *data, int maxlen)
LMSAPI_API int LMSAPI_ENTRY	lmsapi_write_to_laser (LMSAPI_CONNECTION *connection, uint8_t *data, int len)
LMSAPI_API int LMSAPI_ENTRY	lmsapi_send_command (LMSAPI_CONNECTION *connection, uint8_t *packet, int len, uint8_t *outpacket, int maxoutlen, int expected_response)
	Envia un datagrama y obtiene una respuesta.

---

Descripción detallada

Funciones para la trasmisión y recepción de datos al sensor a través de telegramas.

---

Documentación de las funciones

LMSAPI_API int LMSAPI_ENTRY lmsapi_read_from_laser	(	LMSAPI_CONNECTION *	connection,
		uint8_t *	data,
		int	maxlen
	)

Esta funcion recibe un mensaje entrante del sensor LMS200 y entrega la seccion de los datos del telegrama. Para esto realiza los siguientes pasos:

1. Leer el encabezado.
2. Determinar la longitud del telegrama con el encabezado.
3. Verificar si hay desbordamiento.
4. Lee la seccion de los datos.
5. Lee la ultima seccion con el codigo CRC para verificar la integridad de los datos
6. Verificar el codigo CRC con el de los datos para verificar la integridad.

Si el telegrama es valido, retornará un valor mayor a 0.

Parámetros:

	connection	Puntero a manejador de la conexión a puerto serial.
	data	Buffer de recepción de datos
	maxlen	Maxima longitud del buffer para la recepción de los datos.

Devuelve:

La longitud de los datos recibidos en bytes. En caso de tener un error de lectura retornará 0.

Precondición:

connection Debe ser una conexión abierta a un puerto serial.

LMSAPI_API int LMSAPI_ENTRY lmsapi_send_command	(	LMSAPI_CONNECTION *	connection,
		uint8_t *	packet,
		int	len,
		uint8_t *	outpacket,
		int	maxoutlen,
		int	expected_response
	)

Envia un datagrama y obtiene una respuesta.

Envia un datagrama, y cuando este ha sido enviado satisfactoriamente recibe el mensaje de respuesta del sensor en un buffer de recepcion.

Precondición:

connection Debe ser una conexión abierta a un puerto serial.

Parámetros:

	connection	Puntero a manejador de la conexión a puerto serial.
	packet	Datagrama a enviar
	len	largo del datagrama a enviar.
	outpacket	Datagrama de respuesta
	maxoutlen	tamaño máximo del datagrama de respuesta.
	expected_response	Codigo de respuesta esperado en la recepcion del mensaje. Si se obtiene un codigo de respuesta diferente, se interpretará como una respuesta incorrecta.

Devuelve:

un entero positivo si el comando fue procesado con exito, si no entregara un numero negativo que indica un error.

Precondición:

connection Debe ser una conexión abierta a un puerto serial.

LMSAPI_API int LMSAPI_ENTRY lmsapi_write_to_laser	(	LMSAPI_CONNECTION *	connection,
		uint8_t *	data,
		int	len
	)

Esta funcion recibe un mensaje al sensor LMS200 a través de un telegrama.

1. Crear el encabezado.
2. Copiar el cuerpo del mensaje.
3. Crear el final del mensaje (CRC).
4. Escribir el buffer del telegrama en el puerto.

Parámetros:

	connection	Puntero a manejador de la conexión a puerto serial.
	data	Buffer de recepción de datos
	len	Maxima longitud del buffer para la recepción de los datos.

Devuelve:

El número de bytes enviados al sensor. En caso de error retornará 0.

Precondición:

connection Debe ser una conexión abierta a un puerto serial.

---