COP (copiar)

Copia os dados binários no elemento de origem para o elemento de destino. O elemento de origem permanece inalterado.
Linguagens suportadas: Diagrama de blocos de função, diagrama de ladder, texto estruturado.
Essa instrução aplica-se aos controladores L20E, L50E e L70E.
COP
COP
Parâmetros da COP
Parâmetro
Tipo do parâmetro
Tipo de dados
Descrição
Enable
Entrada
BOOL
Habilitação do bloco de instruções. O COP é disparado em nível.
  • TRUE: Realizar cópia.
  • FALSE: O bloco de função está ocioso.
Src
Entrada
BOOL
SINT
USINT
BYTE
INT
UINT
WORD
DINT
UDINT
DWORD
REAL
TIME
DATE
STRING
LWORD
ULINT
LINT
LREAL
O elemento de origem para copiar, matriz unidimensional ou não matriz.
Se a origem for um tipo de dados de STRING, o destino deverá ser um tipo de dados STRING ou um tipo de dados USINT (UCHAR e BYTE). Se não for, uma incompatibilidade dos tipos de dados será relatada.
SrcOffset
Entrada
UINT
O parâmetro de entrada que define o ponto inicial de uma matriz unidimensional dentro dos dados de origem para iniciar o processo de cópia.
Defina o offset como 0:
  • Se não for um tipo de dados de matriz, ou
  • Para copiar desde o primeiro elemento para um tipo de dados de matriz unidimensional.
Dest
Entrada
BOOL
SINT
USINT
BYTE
INT
UINT
WORD
DINT
UDINT
DWORD
REAL
TIME
DATE
STRING
LWORD
ULINT
LINT
O elemento de destino para armazenar o valor copiado da matriz unidimensional ou do elemento de origem não matriz.
Se o destino for um tipo de dados STRING, a origem deverá ser um tipo de dados STRING ou um tipo de dados USINT (UCHAR e BYTE). Se não for, uma incompatibilidade dos tipos de dados será relatada.
DestOffset
Entrada
UINT
O parâmetro de entrada que define o ponto inicial dentro dos dados de destino para armazenar os elementos copiados.
Defina o offset como 0:
  • Se não for um tipo de dados de matriz, ou
  • Para copiar desde o primeiro elemento para um tipo de dados de matriz unidimensional.
Length
Entrada
UINT
O número de elementos de destino para copiar.
Quando o destino for um tipo de dados de STRING, ele indica o número de strings a serem copiadas.
Swap
Entrada
BOOL
A troca de bytes ocorre antes da extração e manipulação de parâmetros de 8 bits altos e baixos
  • Com a Swap habilitada, a ordem dos bytes é revertida antes que os bytes altos e baixos sejam processados. Por exemplo, um valor de 16 bits como 0x1234, com 0x12 de bytes altos e 0x34 de bytes baixos, teria sua ordem de bytes revertida para 0x3412.
  • Com a Swap desabilitada, os bytes altos e baixos permanecem na ordem original. Por exemplo, em um valor de 16 bits, como 0xABCD, em que o byte alto é 0xAB e o byte baixo é 0xCD, a ordem de bytes permanece a mesma.
Uma operação de troca não ocorrerá se:
  • O tipo de dados de origem ou de destino for uma STRING, ou
  • A origem e o destino forem dados de comprimento de 1 byte.
Sts
Saída
UINT
Status da operação de cópia. As definições para o parâmetro Sts são definidas em códigos de status COP.
ENO
Saída
BOOL
Ativa a saída.
Aplica-se apenas aos programas do diagrama de ladder.
Códigos de status COP (Sts)
Código do status COP
Descrição do status
0x00
Nenhuma ação tomada (não ativado).
0x01
Sucesso do bloco da função COP.
0x02
Destino tem bytes sobressalentes ao copiar da String.
0x03
Dados de origem estão truncados.
0x04
Comprimento da cópia é inválido.
0x05
Incompatibilidade dos tipo de dados quando há o Tipo de dados de String como origem ou destino.
0x06
Tamanho dos dados de origem é muito pequeno para copiar.
0x07
Tamanho dos dados de destino é muito pequeno para copiar.
0x08
Deslocamento dos dados de origem é inválido.
0x09
Deslocamento dos dados de destino é inválido.
0x0A
Dados são inválidos na origem ou destino.

Exemplos de COP

Exemplo de diagrama de blocos de função COP
Exemplo de diagrama de blocos de função COP
Exemplo de diagrama de ladder COP
Exemplo de diagrama de ladder COP
Exemplo de texto estruturado COP
Exemplo de texto estruturado COP
Dê sua opinião
Tem dúvidas ou comentários sobre esta documentação? Por favor, envie seu comentário aqui.
Normal