frente

Terminais Sem Fios X64


Relógio Ponto



Funções do Relógio de Ponto



Parametros globais a todas as funções:
RelogioId:
 Nome do relogio para onde se quer enviar uma mensagem.


int __stdcall InitializeComm(int ComPort,int BaudRate);

descrição:

Inicializa a porta série.

parametros:

ComPort
Porta série
BaudRate
BaudRate
int __stdcall InitializeCommWithoutError(int ComPort,int BaudRate);

descrição:

Inicializa a porta série. Não retorna erro se o relógio não se encontar presente.

parametros:

ComPort
Porta série
BaudRate
BaudRate

int __stdcall Reset_Message(char *RelogioId);

descrição:

Inicializa as comunicações com o relógio. Obrigatório usar esta função. Permite verificar se o relógio se encontra presente.
void __stdcall TerminateComm(int ComPort)

descrição:

Termina as comunicações.

parametros:

ComPort
Porta série

int __stdcall W_SendConfigurations(char *RelogioId, int IntervaloMarcacoes,int TempoDisplay
                                 ,int FechoDia,int FormatoHora,int SerieCartoes,int MaximoTrabalho,
                                 int tick,int portarele1,int portarele2);

descrição:

Permite enviar as configurações gerais para o relogio de ponto.

parametros:

IntervaloMarcações:
Tempo minimo para que o relogio aceite 2 marcações desse cartão.
TempoDisplay:
Tempo em que a mensagem fica no display.
FechoDia:
Horas a partir da qual o relogio assume que toda a gente foi para casa.
FormatoHora:
12 / 24 Horas
SerieCartoes:
Valor que o relogio subtrai, antes de validar um cartão. Exemplo se a serie for 8000 o cartão 8001 deverá corresponder ao funcionário 1.
MaximoTrabalho:
Valor a partir do qual o relogio assume que um funcionário foi embora e se esqueceu de marcar o ponto.
tich:
O relogio irá fazer tic-tac... se esta opção estiver a 1.
portarele1:

portarele2:


int __stdcall W_SendMessage(char *RelogioId,int funcionário,char *text,int tipo);

descrição:

Envia mensagem para o relogio. Esta mensagem vai ser mostrada ao funcionario correspondente.

parametros:

funcionário:
Numero do funcionário ao qual a mensagem deverá ser entregue.
text:
Conteudo da mensagem.
tipo:
Entrada, Saida ou ambos.


int __stdcall W_ShowMessage(char *RelogioId,int size,char *text);

descrição:

Diferente da função SendMessage, porque mostra imediatamente a mensagem no display.

parametros:

size:
Tamanho do texto
text:
Texto


int __stdcall RIOCOM_AutoAdjustSeconds();

Chamando esta função no inicio do programa evita ter que se acertar as horas. Elas serão automaticamente acertadas em todas as comunicações.

int __stdcall W_AdjustSeconds(unsigned char *RelogioId,int segundos);

descrição:
Com esta função é possivel calibrar o relógio.
Com este ajuste o relógio passa a usar o valor calculado para corrigir pequenos desacertos.
Deve-se usar a função W_SendSeconds, e alguns dias depois esta função.

parametros:

segundos:
 Data+Horas em segundos.

int __stdcall W_SendSeconds(unsigned char *RelogioId,int segundos);

descrição:

Acerta as horas do relogio com o valor em segundos. Numero de segundos passados desde 1/1/1996.
Formula em VB:
((Date - 35065)+time)*24*60*60.

parametros:

segundos:
Data+Horas em segundos.

int __stdcall W_ReadSeconds(char *RelogioId);

descrição:

Retorna as horas do relogio em segundos.


int __stdcall W_ReadPointers(char *RelogioId,int ptr1,int ptr2,int ptr3);

descrição:

Ponteiros para o inicio das marcações, para o fim e para a ultima marcação lida.

parametros:

ptr1
Ultimo ponteiro valido
ptr2
Primeiro ponteiro valido
ptr3
Ultimo ponteiro lido


int __stdcall W_InsertEvent(char *RelogioId,int Index,int Segundos,int periodo,int repeticao,int funcao,
                          int segundos_de_toque,int dias_da_semana);

descrição:
Permite inserir um novo evento no relógio.
Os eventos podem ser:
Alarmes, melodias.
Alteração da hora, Verão Inverno.


parametros:

index
Posição do evento na memoria do relogio. Pode-se ter 30 eventos.
Segundos
Altura em que o evento é para ser executado. A formula para os segundos é igual ao W_SendSeconds.
periodo
De quanto em quanto tempo deve ser repetido.
repeticao
Quantas vezes deve ser repetido este evento.
funcao
3 -> Adianta 3600 segundos
4 -> Atrasa 3600 segundos
5 -> Liga relé 0
6 -> Desliga relé 0
11 -> Liga relé 1
12 -> Desliga relé 1
17 -> Toca melodia (segundos de toque) relé 1
18 -> Toca melodia (segundos de toque) relé 2

segundos_de_toque
Representação em binario da melodia. Exemplo:
10110 -> 21, 1 segundo de silencio , 2 segundos de toque, 1 segundo de silencio, 1 segundo de toque.

dias da semana
Representação em binário dos dias da semana em que este evento é valido.
1 Segunda, 2 Terça, 4 Quarta...64 Domingo.

int __stdcall W_LoadData(char *RelogioId,int Index,int size);

descrição:

Permite ler dados da memoria do relogio, se se quiser usar esta como memoria auxiliar do programa

int __stdcall W_SaveData(char *RelogioId,int Index,char *data,int DataSize);

descrição:

Permite gravar dados para a  memoria do relogio, se se quiser usar esta como memoria auxiliar do programa.

int __stdcall W_SendReaderPointer(char *RelogioId,int Ptr3);

descrição:

Força o relogio a enviar para o PC todos os registo a partir do ponteiro Ptr3.

int __stdcall W_SendAllPointers(char *RelogioId,int Pt1,int Pt2,int Pt3);

descrição:

Permite alterar os ponteiros do relógio. Usar com cuidado.

parametros:

ptr1
Ultimo ponteiro valido
ptr2
Primeiro ponteiro valido
ptr3
Ultimo ponteiro lido
int __stdcall W_InsertEntry(char *RelogioId,int Index,int segundos,int funcionário,int aux1,
                          int aux2,int presente);

descrição:

Permite introduzir uma marcação na memoria do relogio.

parametros:

Index
Posição no relógio.
Segundos
Hora a que a marcação foi executada.
funcionário
Numero do funcionário.
aux1
Marcação automática ou manual
aux2

presente
Estado actual deste funcionário.



int __stdcall W_ChangeEntry(char *RelogioId,int Index,int segundos,int funcionário,int aux1,
                          int aux2,int presente);

descrição:

Permite alterar uma marcação na memoria do relogio.


int __stdcall W_DeleteEntry(char *RelogioId,int Index);

descrição:

Apaga marcação.


int __stdcall W_SendEmployerName(char *RelogioId,int cartao,char *txt,int numero,int flags);

descrição:

Permite enviar o nome dos funcionários para o Relogio.

parametros:

cartão
Numero do cartão
txt
Nome do funcionário
numero
Numero para inserção manual
flags
255 ( não usada )


int __stdcall W_ClearEmployerName(char *RelogioId,int cartao);

descrição:

Apaga um funcionário


int __stdcall W_SendJustifications(char *RelogioId,char *txt);

descrição:

Lista das justificações.

parametros:

int __stdcall W_ChangeState(char *RelogioId,int cartao,char *Estado);

descrição:

Permite alterar o estado de um cartão.


int __stdcall W_ReceiveEntry_OR(char *RelogioId,int *index,int *segundos,int *funcionário,char *aux1, char *aux2,char *presente,int *ORn,int *codigo);

descrição:

Permite ler as marcações do relógio.

parametros:

index
Numero sequencial da marcação em memoria. Equivalente ao Ptr3.
segundos
Altura em que a marcação aconteceu.
funcionário
Numero do funcionário.
aux1
'A' ( 65 )  Marcação automática, 0 Marcação normal.
aux2
Nº da justificação.
presente
0 Saida, 1 Entrada.
ORn
Numero da Or.
codigo
Codigo.



int __stdcall W_ReceiveEntry(char *RelogioId,int *index,int *segundos,int *funcionário,char *aux1,
                           char *aux2,char *presente);

descrição:

Permite ler as marcações do relógio.

parametros:

index
Numero sequencial da marcação em memoria. Equivalente ao Ptr3.
segundos
Altura em que a marcação aconteceu.
funcionário
Numero do funcionário.
aux1
'A' ( 65 )  Marcação automática, 0 Marcação normal.
aux2
Nº da justificação.
presente
0 Saida, 1 Entrada.
ORn
Numero da Or.
codigo
 Codigo.


int __stdcall W_Kill(char *RelogioId);


------------------------------------------------------



------------------------------------------------------------------------------------------------------------------
Declarações em VB

Public Declare Function InitializeComm Lib "RioCom" (ByVal Comport As Long, ByVal BaudRate As Long) As Long
Public Declare Function TerminateComm Lib "RioCom" (ByVal Comport As Long) As Long
Public Declare Function Reset_Message Lib "RioCom" (ByVal RelogioId As String) As Long
Public Declare Function InitializeCommWithoutOpen Lib "RioCom" (ByVal Comport As Long) As Long
Public Declare Function InitializeCommWithoutError Lib "RioCom" (ByVal Comport As Long, ByVal BaudRate As Long) As Long


Public Declare Function W_SaveData Lib "RioCom" (ByVal RelogioId As String, ByVal Index As Long, ByVal data As String, ByVal DataSize As Long) As Long
Public Declare Function W_ReadSeconds Lib "RioCom" (ByVal RelogioId As String) As Long
Public Declare Function W_SendConfigurations Lib "RioCom" (ByVal RelogioId As String, ByVal IntervaloMarcacoes As Long, ByVal TempoDisplay As Long, _
                        ByVal FechoDia As Long, ByVal FormatoHora As Long, ByVal SerieCartoes As Long, ByVal MaximoTrabalho As Long, _
                        ByVal tick As Long, ByVal PortaRele1 As Long, ByVal PortaRele2 As Long) As Long
Public Declare Function W_SendMessage Lib "RioCom" (ByVal RelogioId As String, ByVal funcionário As Long, _
                        ByVal Texto As String, ByVal Tipo As Long) As Long
Public Declare Function W_ShowMessage Lib "RioCom" (ByVal RelogioId As String, ByVal size As Long, ByVal Texto As String) As Long
Public Declare Function W_SendSeconds Lib "RioCom" (ByVal RelogioId As String, ByVal Seconds As Long) As Long
Public Declare Function W_AdjustSeconds Lib "RioCom" (ByVal RelogioId As String, ByVal Seconds As Long) As Long
Public Declare Function W_ReadPointers Lib "RioCom" (ByVal RelogioId As String, ByRef Ptr1 As Long, Ptr2 As Long, Ptr3 As Long) As Long
Public Declare Function W_InsertEvent Lib "RioCom" (ByVal RelogioId As String, ByVal Index As Long, ByVal Segundos As Long, ByVal periodo As Long, _
                        ByVal repeticao As Long, ByVal funcao As Long, ByVal segundos_de_toque As Long, ByVal dias_da_semana As Long) As Long
Public Declare Function W_LoadData Lib "RioCom" (ByVal RelogioId As String, ByVal Index As Long, ByVal size As Long) As Long
Public Declare Function W_DeleteEntry Lib "RioCom" (ByVal RelogioId As String, ByVal Index As Long) As Long
Public Declare Function W_InsertEntry Lib "RioCom" (ByVal RelogioId As String, ByVal Index As Long, ByVal Segundos As Long, _
                        ByVal funcionário As Long, ByVal aux1 As Long, ByVal aux2 As Long, ByVal presente As Long) As Long
Public Declare Function W_SendReaderPointer Lib "RioCom" (ByVal RelogioId As String, ByVal n As Long) As Long
Public Declare Function W_SendAllPointers Lib "RioCom" (ByVal RelogioId As String, ByVal Pt1 As Long, ByVal Pt2 As Long, ByVal Pt3 As Long) As Long
Public Declare Function W_Kill Lib "RioCom" (ByVal RelogioId As String) As Long

Public Declare Function W_ChangeEntry Lib "RioCom" (ByVal RelogioId As String, ByVal Index As Long, ByVal Segundos As Long, _
                        ByVal funcionário As Long, ByVal aux1 As Long, ByVal aux2 As Long, ByVal presente As Long) As Long

Public Declare Function W_SendEmployerName Lib "RioCom" (ByVal RelogioId As String, ByVal Cartao As Long, ByVal Texto As String, _
                        ByVal numero As Long, ByVal flags As Long) As Long
                       
Public Declare Function W_ClearEmployerName Lib "RioCom" (ByVal RelogioId As String, ByVal Cartao As Long) As Long

Public Declare Function W_SendJustifications Lib "RioCom" (ByVal RelogioId As String, ByVal Texto As String) As Long

Public Declare Function W_ChangeState Lib "RioCom" (ByVal RelogioId As String, ByVal Cartao As Long, ByVal Estado As String) As Long
Public Declare Function W_ReceiveEntry Lib "RioCom" (ByVal RelogioId As String, ByRef Index As Long, ByRef Segundos As Long, _
                        ByRef funcionário As Long, ByRef aux1 As Byte, ByRef aux2 As Byte, ByRef presente As Byte, ByRef ORn As Long, _
                        ByRef codigo As Long) As Long
Public Declare Function SetPCName Lib "RioCom" (ByVal PCId As String) As Long
Public Declare Sub SetConfirmationsTimeout Lib "RioCom" (ByVal Timeout As Long, ByVal DetectDevice As Long)



Public Declare Function IO_Open Lib "RioCom" (ByVal Comport As Long, ByVal BaudRate As Long) As Long
Public Declare Function IO_Close Lib "RioCom" (ByVal Comport As Long) As Long
Public Declare Function IO_Write Lib "RioCom" (ByVal Comport As Long, ByVal NumeroBytes As Long, ByVal data As String) As Long
Public Declare Function IO_Read Lib "RioCom" (ByVal Comport As Long, ByVal NumeroBytes As Long, ByVal data As String, ByVal Timeout As Long) As Long



Página Principal


Contactos


Download


Manual de Interligação







Antena