STEP 7 Professional V13 SP1 - Siemens Industry Online Support

STEP 7 Professional V13 SP1
TSEND: Enviar datos a través de la conexión
TSEND: Enviar datos a través de la conexión
Descripción
La siguiente descripción de la instrucción "TSEND" es válida para la CPU S7-1500 y S7-1200
≥ V4.0.
La instrucción "TSEND" sirve para enviar datos a través de una conexión existente. "TSEND"
se ejecuta de forma asíncrona.
El área de transmisión se especifica en el parámetro DATA. Éste contiene la dirección y la
longitud de los datos que deben enviarse. Para los datos que deben enviarse se pueden utilizar
todos los tipos de datos exceptuando BOOL y Array of BOOL.
La petición de transmisión se ejecuta cuando se detecta un flanco ascendente en el parámetro
REQ.
En el parámetro LEN se especifica el número máximo de bytes que deben enviarse con una
petición de transmisión.
•
•
En la transmisión de datos a través de TCP (protocolo de streaming), la instrucción "TSEND" no
transfiere información sobre la longitud de los datos enviados a "TRCV".
En la transmisión de datos a través de ISO-on-TCP (protocolo orientado a mensajes) se transfiere
la longitud de los datos enviados a "TRCV". La cantidad de datos enviados a través de "TSEND"
en forma de paquete debe volver a recibirse también en el lado del receptor ("TRCV"):
―
si el búfer de recepción es demasiado pequeño para los datos enviados, se produce un error
en el lado de receptor.
―
Si el búfer de recepción es suficientemente grande, "TRCV" devuelve DONE=1 en cuanto se
ha recibido el paquete de datos.
Los datos por enviar no se pueden editar hasta que no se haya ejecutado por completo la
petición de transmisión. Si la petición de transmisión se ejecuta correctamente, el parámetro
DONE se pone a "1". No obstante, el estado lógico "1" en el parámetro DONE no confirma que
el interlocutor haya leído ya los datos enviados.
Parámetros
La tabla siguiente muestra los parámetros de la instrucción "TSEND":
Parámetro
Declaración
Tipo de datos
Área de memoria
Descripción
REQ
Input
BOOL
I, Q, M, D, L o
constante
Inicia la petición de transmisión cuando se detecta un
flanco ascendente.
ID
Input
CONN_OUC
I, Q, M, D, L o
constante
Referencia a la conexión establecida con "TCON".
Rango de valores: W#16#0001 a W#16#0FFF
LEN
Input
UDINT
I, Q, M, D, L o
constante
Número máximo de bytes que se envían con la
petición (máximo valor admisible para S7-1200: 8192,
máximo valor admisible para S7-1500: 65536).
This document constitutes a free excerpt compiled by the user himself/herself from the documentation provided by Siemens for this product. Siemens disclaims
all liability for the completeness of this document. It shall only be used for the user's own internal purposes. It shall not be passed on to third parties. The complete
documentation can be found at:
/dokumentation/default.aspx?DocVersionId=74495465995&Language=es-ES&TopicId=71971667211
11/07/2016
STEP 7 Professional V13 SP1
TSEND: Enviar datos a través de la conexión
Parámetro
Declaración
Tipo de datos
Área de memoria
Descripción
DATA
InOut
VARIANT
I, Q, M, D, L
Puntero hacia el área de transmisión que contiene la
dirección y la longitud de los datos por enviar. La
dirección hace referencia a:
•
•
•
•
•
DONE
BUSY
ERROR
STATUS
Output
BOOL
Output
BOOL
Output
BOOL
Output
WORD
I, Q, M, D, L
I, Q, M, D, L
I, Q, M, D, L
I, Q, M, D, L
La memoria imagen de proceso de las entradas
La memoria imagen de proceso de las salidas
Una marca
Un bloque de datos
Datos locales
Parámetro de estado con los valores siguientes:
•
•
0: Petición no iniciada aún o en ejecución
1: Petición finalizada sin errores
Parámetro de estado con los valores siguientes:
•
•
0: Petición no iniciada aún o ya finalizada
1: Petición no finalizada aún. No es posible iniciar
una nueva petición.
Parámetro de estado con los valores siguientes:
•
•
0: Ningún error
1: Con errores
Estado de la instrucción
Encontrará más información sobre los tipos de datos válidos en "Vista general de los tipos de
datos válidos".
Parámetros LEN y DATA
•
•
•
•
•
•
Con LEN = 0 se envían todos los datos especificados con el parámetro DATA.
Si el número de bytes en el parámetro LEN excede la longitud de los datos que deben enviarse y
que se han definido con el parámetro DATA, se visualiza el código de error 8088 en el parámetro
STATUS (véase a continuación la descripción del parámetro STATUS).
Si a través del parámetro DATA se hace referencia a una estructura (Struct), LEN puede ser más
corto que la estructura. En este caso, solo se transfieren los datos hasta la longitud del parámetro
LEN.
En los tipos de datos STRING y WSTRING se transfieren todos los datos cuando el parámetro LEN
= 0. Si LEN > 0 la longitud debe abarcar como mínimo el número máximo de bytes, además de dos
bytes que contienen la información de la longitud. Encontrará más información sobre la estructura
de los tipos de datos en: "Vista general de los tipos de datos válidos".
El número máximo de bytes que se pueden transferir depende del dispositivo.
Si se utilizan variables estructuradas de DB optimizados, la dirección de la variable estructurada del
parámetro DATA se deberá interconectar y el parámetro LEN se deberá poner a 0. De este modo
se puede garantizar una transferencia de toda la estructura con seguridad de tipos siempre que en
el lado del receptor se utilice la misma estructura.
This document constitutes a free excerpt compiled by the user himself/herself from the documentation provided by Siemens for this product. Siemens disclaims
all liability for the completeness of this document. It shall only be used for the user's own internal purposes. It shall not be passed on to third parties. The complete
documentation can be found at:
/dokumentation/default.aspx?DocVersionId=74495465995&Language=es-ES&TopicId=71971667211
11/07/2016
STEP 7 Professional V13 SP1
TSEND: Enviar datos a través de la conexión
Parámetros BUSY, DONE y ERROR
El estado de ejecución se controla a través de los parámetros BUSY, DONE, ERROR y
STATUS. El parámetro BUSY indica el estado de ejecución. El parámetro DONE permite
comprobar si una petición se ha ejecutado correctamente. El parámetro ERROR se activa si
ocurren errores durante la ejecución de "TSEND". La información de error se indica en el
parámetro STATUS.
La tabla siguiente muestra la relación entre los parámetros BUSY, DONE y ERROR:
BUSY
DONE
ERROR
Descripción
1
0
0
La petición se está procesando.
0
1
0
La petición se ha ejecutado correctamente.
0
0
1
La petición se ha finalizado con un error. La causa del error se indica en el parámetro
STATUS.
0
0
0
No se ha asignado ninguna petición nueva.
Nota
Debido al procesamiento asíncrono de "TSEND", los datos del área de transmisión deben
mantenerse coherentes hasta que el parámetro DONE o el parámetro ERROR se ponga a "1".
Parámetros ERROR y STATUS
ERROR
STATUS*
(W#16#...)
Descripción
0
0000
Petición de transmisión finalizada sin errores.
0
7000
No se está procesando ninguna petición.
0
7001
Inicio del procesamiento de la petición, enviando los datos.
Durante el procesamiento, el sistema operativo accede a los datos del área de transmisión DATA.
0
7002
Procesando la petición (REQ es irrelevante).
Durante el procesamiento, el sistema operativo accede a los datos del área de transmisión DATA.
1
8085
•
•
El parámetro LEN excede el máximo valor admisible (para S7-1200: 8192, para S7-1500:
65536).
Los parámetros DATA y LEN tienen ambos el valor "0".
1
8086
El parámetro ID se encuentra fuera del área de direcciones admisible (1..0xFFF).
1
8088
El parámetro LEN es mayor que el rango indicado en DATA.
This document constitutes a free excerpt compiled by the user himself/herself from the documentation provided by Siemens for this product. Siemens disclaims
all liability for the completeness of this document. It shall only be used for the user's own internal purposes. It shall not be passed on to third parties. The complete
documentation can be found at:
/dokumentation/default.aspx?DocVersionId=74495465995&Language=es-ES&TopicId=71971667211
11/07/2016
STEP 7 Professional V13 SP1
TSEND: Enviar datos a través de la conexión
ERROR
STATUS*
(W#16#...)
Descripción
1
80A1
Error de comunicación:
•
•
•
La conexión indicada no se ha establecido todavía.
La conexión indicada se está finalizando. No es posible transferir a través de esta conexión.
La interfaz se está reinicializando.
1
80B1
El parámetro DATA se ha modificado antes de finalizar la petición en curso.
1
80B3
La variante de protocolo parametrizada (parámetro ConnectionType en la descripción de la
conexión) es UDP. En el caso de una conexión UDP, utilice la instrucción "TUSEND".
1
80C3
1
80C4
•
•
Ya se está procesando un bloque con esta ID en otro grupo de prioridad.
Escasez interna de recursos.
Error de comunicación temporal:
•
•
La conexión con el interlocutor no se puede establecer en estos momentos.
La interfaz está recibiendo nuevos ajustes de parámetros o la conexión se está estableciendo.
1
80C5
El interlocutor ha finalizado la conexión.
1
80C6
Error de red. No es posible acceder al interlocutor.
1
80C7
Rebase de tiempo de la ejecución.
* Los códigos de error en el editor de programas se pueden representar como valores enteros o hexadecimales. Encontrará
más información sobre el cambio de los formatos de visualización en "Consulte también".
Ver también
→ Vista general de los tipos de datos válidos
→ TRCV: Recibir datos a través de la conexión
This document constitutes a free excerpt compiled by the user himself/herself from the documentation provided by Siemens for this product. Siemens disclaims
all liability for the completeness of this document. It shall only be used for the user's own internal purposes. It shall not be passed on to third parties. The complete
documentation can be found at:
/dokumentation/default.aspx?DocVersionId=74495465995&Language=es-ES&TopicId=71971667211
11/07/2016