4D v14.3

SET CHANNEL

Página Inicial

 
4D v14.3
SET CHANNEL

SET CHANNEL 


 

SET CHANNEL ( porta ; configuraçao ) 
Parâmetro Tipo   Descrição
porta  Inteiro longo in Número da porta serial
configuraçao  Inteiro longo in Configuração da porta serial
SET CHANNEL ( operaçao ; documento ) 
Parâmetro Tipo   Descrição
operaçao  Inteiro longo in Operação de documento a ser realizada
documento  cadeia in Nome do documento

O comando SET CHANNEL abre uma porta serial ou um documento. Você pode abrir apenas uma porta serial ou um documento de uma vez com este comando. Para fechar uma porta serial aberta, passe SET CHANNEL (11).

Nota histórica: Este comando era originalmente o primeiro comando 4D utilizado para trabalhar com portas seriais e documentos em disquetes. Desde aquela época, novos comandos foram adicionados. Hoje, você normalmente irá trabalhar com documentos no disco usando os comandos Open documentCreate document e Append document. Com esses comandos, você pode ler e escrever caracteres para e de documentos usando SEND PACKET ou RECEIVE PACKET (estes comandos funcionam com SET CHANNEL, também). No entanto, se você quiser usar os comandos SEND VARIABLERECEIVE VARIABLESEND RECORD e RECEIVE RECORD, você deve usar SET CHANNEL para acessar o documento no disco.

A descrição de SET CHANNEL é composta de duas seções:

  • Trabalhando com portas seriais
  • Trabalhando com documentos

A primeira forma do comando SET CHANNEL abre uma porta serial, atribui o protocolo de criação e informação de outra porta. Os dados podem ser enviados com SEND PACKETSEND RECORD ou SEND VARIABLE e recebido com RECEIVE BUFFER, RECEIVE PACKETRECEIVE RECORD ou RECEIVE VARIABLE.

  • O primeiro parâmetro, porta, seleciona a porta e o protocolo. Você pode dirigir até 99 portas seriais (uma de cada vez):
Valores portaDescrição
0Porta impressora (Macintosh) ou COM2 (PC) sem protocolo
1Porta modem (Macintosh) ou COM1 (PC) sem protocolo
20Porta impressora (Macintosh) ou COM2 (PC) com protocolo de sofware tal como XON/XOFF
21Porta modem (Macintosh) ou COM1 (PC) com protocolo de sofware tal como XON/XOFF
30Porta impressora (Macintosh) ou COM2 (PC) com protocolo de hardware tal como RTS/CTS
31Porta modem (Macintosh) ou COM1 (PC) com protocolo de hardware tal como RTS/CTS
101 a 199Comunicação serial sem protocolo
201 a 299Comunicação serial com protocolo de software tal como XON/XOFF
301 a 399Comunicação serial com protocolo de hardware tal como RTS/CTS

Importante: O valor que você passa na porta deve se referir a uma porta serial COM já existente e reconhecida pelo sistema operacional. Por exemplo, a fim de ser capaz de usar os valores de 101, 103 e 125, as portas seriais COM1, COM3 e COM25 deve ter sido configuradas corretamente.

Uma configuração padrão do Mac OS e Windows suportam duas portas seriais: no Mac OS, a porta do modem e a porta de impressora, no Windows, as portas COM1 e COM2. No entanto, portas seriais adicionais podem ser adicionados através da utilização de placas de extensão. Originalmente, 4D só asignava duas portas seriais padrão e foi só depois que o apoio de portas adicionais foi implementado. Por razões de compatibilidade, os dois sistemas de endereçamento foram mantidos.
- Se você quiser um endereço de porta serial padrão (printer/COM2 ou modem/COM1), você pode passar no parâmetro porta os seguintes valores 0, 1, 20, 21, 30 e 31 (que correspondem a velho método de endereçamento), ou um valor maior que 100 (leia a explicação a seguir).
- Se você quer abordar portas seriais adicionais, você precisará passar o valor de N+100 (onde N é o valor da porta com o endereço). Você também pode considerar a adição de 100 ou 200 ao valor acima mencionado (N+100), se você quer selecionar, respectivamente, um software ou um protocolo de hardware.

Se você quiser usar a porta printer/COM2 sem protocolo, você pode usar uma das seguintes sintaxes:

 SET CHANNEL(0;param)

ou

 SET CHANNEL(102;param)

Se você quiser usar a porta modem/COM1 com o protocolo XON / XOFF, você pode usar uma das seguintes sintaxes:

 SET CHANNEL(21;param)

ou

 SET CHANNEL(201;param)

Se você quiser usar a porta COM 25 com o protocolo RTS / CTS, você precisa usar a seguinte sintaxe:

 SET CHANNEL(325;param)
• As configurações de parâmetros definem a velocidade, o número de bits de dados, número de stop bits e a paridade. Você determina o valor das configurações adicionando a velocidade, bits de dados, bits de parada, e os valores de paridade, conforme listado na tabela a seguir. Por exemplo, para definir 1200 baud, 8 bits de dados, 1 bit de parada e sem paridade, você poderia adicionar 94 + 3072 + 16384 + 0 = 19550. Você usaria então 19.550 como o valor do parâmetro de configuraçao.

Valor a acumular em paramDescrição
Velocidade380 300
(em baud) 189 600
941200
62 1800
46 2400
30 3600
22 4800
14 7200
10 9600
4 19200
2 28800
1 38400
0 57600
1022115200
1021230400
Bits de dados 0 5
2048 6
1024 7
3072 8
Bits de stop 16384 1
–32768 1.5
–16384 2
Paridade0 Nenhuma
4096 Ímpar
12288Par

Truque: Os diferentes valores numéricos para serem acumulados e passados na porta e configuraçao (mas não incluindo os valores para COM1 ... COM99) estão disponíveis como constantes predefinidas no tema das Comunicações dentro do ambiente de desenho. Para COM1 ...COM99 , usar literais numéricos.

A segunda forma do comando SET CHANNEL permite criar, abrir e fechar um documento. Ao contrário dos comandos de documentos do sistema, ele pode abrir apenas um documento de cada vez. O documento pode ser lido ou escrito. Consulte a seção  Documentos de Sistema para maiores informações a respeito.

O parâmetro de operaçao especifica a operação a ser realizada sobre o documento especificado por documento. A tabela a seguir lista os valores de funcionamento e à operaçao resultante, com valores diferentes para o documento. A primeira coluna apresenta os valores permitidos para a operaçao. A segunda coluna relaciona os valores permitidos para o documento. A terceira coluna lista o resultado da operação.

Por exemplo, para exibir uma caixa de diálogo Abrir arquivo para abrir um arquivo de texto, você usaria a seguinte linha:

 SET CHANNEL(13;"")


OperaçãoDocumentoResultado
10 CadeiaAbre o documento especificado pela String.
Se o documento não existir, o documento é aberto e criado.
10 "" (cadena vacía) Exibe a caixa diálogo Abrir Arquivo para abrir um arquivo.
Todos os tipos de arquivos são exibidos.
11 nenhumFecha um arquivo aberto.
12 "" (cadeia vazia) Exibe a caixa de diálogo Salvar arquivo para criar um novo arquivo.
13 "" (cadeia vazia) Exibe a caixa diálogo Abrir Arquivo para abrir um arquivo. Apenas os tipos de arquivo de texto são exibidos.

Todas as operações nesta tabela atribui a variável de sistema de documentos, se necessário. Eles também definem a variável de sistema OK para 1 se a operação foi bem sucedida. Caso contrário, a variável de sistema OK é definido como 0.

Veja os exemplos para os comandos RECEIVE BUFFERSET TIMEOUT e RECEIVE RECORD.

 
PROPRIEDADES 

Produto: 4D
Tema: Comunicações
Número 77

Este comando modifica a variável sistema OKEste comando modifica a variável sistema Document

 
HISTÓRIA 

Criado por: < 4D v6

 
VER TAMBÉM 

Append document
Comunicações
Create document
GET SERIAL PORT MAPPING
Open document
RECEIVE BUFFER
RECEIVE PACKET
RECEIVE RECORD
RECEIVE VARIABLE
SEND PACKET
SEND RECORD
SEND VARIABLE
SET TIMEOUT

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)