apostila java serial

7
getName public java.lang.String getName() Obtém o nome da porta de comunicações. Este nome deve corresponder a algo que o utilizador possa identificar, como a etiqueta no hardware. retorna:nome da porta toString public java.lang.String toString() Retorna uma representação dessa porta de comunicação. retorna: Representação de string do porto getInputStream public abstract java.io.InputStream getInputStream() Lança: java.io.IOException Retorna um fluxo de entrada. Esta é a única forma de receber dados da porta de comunicações. Se a porta é unidirecional e não suporta a recepção de dados, então getInputStream retorna nulo. O comportamento de leitura do fluxo de entrada retornado por getInputStream depende de combinação do limiar e valores de tempo limite. Os comportamentos possíveis estão descritos no quadro a seguir: Limiar Tempo limite Ler tamanho buffer ler comportamento Estado Valor Estado Valor Desabilitado - Desabilitado - n bytes Bloquear até que todos os dados estejam disponíveis. Habilitado m byte Desabilitado - n bytes Bloquear até min (m, n) bytes estejam disponíveis.

Upload: alessandro-roberto-da-silva

Post on 21-Oct-2015

13 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Apostila Java Serial

getNamepublic java.lang.String getName()Obtém o nome da porta de comunicações. Este nome deve corresponder a algo que o utilizador possa identificar, como a etiqueta no hardware.retorna:nome da porta

toStringpublic java.lang.String toString()Retorna uma representação dessa porta de comunicação.retorna:Representação de string do porto

getInputStreampublic abstract java.io.InputStream getInputStream() Lança: java.io.IOExceptionRetorna um fluxo de entrada. Esta é a única forma de receber dados da porta de comunicações. Se a porta é unidirecional e não suporta a recepção de dados, então getInputStream retorna nulo.O comportamento de leitura do fluxo de entrada retornado por getInputStream depende de combinação do limiar e valores de tempo limite. Os comportamentos possíveis estão descritos no quadro a seguir: Limiar Tempo limite Ler tamanho buffer ler comportamentoEstado Valor Estado ValorDesabilitado - Desabilitado - n bytes Bloquear até que todos os dados estejam disponíveis.Habilitado m byte Desabilitado - n bytes Bloquear até min (m,

n) bytes estejam disponíveis.

Desabilitado - Habilitado x MS n bytes Bloquear por x MS ou até que todos os dados estejam disp..

Habilitado m byte Habilitado x MS n bytes Bloco de x MS, ou até min (m, n) bytes disponíveis.

Note, no entanto, que os erros de enquadramento pode causar os limites de tempo e limite para terminar prematuramente sem levantar uma exceção.

Ativando o tempo limite ou limiar com um valor de um zero é um caso especial. Isso faz com que o subjacente driver para consultar os dados de entrada, em vez sendo orientado a eventos. Caso contrário, o comportamento é idêntico a ter tanto tempo limite e deficientes de limite.

retorna:Objeto InputStream que pode ser usado para ler a partir do porto

Lança: java.io.IOException - if an I/O error occurred

Page 2: Apostila Java Serial

getOutputStreampublic abstract java.io.OutputStream getOutputStream() Lança: java.io.IOException

Retorna um fluxo de saída. Esta é a única forma de enviar dados para a porta de comunicação. Se a porta é unidirecional e não suporta o envio de dados, então getOutputStream retorna nulo.

retorna:Objeto OutputStream que pode ser usado para escrever para o porto

Lança:java.io.IOException - if an I/O error occurred

closepublic void close()

Fecha a porta de comunicação. O aplicativo deve chamar perto quando é feito com a porta. Notificação da presente alteração de propriedade será propagado para todas as classes registados através addPortOwnershipListener.

enableReceiveThresholdpublic abstract void enableReceiveThreshold(int thresh) Lança UnsupportedCommOperationException Permite receber limiar, se esse recurso for suportado pelo driver. Quando o receber condição limite torna-se verdade, uma leitura do fluxo de entrada para esta porta vai retornar imediatamente.enableReceiveThreshold é um método consultivo que o condutor não pode implementar. Por padrão, receber limite não é habilitado.

Um aplicativo pode determinar se o driver suporta esse recurso primeiro chamando o método enableReceiveThreshold e depois chamar o método isReceiveThresholdEnabled. Se isReceiveThresholdEnabled ainda retorna falso, em seguida, receber limiar não é suportado pelo driver. Se o motorista não implementar este recurso, ele irá retornar de bloquear lê no momento apropriado.

Veja getInputStream para descrição do comportamento exato.

parâmetros:limiar - quando esta muitos bytes estão no buffer de entrada, retornar imediatamente de ler.

lança:UnsupportedCommOperationException - é lançada se limiar de recepção não é suportado pelo driver subjacente.

disableReceiveThresholdpublic abstract void disableReceiveThreshold()Desativa receber limiar.

isReceiveThresholdEnabledpublic abstract boolean isReceiveThresholdEnabled()Verifica se recebem limiar é ativado.

Page 3: Apostila Java Serial

retorna:boolean true se o driver suporta receber limiar.desde:CommAPI 1,1

getReceiveThresholdpublic abstract int getReceiveThreshold()Obtém o valor inteiro do limiar de recepção. Se o limite de recebimento é desativado ou não suportado pelo driver, em seguida, o valor retornado é sem sentido.

retorna:número de bytes para receber limiar

enableReceiveTimeoutpublic abstract void enableReceiveTimeout(int rcvTimeout) Lança: UnsupportedCommOperationExceptionPermite receber tempo limite, se esse recurso for suportado pelo driver. Quando o receber condição de tempo limite se torna verdade, uma leitura do fluxo de entrada para esta porta vai retornar imediatamente.enableReceiveTimeout é um método consultivo que o condutor não pode implementar. Por padrão, o tempo limite de recepção não está habilitado.

Um aplicativo pode determinar se o driver suporta esse recurso primeiro chamando o método enableReceiveTimeout e depois chamar o método isReceiveTimeout. Se isReceiveTimeout ainda retorna falso, então, tempo limite de recepção não é compatível com o motorista.

Veja getInputStream para descrição do comportamento exato.

parâmetros:rcvTimeout - quando este milissegundos que se passaram, retornar imediatamente de ler, independentemente de bytes no buffer de entrada.

lança:UnsupportedCommOperationException - é lançada se tempo limite de recepção não é suportado pelo driver subjacente.

disableReceiveTimeoutpublic abstract void disableReceiveTimeout()Desativa tempo limite de recepção.

isReceiveTimeoutEnabledpublic abstract boolean isReceiveTimeoutEnabled()Verifica se recebem limite é ativado.

Page 4: Apostila Java Serial

retorna:boolean true se o driver suporta receber timeout.

getReceiveTimeoutpublic abstract int getReceiveTimeout()Obtém o valor inteiro do tempo de espera receber. Se o tempo limite de recepção está desativado ou não é suportado pelo driver, em seguida, o valor retornado é sem sentido.

retorna:número de milissegundos no tempo limite de recepção

enableReceiveFramingpublic abstract void enableReceiveFraming(int framingByte)Lança: UnsupportedCommOperationExceptionPermite receber enquadramento, se esse recurso for suportado pelo driver. Quando o receber enquadrar condição se torna verdade, uma leitura do fluxo de entrada para esta porta vai retornar imediatamente.enableReceiveFraming é um método consultivo que o condutor não pode implementar. Por padrão, receber enquadramento não está habilitado.

Um aplicativo pode determinar se o driver suporta esse recurso primeiro chamando o método enableReceiveFraming e depois chamar o método isReceiveFramingEnabled. Se isReceiveFramingEnabled ainda retorna falso, em seguida, receber o enquadramento não é suportado pelo driver.

Observação: Como implementado neste método, o enquadramento não é relacionado ao nível de bits de enquadramento ao nível do hardware, e não está associada a erros de dados.

parâmetros:framingByte - este byte no fluxo de entrada indica o fim do quadro recebido. Leituras bloqueado retornará imediatamente. Apenas os 8 bits baixos framingByte são usados enquanto os superiores de 24 bits são mascarados fora. Um valor fora do intervalo de 0-255 será convertido para o valor mais baixo dos seus 8 bits.

lança:UnsupportedCommOperationException - é lançada se tempo limite de recepção não é suportado pelo driver subjacente.

disableReceiveFramingpublic abstract void disableReceiveFraming()Desativa receber enquadramento.

isReceiveFramingEnabledpublic abstract boolean isReceiveFramingEnabled()Verifica se recebem enquadramento é ativado.

retorna:boolean true se o driver suporta receber enquadramento.

getReceiveFramingBytepublic abstract int getReceiveFramingByte()

Page 5: Apostila Java Serial

Obtém o byte atual usado para receber enquadramento. Se o enquadramento de recepção está desativado ou não é suportado pelo driver, em seguida, o valor retornado é sem sentido. O valor de retorno getReceiveFramingByte é um inteiro, os 8 bits baixos do que representa o byte atual usado para receber enquadramento.Observação: Como implementado neste método, o enquadramento não é relacionado ao nível de bits de enquadramento ao nível do hardware, e não está associada a erros de dados.

retorna:byte atual inteiro usado para receber enquadramento

setInputBufferSizepublic abstract void setInputBufferSize(int size)Define o tamanho do buffer de entrada. Note que este é um aviso e disponibilidade de memória pode determinar o tamanho do buffer máximo utilizado pelo condutor.

parâmetros:tamanho - tamanho do buffer de entrada

getInputBufferSizepublic abstract int getInputBufferSize()Obtém o tamanho do buffer de entrada. Note-se que este método é consultivo e do sistema operacional subjacente pode optar por não informar o valor correto para o tamanho do buffer.

retorna:tamanho de entrada tampão atualmente em uso

setOutputBufferSizepublic abstract void setOutputBufferSize(int size)Define o tamanho do buffer de saída. Note que este é um aviso e disponibilidade de memória pode determinar o tamanho do buffer máximo utilizado pelo condutor.

parâmetros:tamanho - tamanho do buffer de saída

getOutputBufferSizepublic abstract int getOutputBufferSize()Obtém o tamanho do buffer de saída. Note-se que este método é consultivo e do sistema operacional subjacente pode optar por não informar o valor correto para o tamanho do buffer.

retorna:tamanho buffer de saída atualmente em uso