02 Instrucciones Funciones Tipos de Datos RAPID

ABB Robotics

Manual de referencia tcnicaInstrucciones, funciones y tipos de datos de RAPID

Trace back information:Workspace R11-2 version a3Checked in 2011-10-19Skribenta version 774

Manual de referencia tcnica

Instrucciones, funciones y tipos de datos de RAPIDRobotWare 5.14

ID de documento: 3HAC16581-5

Revisin: L

Copyright 2004-2011 ABB. Reservados todos los derechos.

La informacin de este manual puede cambiar sin previo aviso y no puede entendersecomo un compromiso por parte de ABB. ABB no se hace responsable de ningnerror que pueda aparecer en este manual.Excepto en los casos en que se indica expresamente en este manual, ninguna partedel mismo debe entenderse como una garanta por parte de ABB por las prdidas,lesiones, daos materiales, idoneidad para un fin determinado ni garantas similares.ABB no ser en ningn caso responsable de los daos accidentales o consecuentesque se produzcan como consecuencia del uso de este manual o de los productosdescritos en el mismo.Se prohbe la reproduccin o la copia de este manual o cualquiera de sus partes sino se cuenta con una autorizacin escrita de ABB.Usted puede obtener copias adicionales de este manual a travs de ABB.El idioma original de esta publicacin es el ingls. Cualquier otro idioma suministradoha sido traducido del ingls.


ABB ABRobotics Products

SE-721 68 VstersSuecia

Contenido15Descripcin general de este manual ...............................................................................................

171 Instrucciones

171.1 AccSet - Reduce la aceleracin ............................................................................191.2 ActUnit - Activa una unidad mecnica ...................................................................211.3 Add - Suma un valor numrico .............................................................................231.4 AliasIO - Define una seal de E/S con un nombre de alias ........................................261.5 ":=" - Asigna un valor .........................................................................................281.6 BitClear - Desactiva un bit especfico de un dato de byte ..........................................301.7 BitSet - Activa un bit especfico de un dato de byte ..................................................321.8 BookErrNo - Registra un nmero de error de sistema de RAPID ................................341.9 Break - Interrumpe la ejecucin del programa .........................................................351.10 CallByVar - Llama a un procedimiento mediante una variable ...................................371.11 CancelLoad - Cancela la carga de un mdulo .........................................................391.12 CheckProgRef - Comprobar referencias de programa ..............................................401.13 CirPathMode - Reorientacin de la herramienta durante trayectorias circulares ............461.14 Clear - Borra el valor ..........................................................................................471.15 ClearIOBuff - Vaca el bfer de entrada de un canal serie .........................................491.16 ClearPath - Elimina la trayectoria actual ................................................................531.17 ClearRawBytes - Borra el contenido de un dato de tipo rawbytes ...............................551.18 ClkReset - Pone a cero un reloj utilizado como temporizador .....................................561.19 ClkStart - Pone en marcha un reloj utilizado para la temporizacin .............................581.20 ClkStop - Detiene un reloj utilizado para la temporizacin .........................................591.21 Close - Cierra un archivo o un canal serie ..............................................................601.22 CloseDir - Cierra un directorio .............................................................................611.23 Comentario - Comentario ....................................................................................621.24 Compact IF (IF compacto) - Si se cumple una condicin, entonces... (una instruccin) ....631.25 ConfJ - Controla la configuracin durante el movimiento de los ejes ...........................651.26 ConfL - Monitoriza la configuracin durante el movimiento lineal ................................671.27 CONNECT - Conecta una interrupcin a una rutina TRAP .........................................691.28 CopyFile - Copia un archivo ................................................................................711.29 CopyRawBytes - Copia el contenido de un dato de tipo rawbytes ...............................741.30 CorrClear - Elimina todos los generadores de correcciones ......................................751.31 CorrCon - Establece una conexin con un generador de correcciones ........................801.32 CorrDiscon - Cierra la conexin con un generador de correcciones ............................811.33 CorrWrite - Escribe en un generador de correcciones ..............................................831.34 DeactUnit - Desactiva una unidad mecnica ...........................................................851.35 Decr - Reduce un nmero en 1 ............................................................................871.36 DitherAct - Activa la funcin de oscilacin del servo suave .......................................891.37 DitherDeact - Desactiva la funcin de oscilacin del servo suave ...............................901.38 DropWObj - Suelta un objeto de trabajo sobre un transportador .................................911.39 EOffsOff - Desactiva un offset de ejes externos ......................................................921.40 EOffsOn - Activa un offset de ejes externos ...........................................................941.41 EOffsSet - Activa un offset de ejes externos a partir de valores conocidos ...................961.42 EraseModule - Elimina un mdulo ........................................................................981.43 ErrLog - Escribe un mensaje de error ....................................................................

1021.44 ErrRaise - Escribe un aviso y llama a un gestor de errores ........................................1071.45 ErrWrite - Escribe un mensaje de error ..................................................................1091.46 EXIT - Finaliza la ejecucin del programa ..............................................................1101.47 ExitCycle - Interrumpe el ciclo actual y pasa al siguiente ..........................................1121.48 FOR - Repite un nmero determinado de veces ......................................................1151.49 GetDataVal - Obtiene el valor de un objeto de datos ................................................1181.50 GetSysData - Obtiene datos del sistema ................................................................1211.51 GetTrapData - Obtiene datos de interrupcin para la rutina TRAP actual .....................1231.52 GOTO - Salta a otra instruccin ...........................................................................1251.53 GripLoad - Define la carga til de un robot .............................................................

3HAC16581-5 Revisin: L 5 Copyright 2004-2011 ABB. Reservados todos los derechos.

Contenido

1271.54 HollowWristReset - Restablece la mueca hueca en los modelos IRB5402 e IRB5403 ....1291.55 IDelete - Cancela una interrupcin ........................................................................1301.56 IDisable - Desactiva todas las interrupciones ..........................................................1311.57 IEnable - Habilita el uso de interrupciones .............................................................1321.58 IError - Solicita una interrupcin para errores .........................................................1351.59 IF - Si se cumple una condicin, ...; de lo contrario, ... ..............................................1371.60 Incr - Aumenta en 1 un valor ...............................................................................1391.61 IndAMove - Movimiento independiente de posicin absoluta .....................................1431.62 IndCMove - Movimiento independiente continuo .....................................................1471.63 IndDMove - Movimiento independiente de posicin delta ..........................................1511.64 IndReset - Restablecimiento independiente ...........................................................1561.65 IndRMove - Movimiento independiente de posicin relativa ......................................1611.66 InvertDO - Invierte el valor de una seal de salida digital ..........................................1631.67 IOBusStart - Start of I/O bus ................................................................................1641.68 IOBusState - Obtener el estado actual de un bus de E/S ...........................................1671.69 IODisable - Desactiva una unidad de E/S ...............................................................1701.70 IOEnable - Activa una unidad de E/S .....................................................................1731.71 IPers - Interrupcin en caso de cambio de valor de una variable persistente ................1751.72 IRMQMessage - Ordenar interrupciones de RMQ para un tipo de dato ........................1801.73 ISignalAI - Interrupciones a partir de una seal analgica de entrada ..........................1901.74 ISignalAO - Interrupciones a partir de una seal analgica de salida ...........................1941.75 ISignalDI - Solicita interrupciones a partir de una seal digital de entrada ....................1971.76 ISignalDO - Interrupciones a partir de una seal digital de salida ...............................2001.77 ISignalGI - Solicita interrupciones de un grupo de seales digitales de entrada ............2031.78 ISignalGO - Solicita interrupciones de un grupo de seales digitales de salida .............2061.79 ISleep - Desactiva una interrupcin ......................................................................2081.80 ITimer - Solicita una interrupcin temporizada ........................................................2111.81 IVarValue - Solicita una interrupcin a partir del valor de una variable .........................2141.82 IWatch - Activar una interrupcin .........................................................................2161.83 Etiqueta - Nombre de lnea ..................................................................................2171.84 Load - Carga un mdulo de programa durante la ejecucin .......................................2211.85 LoadId - Identificacin de carga de la herramienta o la carga til ................................2271.86 MakeDir - Crea un nuevo directorio ......................................................................2281.87 ManLoadIdProc - Identificacin de carga de los manipuladores IRBP .........................2321.88 MechUnitLoad - Define una carga til para una unidad mecnica ...............................2371.89 MotionSup - Desactiva/activa la supervisin del movimiento .....................................2401.90 MoveAbsJ - Mueve el robot a una posicin de ejes absoluta .....................................2461.91 MoveC - Mueve el robot en crculo .......................................................................

2531.92 MoveCDO - Mueve el robot en una trayectoria circular y establece una salida digital en la

esquina ...........................................................................................................

2571.93 MoveCSync - Mueve el robot en una trayectoria circular y ejecuta un procedimiento de

RAPID .............................................................................................................2611.94 MoveExtJ - Mueve una o varias unidades mecnicas sin TCP ...................................2651.95 MoveJ - Mueve el robot mediante un movimiento de ejes .........................................

2701.96 MoveJDO - Mueve el robot mediante el movimiento de los ejes y activa una salida digital

en la esquina ....................................................................................................

2741.97 MoveJSync - Mueve el robot con un movimiento de ejes y ejecuta un procedimiento de

RAPID .............................................................................................................2781.98 MoveL - Mueve el robot siguiendo una trayectoria lineal ...........................................2831.99 MoveLDO - Mueve el robot linealmente y establece una salida digital en la esquina. .....2871.100 MoveLSync - Mueve el robot de forma lineal y ejecuta un procedimiento de RAPID .......2911.101 MToolRotCalib - Calibracin de la rotacin de una herramienta mvil .........................2941.102 MToolTCPCalib - Calibracin del TCP de una herramienta mvil ................................2971.103 Open - Abre un archivo o un canal serie ................................................................3021.104 OpenDir - Abre un directorio ................................................................................3041.105 PackDNHeader - Empaqueta un encabezado de DeviceNet en datos rawbytes .............3071.106 PackRawBytes - Empaqueta datos en un dato de tipo rawbytes .................................3121.107 PathAccLim - Reduce la aceleracin del TCP a lo largo de la trayectoria .....................3161.108 PathRecMoveBwd - Hace retroceder la grabadora de trayectorias ..............................

6 3HAC16581-5 Revisin: L Copyright 2004-2011 ABB. Reservados todos los derechos.

Contenido

3241.109 PathRecMoveFwd - Hace avanzar la grabadora de trayectorias .................................3271.110 PathRecStart - Inicia la grabadora de trayectorias ...................................................3301.111 PathRecStop - Detiene la grabadora de trayectorias ................................................3331.112 PathResol - Ajusta la resolucin de la trayectoria ....................................................3361.113 PDispOff - Desactiva el desplazamiento de programa ..............................................3371.114 PDispOn - Activa el desplazamiento de programa ...................................................

3421.115 PDispSet - Activa un desplazamiento de programa a partir de una base de coordenadas

conocida ..........................................................................................................3441.116 ProcCall - Llama a un nuevo procedimiento ...........................................................

3461.117 ProcerrRecovery - Genera errores de movimiento de proceso y permite la recuperacin

tras ellos .........................................................................................................3521.118 PulseDO - Genera un pulso en una seal digital de salida .........................................3551.119 RAISE - Llama a un gestor de errores ...................................................................3581.120 RaiseToUser - Propaga un error al nivel del usuario ................................................3611.121 ReadAnyBin - Lee datos de un canal serie o un archivo binario .................................3641.122 ReadBlock - Lee un bloque de datos de un dispositivo .............................................3661.123 ReadCfgData - Lee un atributo de un parmetro del sistema .....................................3701.124 ReadErrData - Obtiene informacin sobre un error ..................................................3741.125 ReadRawBytes - Lee datos de tipo rawbytes ..........................................................3771.126 RemoveDir - Elimina un directorio ........................................................................3791.127 RemoveFile - Elimina un archivo ..........................................................................3801.128 RenameFile - Cambia el nombre de un archivo .......................................................3821.129 Reset - Pone a cero una seal digital de salida .......................................................

3831.130 ResetPPMoved - Restablecer el estado del puntero de programa movido en el modo

manual. ...........................................................................................................3841.131 ResetRetryCount - Restablece el nmero de reintentos ............................................3861.132 RestoPath - Restablece la trayectoria despus de una interrupcin ............................3881.133 RETRY - Reanuda la ejecucin despus de un error ................................................3901.134 RETURN - Finaliza la ejecucin de una rutina .........................................................3921.135 Rewind - Rebobina la posicin del archivo .............................................................3951.136 RMQEmptyQueue - Vaca la cola de mensajes de RAPID .........................................3971.137 RMQFindSlot - Buscar una identidad de ranura para el nombre de ranura ...................3991.138 RMQGetMessage - Obtener un mensaje de RMQ ....................................................4021.139 RMQGetMsgData - Obtener la parte de datos de un mensaje de RMQ ........................4051.140 RMQGetMsgHeader - Obtener informacin de encabezado de un mensaje de RMQ ......4091.141 RMQReadWait - Devuelve un mensaje de una cola RMQ ..........................................4121.142 RMQSendMessage - Enviar un mensaje de datos de RMQ .......................................4161.143 RMQSendWait - Enviar un mensaje de datos de RMQ y esperar una respuesta ............4221.144 Save - Guarda un mdulo de programa .................................................................4251.145 SCWrite - Enva los datos de la variable a una aplicacin cliente ................................4281.146 SearchC - Realiza una bsqueda en crculo usando el robot .....................................4371.147 SearchExtJ - Busca con una o varias unidades mecnicas sin TCP ............................4441.148 SearchL - Realiza una bsqueda lineal usando el robot ............................................4541.149 SenDevice - Establece una conexin a un dispositivo de sensor ................................4561.150 Set - Activa una seal digital de salida ..................................................................4581.151 SetAllDataVal - Establece un valor en todos los objetos de datos de un conjunto definido .4601.152 SetAO - Cambia el valor de una seal analgica de salida ........................................4621.153 SetDataSearch - Definir el conjunto de smbolos de una secuencia de bsqueda ..........4661.154 SetDataVal - Establece el valor de un objeto de datos ..............................................4691.155 SetDO - Cambia el valor de una seal digital de salida .............................................4711.156 SetGO - Cambia el valor de un grupo de seales digitales de salida ...........................4741.157 SetSysData - Establece datos del sistema .............................................................4761.158 SingArea - Define el mtodo de interpolacin alrededor de puntos singulares ..............4781.159 SkipWarn - Omitir el ltimo aviso .........................................................................4791.160 SocketAccept - Acepta una conexin entrante ........................................................4821.161 SocketBind - Enlaza un zcalo a mi direccin IP y puerto .........................................4841.162 SocketClose - Cierra un zcalo ............................................................................4861.163 SocketConnect - Establece una conexin a un ordenador remoto ..............................4891.164 SocketCreate - Crea un nuevo zcalo ...................................................................


Contenido

4911.165 SocketListen - Permanece a la escucha de conexiones entrantes ..............................4931.166 SocketReceive - Recibe datos de un ordenador remoto ............................................4991.167 SocketSend - Enva datos a un ordenador remoto ...................................................5041.168 SoftAct - Activa el servo suave ............................................................................5061.169 SoftDeact - Desactiva el servo suave ....................................................................5071.170 SpeedRefresh - El ajuste de velocidad para el movimiento en curso ...........................5101.171 SpyStart - Comienza la grabacin de los datos de tiempo de ejecucin .......................5131.172 SpyStop - Detiene la grabacin de los datos de tiempo de ejecucin ..........................5141.173 StartLoad - Carga un mdulo de programa durante la ejecucin ................................5181.174 StartMove - Reanuda el movimiento del robot .........................................................5211.175 StartMoveRetry - Reanuda el movimiento y la ejecucin del robot ..............................5241.176 STCalib - Calibra una herramienta servo ................................................................5281.177 STClose - Cierra una herramienta servo ................................................................5311.178 StepBwdPath - Retrocede un paso a lo largo de la trayectoria ...................................5331.179 STIndGun - Pone la pistola en el modo independiente .............................................5351.180 STIndGunReset - Restablece el modo independiente de la pistola .............................5361.181 SToolRotCalib - Calibracin del TCP y de la rotacin de una herramienta estacionaria ....5391.182 SToolTCPCalib - Calibracin del TCP de una herramienta estacionaria .......................5431.183 Stop - Detiene la ejecucin del programa ...............................................................5461.184 STOpen - Abre una herramienta servo ..................................................................5481.185 StopMove - Detiene el movimiento del robot ..........................................................5521.186 StopMoveReset - Restablece el estado de movimiento de paro de sistema ..................5551.187 StorePath - Almacena la trayectoria cuando se produce una interrupcin ....................5581.188 STTune - Ajusta una herramienta servo .................................................................5621.189 STTuneReset - Restablece el ajuste de la herramienta servo .....................................5631.190 SyncMoveOff - Finaliza los movimientos sincronizados coordinados ..........................5701.191 SyncMoveOn - Inicia los movimientos sincronizados coordinados ..............................5781.192 SyncMoveResume - Activa el modo de movimientos sincronizados coordinados ..........5801.193 SyncMoveSuspend - Activa el movimiento independiente-semicoordinado ..................5821.194 SyncMoveUndo - Activa los movimientos independientes .........................................5841.195 SystemStopAction - Para el sistema de robot .........................................................5861.196 TEST - En funcin del valor de una expresin... ......................................................5881.197 TestSignDefine - Define una seal de prueba .........................................................5901.198 TestSignReset - Restablece todas las definiciones de seales de prueba ....................5911.199 TextTabInstall - Instalacin de una tabla de textos ...................................................5931.200 TPErase - Borra el texto mostrado en el FlexPendant ...............................................5941.201 TPReadDnum - Lee un nmero del FlexPendant .....................................................5971.202 TPReadFK - Lee las teclas de funcin ...................................................................6021.203 TPReadNum - Lee un nmero del FlexPendant .......................................................6061.204 TPShow - Cambia de ventana en el FlexPendant ....................................................6071.205 TPWrite - Escribe en el FlexPendant .....................................................................6091.206 TriggC - Movimiento circular del robot con eventos .................................................6161.207 TriggCheckIO - Define una comprobacin de E/S en una posicin fija .........................6221.208 TriggEquip - Define un evento de E/S basado en la posicin y el tiempo en la trayectoria .6281.209 TriggInt - Define una interrupcin dependiente de una posicin .................................6331.210 TriggIO - Define un evento de E/S de posicin o tiempo fijos cerca de un punto de paro ..6391.211 TriggJ - Movimientos de ejes del robot a partir de eventos ........................................6461.212 TriggL - Movimiento lineal del robot con eventos .....................................................6531.213 TriggLIOs - Movimientos lineales del robot con eventos de E/S .................................6591.214 TriggRampAO - Define un evento AO de rampa de posicin fija en la trayectoria ..........

6661.215 TriggSpeed - Define la velocidad del TCP en proporcin a una salida analgica con un

evento de escala fija de posicin-tiempo ...............................................................6741.216 TriggStopProc - Genera datos de reinicio para las seales de disparo ante paros .........6791.217 TryInt - Comprobar si un objeto de dato es un entero vlido ......................................6811.218 TRYNEXT - Salta sobre una instruccin que ha provocado un error ............................6821.219 TuneReset - Restablecimiento del ajuste del servo ..................................................6831.220 TuneServo - Ajuste de servos ..............................................................................6891.221 UIMsgBox - Cuadro de mensaje de usuario de tipo bsico ........................................6971.222 UIShow - Visualizacin de interfaz de usuario .........................................................


Contenido

7011.223 UnLoad - Descarga un mdulo de programa durante la ejecucin ..............................7041.224 UnpackRawBytes - Desempaqueta datos de un dato de tipo rawbytes ........................7091.225 VelSet - Cambia la velocidad programada ..............................................................7111.226 WaitAI - Espera hasta que se establece un valor de seal analgica de entrada ............7141.227 WaitAO - Espera hasta que se establece un valor de seal analgica de salida ............7171.228 WaitDI - Espera hasta que se activa una seal digital de entrada ...............................7191.229 WaitDO - Espera hasta que se activa una seal digital de salida ................................7211.230 WaitGI - Espera hasta que se activa un grupo de entradas digitales ............................7251.231 WaitGO - Espera hasta que se activa un grupo de salidas digitales ............................7291.232 WaitLoad - Conecta el mdulo cargado a la tarea ....................................................7341.233 WaitRob - Esperar hasta un punto de paro o una velocidad cero ................................7361.234 WaitSyncTask - Espera en un punto de sincronizacin con otras tareas de programa ....7401.235 WaitTestAndSet - Espera a que se desactive una variable y la activa a continuacin .....7431.236 WaitTime - Espera una cantidad de tiempo determinada ...........................................7451.237 WaitUntil - Espera hasta que se cumple una condicin .............................................7491.238 WaitWObj - Espera a un objeto de trabajo en un transportador ..................................7521.239 WarmStart - Reinicia el controlador ......................................................................7531.240 WHILE - Repite una o varias operaciones siempre y cuando... ...................................7551.241 WorldAccLim - Control de aceleracin en el sistema de coordenadas mundo ...............7571.242 Write - Escribe en un archivo o un canal serie alfanumrico ......................................7611.243 WriteAnyBin - Escribe datos en un canal serie o archivo binario ................................7641.244 WriteBin - Escribe en un canal serie binario ...........................................................7661.245 WriteBlock - Escribe un bloque de datos en un dispositivo ........................................7681.246 WriteCfgData - Escribe un atributo de un parmetro del sistema ................................7721.247 WriteRawBytes - Escribe un dato de tipo rawbytes ..................................................7751.248 WriteStrBin - Escribe una cadena de caracteres en un canal serie binario ....................7771.249 WriteVar - Escribe una variable ............................................................................7801.250 WZBoxDef - Define una zona mundo con forma de prisma ........................................7821.251 WZCylDef - Define una zona mundo con forma cilndrica ..........................................7851.252 WZDisable - Desactiva la supervisin de las zonas mundo temporales ........................7871.253 WZDOSet - Activacin de salidas digitales basadas en zonas mundo .........................7911.254 WZEnable - Activa la supervisin de las zonas mundo temporales .............................7931.255 WZFree - Elimina la supervisin de las zonas mundo temporales ...............................7951.256 WZHomeJointDef - Define una zona mundo para las posiciones iniciales de los ejes .....7991.257 WZLimJointDef - Define una zona mundo para la limitacin de los ejes .......................8031.258 WZLimSup - Activa la supervisin de lmites de las zonas mundo ..............................8061.259 WZSphDef - Define una zona mundo con forma esfrica ..........................................

8092 Funciones

8092.1 Abs - Obtiene el valor absoluto ............................................................................8112.2 AbsDnum - Obtiene el valor absoluto de un dnum ...................................................8132.3 ACos - Calcula el valor de arco coseno .................................................................8142.4 AOutput - Lee el valor de una seal analgica de salida ...........................................8162.5 ArgName - Obtiene el nombre de un argumento .....................................................8202.6 ASin - Calcula el valor del arco seno .....................................................................8212.7 ATan - Calcula el valor de arco tangente ................................................................8222.8 ATan2 - Calcula el valor de arco tangente 2 ...........................................................8232.9 BitAnd - AND lgico bit a bit - Operacin con datos de byte ......................................8252.10 BitCheck - Comprueba si un bit especificado de un dato de byte est activado .............8272.11 BitLSh - DESPLAZAMIENTO A LA IZQUIERDA lgico bit a bit - Operacin de byte ........8292.12 BitNeg - NEGACIN lgica bit a bit - Operacin con datos de byte .............................8312.13 BitOr - OR lgico bit a bit - Operacin con datos de byte ..........................................8332.14 BitRSh - DESPLAZAMIENTO A LA DERECHA lgico bit a bit - Operacin de byte .........8352.15 BitXOr - XOR lgico bit a bit - Operacin con datos de byte .......................................8372.16 ByteToStr - Convierte un byte en un dato de cadena de caracteres ............................8392.17 CalcJointT - Calcula los ngulos de las articulaciones a partir de un robtarget ..............8432.18 CalcRobT - Calcula el valor de robtarget a partir de jointtarget ...................................8452.19 CalcRotAxFrameZ - Calcular la base de coordenadas de un eje de rotacin .................8502.20 CalcRotAxisFrame - Calcular la base de coordenadas de un eje de rotacin ................


Contenido

8552.21 CDate - Lee la fecha actual como una cadena ........................................................8562.22 CJointT - Lee los ngulos actuales de los ejes ........................................................8582.23 ClkRead - Lee un reloj utilizado para la temporizacin ..............................................8602.24 CorrRead - Lee los offsets totales actuales ............................................................8612.25 Cos - Calcula el valor del coseno .........................................................................8622.26 CPos - Lee los datos de posicin (pos) actuales .....................................................8642.27 CRobT - Lee los datos de posicin (robtarget) actuales ............................................8672.28 CSpeedOverride - Lee el ajuste de velocidad actual .................................................8692.29 CTime - Lee la hora actual en forma de una cadena .................................................8702.30 CTool - Lee los datos actuales de la herramienta ....................................................8722.31 CWObj - Lee los datos del objeto de trabajo actual ..................................................8742.32 DecToHex - Convierte de decimal a hexadecimal ....................................................8752.33 DefAccFrame - Define una base de coordenadas exacta ..........................................8782.34 DefDFrame - Define una base de coordenadas de desplazamiento .............................8812.35 DefFrame - Define una base de coordenadas .........................................................8842.36 Dim - Obtiene las dimensiones de una matriz .........................................................8862.37 Distance - Distancia entre dos puntos ...................................................................8882.38 DnumToNum - Convierte dnum a num ..................................................................8902.39 DnumToStr - Convierte un valor numrico en una cadena de caracteres .....................8922.40 DotProd - Producto escalar de dos vectores pos .....................................................8942.41 DOutput - Lee el valor de una seal digital de salida ................................................8962.42 EulerZYX - Obtiene ngulos Euler a partir de una orientacin ....................................8982.43 EventType - Obtiene el tipo de evento actual dentro de cualquier rutina de evento ........9002.44 ExecHandler - Obtener el tipo de gestor de ejecucin ..............................................9012.45 ExecLevel - Obtener el nivel de ejecucin ..............................................................9022.46 Exp - Calcula el valor exponencial ........................................................................9032.47 FileSize - Obtiene el tamao de un archivo ............................................................9062.48 FileTime - Obtiene la informacin de hora de un archivo ...........................................9102.49 FSSize - Obtiene el tamao de un sistema de archivos .............................................9132.50 GetMecUnitName - Obtiene el nombre de la unidad mecnica. ..................................9142.51 GetNextMechUnit - Obtener el nombre y los datos de las unidades mecnicas .............9172.52 GetNextSym - Obtiene el siguiente smbolo coincidente ...........................................9192.53 GetServiceInfo - Obtener informacin de servicio del sistema ...................................9212.54 GetSysInfo - Obtener informacin acerca del sistema ..............................................9242.55 GetTaskName - Obtiene el nombre y el nmero de la tarea actual ..............................9262.56 GetTime - Lee la hora actual como un valor numrico ..............................................9282.57 GInputDnum - Lee el valor de una seal de entrada de grupo ....................................9312.58 GOutput - Lee el valor de un grupo de seales digitales de salida ..............................9332.59 GOutputDnum - Lee el valor de una seal de salida de grupo ....................................9362.60 HexToDec - Convierte de hexadecimal a decimal ....................................................9372.61 IndInpos - Estado de posicin de un eje independiente ............................................9392.62 IndInpos - Estado de velocidad de un eje independiente ...........................................9412.63 IOUnitState - Obtiene el estado actual de una unidad de E/S .....................................9442.64 IsFile - Comprobar el tipo de un archivo ................................................................9482.65 IsMechUnitActive - Indica si una unidad mecnica est activa ...................................9492.66 IsPers - Determina si es una variable persistente ....................................................9512.67 IsStopMoveAct - Est activo el indicador de movimiento de paro ...............................9532.68 IsStopStateEvent - Comprueba si se ha movido el puntero de programa .....................9552.69 IsSyncMoveOn - Comprueba si el modo de movimiento sincronizado est activado ......9572.70 IsSysID - Comprobar la identidad del sistema .........................................................9582.71 IsVar - Determina si un dato es una variable ...........................................................9592.72 MaxRobSpeed - Velocidad mxima del robot ..........................................................9602.73 MirPos - Obtencin de la posicin espejo de una posicin ........................................9622.74 ModExist - Comprobar si un mdulo de programa existe ..........................................9632.75 ModTime - Obtiene la hora de modificacin del mdulo cargado ................................9652.76 MotionPlannerNo - Obtiene el nmero de planificador de movimientos conectado ........9672.77 NonMotionMode - Lee el modo de ejecucin sin movimiento .....................................9692.78 NOrient - Normaliza la orientacin ........................................................................9712.79 NumToDnum - Convierte num a dnum ..................................................................


Contenido

9722.80 NumToStr - Convierte un valor numrico en una cadena de caracteres .......................9742.81 Offs - Desplaza una posicin del robot ..................................................................9762.82 OpMode - Lee el modo de funcionamiento .............................................................9772.83 OrientZYX - Genera una orientacin a partir de ngulos Euler ...................................9792.84 ORobT - Elimina el desplazamiento de programa de una posicin ..............................9812.85 ParIdPosValid - Posicin de robot vlida para la identificacin de parmetros ..............9842.86 ParIdRobValid - Tipo de robot vlido para la identificacin de parmetros ...................9872.87 PathLevel - Obtiene el nivel de trayectoria actual ....................................................9892.88 PathRecValidBwd - Comprueba si existe una trayectoria de retroceso vlida guardada ...9922.89 PathRecValidFwd - Comprueba si existe una trayectoria de avance vlida guardada .....

9972.90 PFRestart - Comprueba si se ha interrumpido una trayectoria despus de un fallo de

alimentacin .....................................................................................................9982.91 PoseInv - Invierte los datos de pose .....................................................................

10002.92 PoseMult - Multiplica datos de pose ......................................................................10022.93 PoseVect - Aplica una transformacin a un vector ...................................................10042.94 Pow - Calcula el resultado de elevar un valor a una potencia .....................................10052.95 PowDnum - Calcula el resultado de elevar un valor a una potencia .............................

10072.96 PPMovedInManMode - Comprobar si el puntero de programa se ha movido en el modo

manual. ...........................................................................................................10082.97 Present - Comprueba si se est usando un parmetro opcional .................................10102.98 ProgMemFree - Obtiene el tamao de memoria libre del programa .............................10112.99 RawBytesLen - Obtiene la longitud de un dato de tipo rawbytes .................................10132.100 ReadBin - Lee un byte de un archivo o un canal serie ..............................................10162.101 ReadDir - Lee la siguiente entrada de un directorio ..................................................10192.102 ReadMotor - Lee los ngulos actuales de los motores ..............................................10212.103 ReadNum - Lee un nmero de un archivo o un canal serie ........................................10242.104 ReadStr - Lee una cadena de caracteres de un archivo o un canal serie ......................10282.105 ReadStrBin - Lee una cadena de un canal serie o un archivo binario ...........................10302.106 ReadVar - Lee una variable de un dispositivo .........................................................10322.107 RelTool - Hace un desplazamiento respecto de la herramienta ..................................10342.108 RemainingRetries - Reintentos restantes an pendientes .........................................10352.109 RMQGetSlotName - Obtener el nombre de un cliente de RMQ ...................................10372.110 RobName - Obtiene el nombre del robot del TCP ....................................................10392.111 RobOS - Comprueba si el programa se est ejecutando en RC o VC ..........................10402.112 Round - Redondear un valor numrico ..................................................................10422.113 RoundDnum - Redondear un valor numrico ..........................................................10442.114 RunMode - Obtiene el modo de ejecucin ..............................................................10462.115 Sin - Calcula el valor del seno ..............................................................................10472.116 SocketGetStatus - Obtiene el estado actual de un zcalo ..........................................10502.117 Sqrt - Calcula el valor de la raz cuadrada ..............................................................10512.118 SqrtDnum - Calcula el valor de la raz cuadrada ......................................................10522.119 STCalcForce - Calcula fuerza de la punta de una herramienta servo ...........................10542.120 STCalcTorque - Calcula el par motor de una herramienta servo .................................10562.121 STIsCalib - Compruebe si una herramienta servo est calibrada ................................10582.122 STIsClosed - Comprueba si una herramienta servo est cerrada ................................

10602.123 STIsIndGun - Comprueba si una herramienta servo se encuentra en el modo

independiente ...................................................................................................10612.124 STIsOpen - Comprueba si una herramienta servo est abierta ...................................10632.125 StrDigCalc - Operaciones aritmticas con el tipo de dato stringdig .............................10662.126 StrDigCmp - Comparar dos cadenas que slo contienen dgitos ................................10692.127 StrFind - Busca un carcter en una cadena de caracteres .........................................10712.128 StrLen - Obtiene la longitud de una cadena ............................................................10722.129 StrMap - Mapea una cadena de caracteres .............................................................10742.130 StrMatch - Busca un patrn dentro de una cadena de caracteres ...............................10762.131 StrMemb - Comprueba si un carcter pertenece a un conjunto ..................................10782.132 StrOrder - Comprueba si dos cadenas de caracteres estn ordenadas ........................10812.133 StrPart - Busca una parte de una cadena ...............................................................10832.134 StrToByte - Convierte una cadena en un byte .........................................................10852.135 StrToVal - Convierte una cadena de caracteres en un valor .......................................


Contenido

10872.136 Tan - Calcula el valor de tangente ........................................................................10882.137 TaskRunMec - Comprueba si una tarea controla alguna unidad mecnica ...................10892.138 TaskRunRob - Comprueba si una tarea controla algn robot .....................................10902.139 TasksInSync - Devuelve el nmero de tareas sincronizadas ......................................10922.140 TestAndSet - Comprueba una variable y la establece si no est establecida ................10952.141 TestDI - Se comprueba si una entrada digital est activada .......................................10962.142 TestSignRead - Obtiene el valor de una seal de test ...............................................10982.143 TextGet - Obtener un texto de las tablas de textos del sistema ..................................11002.144 TextTabFreeToUse - Comprueba si una tabla de textos est libre para su uso ..............11022.145 TextTabGet - Obtiene el nmero de una tabla de textos ............................................11042.146 Trunc - Trunca un valor numrico .........................................................................11062.147 TruncDnum - Trunca un valor numrico .................................................................11082.148 Type - Obtener el nombre del tipo de dato de una variable ........................................11102.149 UIAlphaEntry - Introduccin alfanumrica del usuario ..............................................11162.150 UIClientExist - Existe cliente de usuario .................................................................11182.151 UIDnumEntry - Introduccin de nmero de usuario ..................................................11252.152 UIDnumTune - Ajuste de nmero de usuario ..........................................................11322.153 UIListView - Vista de lista de usuario ....................................................................11412.154 UIMessageBox - Cuadro de mensaje de usuario de tipo avanzado .............................11492.155 UINumEntry - Introduccin de nmero de usuario ...................................................11562.156 UINumTune - Ajuste de nmero de usuario ............................................................11622.157 ValidIO - Seal de E/S vlida para su uso ..............................................................11642.158 ValToStr - Convierte un valor en una cadena ..........................................................11662.159 VectMagn - Magnitud de un vector pos ..................................................................

11693 Tipos de datos

11693.1 aiotrigg - Condicin de disparo con E/S analgica ...................................................11713.2 bool - Valores lgicos .........................................................................................11723.3 btnres - Datos de resultado de pulsador ................................................................11743.4 busstate - Estado de bus de E/S ..........................................................................11753.5 buttondata - Datos de pulsador ............................................................................11773.6 byte - Valores enteros de 0 a 255 .........................................................................11783.7 clock - Medicin de tiempo ..................................................................................11793.8 confdata - Datos de configuracin del robot ...........................................................11853.9 corrdescr - Descriptor de generador de correcciones ...............................................11873.10 datapos - Inclusin de un bloque para un objeto de datos .........................................11883.11 dionum - Valores digitales (0 - 1) ..........................................................................11893.12 dir - Estructura de directorio de archivos ...............................................................11903.13 dnum - Valores numricos dobles ........................................................................11923.14 errdomain - Dominio de error ...............................................................................11943.15 errnum - Nmero de error ...................................................................................12013.16 errstr - Cadena de error ......................................................................................12023.17 errtype - Tipo de error ........................................................................................12033.18 event_type - Tipo de rutina de evento ...................................................................12043.19 exec_level - Execution level ................................................................................12053.20 extjoint - Posicin de los ejes externos ..................................................................12073.21 handler_type - Type of execution handler ..............................................................12083.22 icondata - Datos de visualizacin de iconos ...........................................................12103.23 identno - Identidad para las instrucciones de movimiento .........................................12123.24 intnum - Identidad de interrupcin ........................................................................12143.25 iodev - Canales serie y archivos ...........................................................................12153.26 iounit_state - Estado de la unidad de E/S ...............................................................12163.27 jointtarget - Datos de posicin de eje ....................................................................12183.28 listitem - Estructura de datos de elementos de lista .................................................12193.29 loaddata - Datos de carga ...................................................................................12253.30 loadidnum - Tipo de identificacin de la carga ........................................................12263.31 loadsession - Programar una sesin de carga ........................................................12273.32 mecunit - Unidad mecnica .................................................................................12293.33 motsetdata - Datos de parmetros de movimiento ...................................................


Contenido

12343.34 num - Valores numricos ....................................................................................12363.35 opcalc - Arithmetic Operator ................................................................................12373.36 opnum - Operador de comparacin ......................................................................12383.37 orient - Orientacin ............................................................................................12433.38 paridnum - Tipo de identificacin de parmetro .......................................................12453.39 paridvalidnum - Resultado de ParIdRobValid ..........................................................12473.40 pathrecid - Identificador de grabadora de trayectorias ..............................................12493.41 pos - Posiciones (slo X, Y y Z) ............................................................................12513.42 pose - Transformaciones de coordenadas .............................................................12523.43 progdisp - Desplazamiento de programa ...............................................................12543.44 rawbytes - Datos sin formato ...............................................................................12563.45 restartdata - Datos de reinicio de seales de disparo ...............................................12603.46 rmqheader - Encabezado de mensaje de RAPID Message Queue ..............................12623.47 rmqmessage - Mensaje de RAPID Message Queue .................................................12643.48 rmqslot - Nmero de identidad de un cliente de RMQ ...............................................12653.49 robjoint - Posicin de eje de los ejes del robot ........................................................12663.50 robtarget - Datos de posicin ...............................................................................12703.51 shapedata - Datos de forma de zonas mundo .........................................................12723.52 signalxx - Seales digitales y analgicas ...............................................................12743.53 socketdev - Dispositivo de zcalo .........................................................................12753.54 socketstatus - Estado de comunicacin de zcalo ...................................................12763.55 speeddata - Datos de velocidad ...........................................................................12803.56 stoppointdata - Datos de punto de paro .................................................................12873.57 string - Cadenas de caracteres ............................................................................12893.58 stringdig - Cadena de caracteres con slo dos dgitos ..............................................12903.59 switch - Optional parameters ..............................................................................12913.60 symnum - Nmero simblico ...............................................................................12933.61 syncident - Identidad de punto de sincronizacin ....................................................12943.62 Datos del sistema - Valores actuales de los datos del sistema de RAPID .....................12973.63 taskid - Identificacin de tareas ............................................................................12983.64 tasks - Tareas de programa de RAPID ...................................................................13003.65 testsignal - Seal de prueba ................................................................................13013.66 tooldata - Datos de herramientas ..........................................................................13083.67 tpnum - Nmero de ventana del FlexPendant .........................................................13093.68 trapdata - Datos de interrupcin para la rutina TRAP actual .......................................13113.69 triggdata - Eventos de posicionamiento, trigg .........................................................13133.70 triggios - Positioning events, trigg ........................................................................13163.71 triggiosdnum - Positioning events, trigg .................................................................13183.72 triggstrgo - Positioning events, trigg .....................................................................13213.73 tunetype - Tipo de ajuste de servo ........................................................................13223.74 uishownum - ID de instancia para UIShow .............................................................13233.75 wobjdata - Datos del objeto de trabajo ..................................................................13273.76 wzstationary - Datos de zona mundo estacionaria ...................................................13293.77 wztemporary - Datos de zona mundo temporal .......................................................13313.78 zonedata - Datos de zonas ..................................................................................

13394 Ejemplos de tipos de programacin

13394.1 Gestor de ERROR con movimientos .....................................................................13424.2 Rutinas de servicio con o sin movimientos .............................................................13464.3 Interrupciones de E/S del sistema con o sin movimiento ...........................................13504.4 Rutinas TRAP con movimientos ...........................................................................

1355ndice


Contenido

Esta pgina se ha dejado vaca intencionadamente

Descripcin general de este manualAcerca de este manual

ste es un manual de referencia tcnica destinado a los programadores de RAPID.En este manual se detallan las instrucciones, las funciones y tipos de datos bsicosde RAPID.

UtilizacinEste manual debe leerse durante la programacin y siempre que se necesiteinformacin especfica acerca de una instruccin, funcin o tipo de dato de RAPID.

A quin va destinado este manual?Este manual est destinado a personas que tengan cierta experiencia anterior conla programacin, por ejemplo un programador de robots.

Requisitos previosEl lector debe tener cierta experiencia en programacin y haber estudiado:

Operating manual - Introduction to RAPID

Technical reference manual - RAPID overview

Organizacin de los captulosEste manual est organizado en los captulos siguientes:

ContenidoCaptulo

Descripciones detalladas de todas las instruc-ciones bsicas de RAPID, con ejemplos decmo usarlas.

1Instrucciones

Descripciones detalladas de todas las funcio-nes bsicas de RAPID, con ejemplos de cmousarlas.

2Funciones

Descripciones detalladas de todos los tiposde datos bsicos de RAPID, con ejemplos decmo usarlas.

3 Tipos de datos

Una visin general de cmo escribir cdigode programa con instrucciones/funciones/tiposde datos diferentes. Este captulo tambincontiene sugerencias y explicaciones de pro-gramacin.

4 Ejemplos de tipos de programacin

Referencias

ID de documentoReferencia

3HAC029364-005Operating manual - Introduction to RAPID

3HAC16580-5Technical reference manual - RAPID over-view

3HAC16585-1Technical reference manual - RAPID kernel

Contina en la pgina siguiente3HAC16581-5 Revisin: L 15


Descripcin general de este manual

Revisiones

DescripcinRevisin

7 edicin. RobotWare 5.10.FAadido un nuevo captulo, 4 Ejemplos de tipos de programacin.

8 edicin. RobotWare 5.11.GAadidos nuevos tipos de datos, instrucciones y funciones. Tambin seha aadido un nuevo ejemplo de tipo de programacin.

9 edicin. RobotWare 5.12.HAadidos nuevos tipos de datos, instrucciones y funciones.

10 edicin. RobotWare 5.13.JAadidos los siguientes nuevos tipos de datos, instrucciones y funciones:

TPReadNum - Lee un nmero del FlexPendant en la pgina 602 Type - Obtener el nombre del tipo de dato de una variable en la p-

gina 1108 UIDnumEntry - Introduccin de nmero de usuario en la pgina1118 UIDnumTune - Ajuste de nmero de usuario en la pgina 1125 triggiosdnum - Positioning events, trigg en la pgina 1316

Actualizados los grficos de las seales de seguridad para los niveles Pe-ligro y Aviso.

11 edicin. RobotWare 5.14.KAadidas las siguientes funciones nuevas:

AbsDnum - Obtiene el valor absoluto de un dnum en la pgina 811 DnumToStr - Convierte un valor numrico en una cadena de carac-

teres en la pgina 890 GetServiceInfo - Obtener informacin de servicio del sistema en la

pgina 919 PowDnum - Calcula el resultado de elevar un valor a una potencia

en la pgina 1005 RoundDnum - Redondear un valor numrico en la pgina 1042 SqrtDnum - Calcula el valor de la raz cuadrada en la pgina 1051 TruncDnum - Trunca un valor numrico en la pgina 1106

12 edicin. RobotWare 5.14.02.LActualizaciones relacionadas con el caso estacionario y la relacin de losdiferentes sistemas de coordenadas en los siguientes tipos de datos:

loaddata - Datos de carga en la pgina 1219 tooldata - Datos de herramientas en la pgina 1301

Actualizaciones diversas en las siguientes instrucciones: GripLoad - Define la carga til de un robot en la pgina 125 MechUnitLoad - Define una carga til para una unidad mecnica en

la pgina 232


Descripcin general de este manual

Continuacin

1 Instrucciones1.1 AccSet - Reduce la aceleracin

UtilizacinAccSet se utiliza para manejar cargas frgiles. Permite obtener aceleraciones ydeceleraciones ms lentas, lo que da lugar a movimientos ms suaves en el robot.

Esta instruccin slo puede usarse en la tarea principal T_ROB1 o, si se cuentacon un sistema MultiMove, en las tareas de movimiento.

Ejemplos bsicosA continuacin aparecen algunos ejemplos bsicos de la instruccin AccSet.

Ejemplo 1AccSet 50, 100;

La aceleracin se limita al 50% del valor normal.

Ejemplo 2AccSet 100, 50;

La pendiente de aceleracin se limita al 50% del valor normal.

ArgumentosAccSet Acc Ramp

Acc

Tipo de dato: num

Aceleracin y deceleracin como porcentaje de los valores normales. El 100% esla aceleracin mxima. Valor mximo: 100%. Un valor de entrada < 20% proporcionaun 20% de la aceleracin mxima.

RampTipo de dato: num

La proporcin en que la aceleracin y deceleracin aumentan como porcentajede los valores normales. La reduccin de este valor permite limitar la vibracin.El 100% es el valor mximo. Valor mximo: 100%. Un valor de entrada < 10%proporciona un 10% del valor mximo.



1 Instrucciones

1.1 AccSet - Reduce la aceleracin

Las figuras muestran cmo la reduccin de la aceleracin da lugar a unosmovimientos ms suaves.

Aceleracin

Tiempo

AccSet 30, 100

Aceleracin

AccSet 100, 30

Aceleracin

Tiempo

AccSet 100, 100, es decir, aceleracin normal

Tiempo

xx0500002146_es

Ejecucin de programasLa aceleracin se aplica tanto a los ejes del robot como a los ejes externos hastaque se ejecuta una nueva instruccin AccSet.

Los valores predeterminados (100%) se establecen automticamente en los casossiguientes:

En los arranques en fro.

Cuando se carga un nuevo programa.

Cuando se inicia la ejecucin del programa desde el principio

SintaxisAccSet[ Acc ':=' ] < expression (IN) of num > ','[ Ramp ':=' ] < expression (IN) of num > ';'

Informacin relacionada

ConsultePara obtener ms informacin sobre

WorldAccLim - Control de aceleracin en el siste-ma de coordenadas mundo en la pgina 755

Control de aceleracin en el sistema decoordenadas mundo

PathAccLim - Reduce la aceleracin del TCP a lolargo de la trayectoria en la pgina 312

Reduccin de la aceleracin del TCP alo largo de la trayectoria

Technical reference manual - RAPID overviewInstrucciones de posicionamiento


1 Instrucciones

1.1 AccSet - Reduce la aceleracin

Continuacin

1.2 ActUnit - Activa una unidad mecnica

UtilizacinActUnit se utiliza para activar una unidad mecnica.

Puede usarse para determinar qu unidad debe estar activa, por ejemplo cuandose utilizan unidades de accionamiento comunes.

Esta instruccin slo puede usarse en la tarea principal T_ROB1 o, si se cuentacon un sistema MultiMove, en las tareas de movimiento.

Ejemplos bsicosA continuacin aparece un ejemplo bsico de la instruccin ActUnit.

Ejemplo 1ActUnit orbit_a;

Activacin de la unidad mecnica orbit_a.

ArgumentosActUnit MechUnit

MechUnitMechanical Unit

Tipo de dato: mecunit

El nombre de la unidad mecnica que debe activarse.

Ejecucin de programasCuando la trayectoria del robot y de los ejes externos ha sido completada, latrayectoria del nivel de trayectoria actual se borra y se activa la unidad mecnicaespecificada. Esto significa que es controlada y monitorizada por el robot.

Si varias unidades mecnicas comparten una misma unidad de accionamiento, laactivacin de una de estas unidades mecnicas tambin conecta la unidad a launidad de accionamiento comn.

LimitacionesSi esta instruccin va precedida de una instruccin de movimiento, sta ltimadebe programarse con un punto de paro (zonedata fine), no un punto de paso.De lo contrario, no ser posible reanudar la ejecucin tras una cada de suministroelctrico.

ActUnit no puede ejecutarse en rutinas de RAPID que estn conectadas a lossiguientes eventos especiales del sistema: PowerOn, Stop, QStop, Restart, Reset.oStep.

Es posible usar ActUnit - DeactUnit en el nivel StorePath, pero al ejecutarRestoPath deben estar activadas las mismas unidades mecnicas al ejecutarStorePath. Esta operacin en la grabadora de trayectorias y la trayectoria delnivel bsico estarn intactas, pero la trayectoria del nivel StorePath se borrar.



1 Instrucciones


SintaxisActUnit[MechUnit ':=' ] < variable (VAR) of mecunit> ';'


ConsultePara obtener ms informacinsobre

DeactUnit - Desactiva una unidad mecnica en la pgi-na 83

Desactivacin de unidades mec-nicas

mecunit - Unidad mecnica en la pgina 1227Unidades mecnicas

DeactUnit - Desactiva una unidad mecnica en la pgi-na 83

Ms ejemplos

PathRecMoveBwd - Hace retroceder la grabadora detrayectorias en la pgina 316

Grabadora de trayectorias


1 Instrucciones


Continuacin

1.3 Add - Suma un valor numrico

UtilizacinAdd se utiliza para sumar o restar un valor a o de una variable o una variablepersistente de tipo numrico.

Ejemplos bsicosA continuacin aparecen algunos ejemplos bsicos de la instruccin Add.

Ejemplo 1Add reg1, 3;

3 se suma areg1, es decir reg1:=reg1+3.

Ejemplo 2Add reg1, -reg2;

El valor de reg2 se resta de reg1, i.e. reg1:=reg1-reg2.

Ejemplo 3VAR dnum mydnum:=5;Add mydnum, 500000000;

500000000 se suma a mydnum, es decir mynum:=mynum+500000000.

Ejemplo 4VAR dnum mydnum:=5000;VAR num mynum:=6000;Add mynum, DnumToNum(mydnum \Integer);

5000 se suma amynum, es decir mynum:=mynum+5000. Debe usar DnumToNumpara obtener un valor numrico num que puede usar junto con la variable nummynum.

ArgumentosAdd Name | Dname AddValue | AddDvalue

Name

Tipo de dato: num

El nombre de la variable o de la variable persistente que se desea cambiar.

Dname

Tipo de dato: dnum

El nombre de la variable o de la variable persistente que se desea cambiar.

AddValueTipo de dato: num

El valor a sumar.

AddDvalueTipo de dato: dnum

El valor a sumar.



1 Instrucciones


LimitacionesSi el valor aadir es del tipo dnum y la variable/persistente que debe cambiarse esde tipo num, se generar un error de tiempo de ejecucin. La combinacin deargumentos no es posible (consulte el Ejemplo 4 anterior acerca de cmo resolveresto).

SintaxisAdd[ Name ':=' ] < var or pers (INOUT) of num >| [ Dname := ] < var or pers (INOUT) of dnum > ,[ AddValue ':=' ] < expression (IN) of num >| [ AddDvalue := ] < expression (IN) of dnum > ;



Incr - Aumenta en 1 un valor en la pgina 137Incremento de una variable en 1

Decr - Reduce un nmero en 1 en la pgina 85Decremento de una variable en 1

":=" - Asigna un valor en la pgina 26Cambio de un dato mediante una expre-sin arbitraria, por ejemplo una multiplica-cin


1 Instrucciones


Continuacin

1.4 AliasIO - Define una seal de E/S con un nombre de alias

UtilizacinAliasIO se utiliza para definir una seal de cualquier tipo con un nombre de aliaso para usar seales en los mdulos de tarea incorporados.

Las seales con nombres de alias pueden usarse en los programas genricospredefinidos, sin ninguna modificacin del programa antes de ejecutarlo en distintasinstalaciones de robot.

Es necesario ejecutar la instruccin AliasIO antes de cualquier uso de la sealen s. Consulte Ejemplos bsicos en la pgina 23 para los mdulos cargados yMs ejemplos en la pgina 24 para los mdulos instalados.

Ejemplos bsicosA continuacin aparece un ejemplo bsico de la instruccin AliasIO.

Consulte tambin Ms ejemplos en la pgina 24.

Ejemplo 1VAR signaldo alias_do;PROC prog_start()AliasIO config_do, alias_do;

ENDPROC

La rutina prog_start est conectada al evento START en los parmetros delsistema. La seal digital de salida definida por el programa alias_do estconectada a la seal digital de salida configurada config_do en el momento delinicio del programa.

ArgumentosAliasIO FromSignal ToSignal

FromSignalTipo de dato: signalxx o string

Mdulos cargados:

El identificador de la seal, con un nombre que se corresponde con la configuracin(tipo de dato signalxx) de la que se copia el descriptor de la seal. La seal debeestar definida en la configuracin de E/S.

Mdulos instalados o mdulos cargados:

Una referencia (CONST, VAR o un parmetro de este tipo) que contenga el nombrede la seal (tipo de dato string) de la que se copia el descriptor de la seal trasbuscarlo en el sistema. La seal debe estar definida en la configuracin de E/S.

ToSignalTipo de dato: signalxx

El identificador de la seal de acuerdo con el programa (tipo de dato signalxx)del que se copia el descriptor de la seal. La seal debe estar declarada en elprograma de RAPID.



1 Instrucciones


Debe usarse (o buscarse) el mismo tipo de datos para los argumentos FromSignaly ToSignal y debe ser uno de los tipos signalxx (signalai, signalao,signaldi, signaldo, signalgi o signalgo).

Ejecucin de programasEl valor del descriptor de la seal se copia de la seal indicada en el argumentoFromSignal a la seal indicada en el argumento ToSignal.

Gestin de erroresPueden generarse los errores recuperables siguientes. Los errores pueden sergestionados en un gestor de errores. La variable de sistema ERRNO cambia a:

La seal FromSignal no est definida en la configuracinde E/S

ERR_ALIASIO_DEF

O la seal ToSignal no est declarada en el programa deRAPIDO la seal ToSignal est definida en la configuracin deE/S.

Los tipos de datos de los argumentos FromSignal y ToSig-nal no son del mismo tipo.

ERR_ALIASIO_TYPE

Ms ejemplosA continuacin aparecen ms ejemplos de la instruccin AliasIO.

Ejemplo 1VAR signaldi alias_di;PROC prog_start()CONST string config_string := "config_di";AliasIO config_string, alias_di;

ENDPROC

La rutina prog_start se conecta al evento START en los parmetros del sistema.La seal digital de entrada definida por el programa alias_di es conectada a laseal digital de entrada configurada config_di (a travs de la constanteconfig_string) en el momento del inicio del programa.

LimitacinAl iniciar el programa, no es posible utilizar la seal de alias hasta ejecutar lainstruccin AliasIO.

La instruccin AliasIOdebe estar situada en uno de los lugares siguientes:

En la rutina de evento ejecutada al iniciar el programa (evento START)

O bien en la parte del programa que se ejecuta despus de cada inicio delprograma (antes de usar la seal).

Para evitar errores, no se recomienda utilizar la reconexin dinmica de una sealAliasIO a varias seales fsicas diferentes.

SintaxisAliasIO[ FromSignal ':=' ] < reference (REF) of anytype> ','[ ToSignal ':=' ] < variable (VAR) of anytype> ';'

Contina en la pgina siguiente24 3HAC16581-5 Revisin: L


1 Instrucciones


Continuacin


ConsultePara obtener ms informacin so-bre

Technical reference manual - RAPID overviewInstrucciones de entrada/salida

Technical reference manual - RAPID overviewFuncionalidad de entrada/salida engeneral

Manual de referencia tcnica - Parmetros del sistemaConfiguracin de E/S

Manual de referencia tcnica - Parmetros del sistemaDefinicin de rutinas de evento

Manual de referencia tcnica - Parmetros del sistemaMdulos de tarea cargados o insta-lados


1 Instrucciones


Continuacin

1.5 ":=" - Asigna un valor

UtilizacinLa instruccin ":="se utiliza para asignar un nuevo valor a un dato. Este valorpuede ser desde un valor constante hasta una expresin aritmtica, por ejemploreg1+5*reg3.

Ejemplos bsicosA continuacin aparecen algunos ejemplos bsicos de la instruccin ":=".


Ejemplo 1reg1 := 5;

reg1 recibe el valor 5.

Ejemplo 2reg1 := reg2 - reg3;

Se asigna a reg1 el valor que devuelve el clculo reg2-reg3.

Ejemplo 3counter := counter + 1;

counter aumenta en 1.

ArgumentosData := Value

Data

Tipo de dato: All

El dato al que se desea asignar un nuevo valor.

ValueTipo de dato: Same as Data

El valor deseado.

Ms ejemplosA continuacin aparecen ms ejemplos de la instruccin ":=".

Ejemplo 1tool1.tframe.trans.x := tool1.tframe.trans.x + 20;

El TCP de tool1 se desplaza 20 mm en la direccin X.

Ejemplo 2pallet{5,8} := Abs(value);

Se asigna a un elemento de la matriz pallet un valor igual al valor absoluto dela variable value.

LimitacionesEl dato (cuyo valor se desea cambiar) no debe ser ninguno de los siguientes:

Una constante



1 Instrucciones


Un tipo de dato sin valor

El dato y el valor deben tener tipos de dato similares (el mismo tipo o el mismoalias).

Sintaxis(EBNF) ':=' ';' ::=

| | |


ConsultePara obtenerms informacin sobre

Technical reference manual - RAPID overviewExpresiones

Technical reference manual - RAPID overviewTipos de datos sin valor

Manual del operador - IRC5 con FlexPendantAsignacin de un valor inicial a undato


1 Instrucciones


Continuacin

1.6 BitClear - Desactiva un bit especfico de un dato de byte

UtilizacinBitClear se utiliza para desactivar (poner a 0) un bit especificado de un dato debyte definido.

Ejemplos bsicosA continuacin aparece un ejemplo bsico de la instruccin BitClear.

Ejemplo 1CONST num parity_bit := 8;VAR byte data1 := 130;BitClear data1, parity_bit;

El bit nmero 8 (parity_bit) de la variable data1 cambia a 0, con lo que el contenidode la variable data1 cambia de 130 a 2 (en su valor decimal). La manipulacin debits de un dato de tipo byte al utilizar BitClear se muestra en la figura siguiente.

1 0 0 0 0 0 1 0 0 0 0 0 0 0 1 0

BitP

os 8

BitP

os 1

BitP

os 8

BitP

os 1

VAR byte data1 := 130;

BitClear data1, parity_bit;

El valor de la posicin de bit 8 cambia a 0.La posicin de bit 8 tiene el valor 1.

Contenido de data1 antes de BitClear... : 130 Contenido de data1 despus de BitClear... : 2

xx0500002147_es

ArgumentosBitClear BitData BitPos

BitDataTipo de dato: byte

Los datos de bits a cambiar, en representacin entera.

BitPosBit Position

Tipo de dato: num

El valor de la posicin de bit (de 1 a 8) de BitData que se desea cambiar a 0.

LimitacionesEl rango de los tipos de datos byte es de 0 a 255 en decimal.

Las posiciones de bit vlidas son de la 1 a la 8.



1 Instrucciones


SintaxisBitClear[ BitData ':=' ] < var or pers (INOUT) of byte > ','[ BitPos ':=' ] < expression (IN) of num > ';'



BitSet - Activa un bit especfico de un dato debyte en la pgina 30

Activacin de un bit especfico de un datode byte

BitCheck - Comprueba si un bit especificado deun dato de byte est activado en la pgina 825

Comprobacin de si un bit especfico deun dato de byte est activado

Manual de referencia tcnica - Descripcin ge-neral de RAPID

Otras funciones de bits


1 Instrucciones


Continuacin

1.7 BitSet - Activa un bit especfico de un dato de byte

UtilizacinBitSet se utiliza para cambiar a 1 un bit especificado dentro de un dato de bytedefinido.

Ejemplos bsicosA continuacin aparece un ejemplo bsico de la instruccin BitSet.

Ejemplo 1CONST num parity_bit := 8;VAR byte data1 := 2;BitSet data1, parity_bit;

El bit nmero 8 (parity_bit) de la variable data1 cambia a 1, es decir, elcontenido de la variable data1 cambia de 2 a 130 (en su representacin entera).La manipulacin de bits de un dato de tipo byte al utilizar BitSet se muestra enla figura siguiente.

0 0 0 0 0 0 1 0 1 0 0 0 0 0 1 0

BitP

os 8

BitP

os 1

BitP

os 8

BitP

os 1VAR byte data1 := 2;

BitSet data1, parity_bit;

El valor de la posicin de bit 8 cambia a 1.La posicin de bit 8 tiene el valor 0.

Contenido de data1 antes de BitSet... : 2 Contenido de data1 despus de BitSet... : 130

xx0500002148_es

ArgumentosBitSet BitData BitPos

BitDataTipo de dato: byte

Los datos de bits a cambiar, en representacin entera.

BitPosBit Position

Tipo de dato: num

El valor de la posicin de bit (de 1 a 8) de BitData que se desea cambiar a 1.

LimitacionesEl rango de los tipos de datos byte es de 0 a 255 en su representacin de nmeroentero.

Las posiciones de bit vlidas son de la 1 a la 8.



1 Instrucciones


SintaxisBitSet[ BitData':=' ] < var or pers (INOUT) of byte > ','[ BitPos':=' ] < expression (IN) of num > ';'



BitClear - Desactiva un bit especfico de undato de byte en la pgina 28

Desactivacin de un bit especfico de un datode byte

BitCheck - Comprueba si un bit especificadode un dato de byte est activado en la pgi-na 825

Comprobacin de si un bit especfico de undato de byte est activado

Technical reference manual - RAPID over-view

Otras funciones de bits


1 Instrucciones


Continuacin

1.8 BookErrNo - Registra un nmero de error de sistema de RAPID

UtilizacinBookErrNose utiliza para registrar un nuevo nmero de error de sistema de RAPID.

Ejemplos bsicosA continuacin aparece un ejemplo bsico de la instruccin BookErrNo.

Ejemplo 1! Introduce a new error number in a glue system! Note: The new error variable must be declared with the initial

value -1VAR errnum ERR_GLUEFLOW := -1;

! Book the new RAPID system error numberBookErrNo ERR_GLUEFLOW;

La variable ERR_GLUEFLOW se asignar a un nmero de error de sistema que estlibre en el cdigo de RAPID.

! Use the new error numberIF di1 = 0 THENRAISE ERR_GLUEFLOW;

ELSE...

ENDIF

! Error handlingERRORIF ERRNO = ERR_GLUEFLOW THEN...

ELSE...

ENDIF

Si la entrada digital di1 contiene 0, el nuevo nmero de error registrado serelevado y la variable de error de sistema ERRNO cambiar al nuevo nmero deerror registrado. De esta forma, el manejo de errores de los errores generados porel usuario puede realizarse con el gestor de errores, de la forma habitual.

ArgumentosBookErrNo ErrorName

ErrorName

Tipo de dato: errnum

El nombre de la variable del nuevo nmero de error de sistema de RAPID.

LimitacionesLa variable del nuevo error no debe estar declarada como una variable de rutina.

La variable del nuevo error debe estar declarada con un valor inicial de -1, lo queindica que este error debe ser un error de sistema de RAPID.



1 Instrucciones


SintaxisBookErrNo[ ErrorName ':='] < variable (VAR) of errnum > ';'



Technical reference manual - RAPID overviewGestin de errores

errnum - Nmero de error en la pgina 1194Nmero de error

RAISE - Llama a un gestor de errores en la pgi-na 355

Llamada a un gestor de errores


1 Instrucciones


Continuacin

1.9 Break - Interrumpe la ejecucin del programa

UtilizacinBreak se utiliza para provocar la interrupcin inmediata de la ejecucin de unprograma con fines de depuracin del cdigo de un programa de RAPID. Elmovimiento del robot se detiene.

Ejemplos bsicosA continuacin aparece un ejemplo bsico de la instruccin Break.

Ejemplo 1...

Break;...

La ejecucin del programa se detiene y es posible analizar variables, valores, etc.con fines de depuracin.

Ejecucin de programasLa instruccin detiene inmediatamente la ejecucin del programa, sin esperar aque los ejes del robot o los ejes externos alcancen sus puntos de destinoprogramados para el movimiento que se est realizando. Posteriormente es posiblereanudar la ejecucin del programa a partir de la instruccin siguiente.

Si hay una instruccin Break en alguna rutina de evento, la ejecucin de la rutinase interrumpir y no se ejecutar ninguna rutina de evento STOP. La rutina deevento se ejecutar desde el principio la prxima vez que tenga lugar el mismoevento.

SintaxisBreak';'



Stop - Detiene la ejecucin del programa en la p-gina 543

Paro para acciones de programa

EXIT - Finaliza la ejecucin del programa en lapgina 109

Paro despus de un error no recupera-ble

EXIT - Finaliza la ejecucin del programa en lapgina 109

Finalizacin de la ejecucin del progra-ma

StopMove - Detiene el movimiento del robot en lapgina 548

Paro de los movimientos del robot ni-camente


1 Instrucciones

1.9 Break - Interrumpe la ejecucin del programa

1.10 CallByVar - Llama a un procedimiento mediante una variable

UtilizacinCallByVar (Call By Variable) puede usarse para llamar a procedimientos quetienen nombres especficos, como proc_name1, proc_name2, proc_name3... proc_namex a travs de una variable.

Ejemplos bsicosA continuacin aparece un ejemplo bsico de la instruccin CallByVar.


Ejemplo 1reg1 := 2;CallByVar "proc", reg1;

Se llama al procedimiento proc2.

ArgumentosCallByVar Name Number

Name

Tipo de dato: string

La primera parte del nombre del procedimiento, por ejemplo proc_name.

NumberTipo de dato: num

El valor numrico del nmero del procedimiento. Este valor se convierte en unacadena y constituye la segunda parte del nombre del procedimiento, por ejemplo1. El valor debe ser nmero entero positivo.

Ms ejemplosMs ejemplos sobre cmo hacer selecciones estticas y dinmicas de llamadasa procedimiento.

Ejemplo 1: Seleccin esttica de llamadas a procedimientosTEST reg1CASE 1:lf_door door_loc;

CASE 2:rf_door door_loc;

CASE 3:lr_door door_loc;

CASE 4:rr_door door_loc;

DEFAULT:

EXIT;

ENDTEST

En funcin de si el valor del registro reg1 es 1, 2, 3 4, se llama a procedimientosdistintos que realizan el tipo adecuado de trabajo para la puerta seleccionada. Laubicacin de la puerta se indica en el argumento door_loc.



1 Instrucciones


Ejemplo 2: Seleccin dinmica de llamadas a procedimientos con sintaxis de RAPIDreg1 := 2;%"proc"+NumToStr(reg1,0)% door_loc;

Se llama al procedimiento proc2 con el argumento door_loc.

Limitacin: Todos los procedimientos deben tener un nombre especfico, comoproc1, proc2, proc3.

Ejemplo 3: Seleccin dinmica de llamadas a procedimientos con CallByVarreg1 := 2;CallByVar "proc",reg1;

Se llama al procedimiento proc2.

Limitacin: Todos los procedimientos deben tener un nombre especfico, comoproc1, proc2, proc3 y no puede usarse ningn argumento.

LimitacionesSlo puede usarse para llamar a procedimientos que no utilizan parmetros.

No puede usarse para llamar a procedimientos de tipo LOCAL.

La ejecucin de CallByVar requiere un poco ms de tiempo que la ejecucin deuna llamada normal a un procedimiento.

Gestin de erroresSi el argumento Number es < 0 o no es un entero, la variable de sistema ERRNOcambia a ERR_ARGVALERR.

Si se hace referencia a un procedimiento desconocido, la variable de sistemaERRNO cambia al valor ERR_REFUNKPRC.

En caso de un error en la llamada a un procedimiento (que no se trate de unprocedimiento), la variable de sistema ERRNO cambia a ERR_CALLPROC.

Estos errores pueden ser gestionados en el gestor de errores.

SintaxisCallByVar[Name ':='] ','[Number ':='] ';'


ConsultePara obtener ms informa-cin sobre

Technical reference manual - RAPID overviewLlamadas a procedimientosManual del operador - IRC5 con FlexPendant


1 Instrucciones


Continuacin

1.11 CancelLoad - Cancela la carga de un mdulo

UtilizacinCancelLoad puede usarse para cancelar la operacin de carga generada por lainstruccin StartLoad.

CancelLoad slo puede usarse entre instrucciones StartLoad y WaitLoad.

Ejemplos bsicosA continuacin aparece un ejemplo bsico de la instruccin CancelLoad.


Ejemplo 1CancelLoad load1;

Se cancela la sesin de carga load1.

ArgumentosCancelLoad LoadNo

LoadNoTipo de dato: loadsession

Una referencia a la sesin de carga, creada por la instruccin StartLoad.

Ms ejemplosA continuacin aparecen ms ejemplos de cmo usar la instruccin CancelLoad.

Ejemplo 1VAR loadsession load1;

StartLoad "HOME:"\File:="PART_B.MOD",load1;...

IF ...

CancelLoad load1;StartLoad "HOME:"\File:="PART_C.MOD",load1;

ENDIF

...

WaitLoad load1;

La instruccin CancelLoad cancela la carga en curso del mdulo PART_B.MOD ypermite cargar en su lugar el mdulo PART_C.MOD.

Gestin de erroresSi la v

Documents

02 Instrucciones Funciones Tipos de Datos RAPID