Terminais Sem Fios X64

Ligação Restaurantes

Ligação com RioCom.DLL

A DLL foi programada usando uma linguagem de 32 bits. Logo todos os argumentos do tipo int devem ser considerados inteiros de 32 bits. Linguagens que usem inteiros de 16 bits devem prototipar as funções como usando long int em vez de int.

Todas as funções descritas retornam sempre um código de erro inteiro.

0 --> OK, operação bem sucedida
1 --> NO_MESSAGE, não existem mensagens para ler do buffer)
2 --> INVALID_COM_PORT, porta série inexistente ou já utilizada por outro programa
3 --> GENERIC_ERROR, erro genérico
4 --> NO_RESPONSE, a DLL não obteve resposta da antena

int __stdcall radio_init(int com_no,int first_terminal,int last_terminal,int license_no,int protocolo_dados)

Descrição :

Esta função inicializa a antena, fazendo a detecção automática da versão e colocando-a em modo de recepção de pedidos. Esta inicialização demora cerca de 1 segundo.

Função:

int radio_init(

int com_no,

int first_terminal,

int last_terminal,

int license_no,

int protocolo_dados);

Parametros:

com_no: Número da porta COM à qual se encontra ligada a antena

(Ex. 1 para COM1)

first_terminal:1º terminal rádio que esta antena deve aceitar como válido. Os terminais só desistem de enviar uma mensagem quando recebem uma confirmação da antena. A antena só confirma mensagens que tenham o mesmo número de licença de hardware (ver license_nomais abaixo), e tenham um numero de terminal entre first_terminalelast_terminal inclusive.

last_terminal: Último terminal rádio que esta antena deve aceitar como válido (ver first_terminal)

license_no: Número de licença de hardware (programado nos terminais) que a antena deve aceitar como válido. Este valor serve para que estabelecimentos vizinhos que usem o mesmo sistema de terminais rádio possam usar um n.º de licença diferente, evitando assim conflitos entre as mensagen

protocolo_dados: 4

int __stdcall radio_close()

Descrição :

Esta função liberta a porta série e devolve a antena ao modo por defeito de modo a que esta não receba mais transmissões a partir dos terminais rádio.

Descrição :

c/PROTOCOLO_DADOS 4

int __stdcall radio_send_list4(int terminal,int pratos, int mesa,int AuxData,int Lugar1,int Lugar2,int *plus,int *qtds,unsigned char *mesa1,unsigned char *mesa2)       

Esta função só deve ser usada se se quiser ter o campo mesa com mais de 8 digitos.

Esta função envia uma mensagem para um terminal de rádio. O terminal depois de receber a mensagem entra em modo de edição. Depois de editar é enviada uma mensagem do terminal para o PC com Tipo='E'.

Plus e Qtds apontam para um array de inteiros de 32 bits.

mesa1 aponta para uma string de 13 bytes.
mesa2 aponta para uma string de 13 bytes.

int __stdcall radio_send_message(int terminal,char *msg)

Descrição :
Esta função envia uma mensagem de texto para um terminal rádio. A mensagem não deverá ocupar mais de 32 caracteres e deverá ser inteiramente composta por caracteres internacionais. Note-se que o terminal rádio só receberá a mensagem se estiver no menu principal, pelo que o envio de mensagens só deverá ser efectuado como resposta a uma acção do utilizador do terminal.

A DLL encarrega-se de tentar retransmitir mensagens não confirmadas pelo terminal. Esta retransmissão é feita a cada 5 segundos (aproximadamente). Se o terminal não receber uma mensagem em 1 hora, a DLL ignora-a. As mensagens são tratadas por ordem de chegada (FIFO). Pode-se saber se uma mensagem foi enviada ou não usando a função radio_send_message_get_status.

Parametros:

terminal: Número do terminal para o qual a mensagem deve ser enviada.
msg: Apontador para o endereço onde está a mensagem a enviar. (Muitas linguagens fazem a conversão automática de string para este apontador)

int __stdcall radio_send_big_message_auto_run_menu(int terminal,char *msg , int menuoption)

Descrição :
Esta função envia uma mensagem de texto para um terminal rádio. A mensagem não deverá ocupar mais de 64 caracteres e deverá ser inteiramente composta por caracteres internacionais. Note-se que o terminal rádio só receberá a mensagem se estiver no menu principal, pelo que o envio de mensagens só deverá ser efectuado como resposta a uma acção do utilizador do terminal.

Depois de o terminal receber esta mensagem vai automaticamente para o menu 'menuoption'

A DLL encarrega-se de tentar retransmitir mensagens não confirmadas pelo terminal. Esta retransmissão é feita a cada 5 segundos (aproximadamente). Se o terminal não receber uma mensagem em 1 hora, a DLL ignora-a. As mensagens são tratadas por ordem de chegada (FIFO). Pode-se saber se uma mensagem foi enviada ou não usando a função radio_send_message_get_status.

Parametros:

terminal: Número do terminal para o qual a mensagem deve ser enviada.
msg: Apontador para o endereço onde está a mensagem a enviar. (Muitas linguagens fazem a conversão automática de string para este apontador)
menuoption: Menu para o qual o terminal vai depois de receber uma mensagem.

int __stdcall radio_send_big_message(int terminal,char *msg )

Descrição :
Esta função envia uma mensagem de texto para um terminal rádio. A mensagem não deverá ocupar mais de 64 caracteres e deverá ser inteiramente composta por caracteres internacionais. Note-se que o terminal rádio só receberá a mensagem se estiver no menu principal, pelo que o envio de mensagens só deverá ser efectuado como resposta a uma acção do utilizador do terminal.

A DLL encarrega-se de tentar retransmitir mensagens não confirmadas pelo terminal. Esta retransmissão é feita a cada 5 segundos (aproximadamente). Se o terminal não receber uma mensagem em 1 hora , a DLL ignora-a. As mensagens são tratadas por ordem de chegada (FIFO). Pode-se saber se uma mensagem foi enviada ou não usando a função radio_send_message_get_status.

Parametros:

terminal: Número do terminal para o qual a mensagem deve ser enviada.
msg: Apontador para o endereço onde está a mensagem a enviar. (Muitas linguagens fazem a conversão automática de string para este apontador)

int __stdcall radio_send_message_auto_run_menu(int terminal,char *msg , int menuoption)

Descrição :
Esta função envia uma mensagem de texto para um terminal rádio. A mensagem não deverá ocupar mais de 32 caracteres e deverá ser inteiramente composta por caracteres internacionais. Note-se que o terminal rádio só receberá a mensagem se estiver no menu principal, pelo que o envio de mensagens só deverá ser efectuado como resposta a uma acção do utilizador do terminal.

Depois de o terminal receber esta mensagem vai automaticamente para o menu 'menuoption'

A DLL encarrega-se de tentar retransmitir mensagens não confirmadas pelo terminal. Esta retransmissão é feita a cada 5 segundos (aproximadamente). Se o terminal não receber uma mensagem em 1 hora  a DLL ignora-a. As mensagens são tratadas por ordem de chegada (FIFO). Pode-se saber se uma mensagem foi enviada ou não usando a função radio_send_message_get_status.

Parametros:

terminal: Número do terminal para o qual a mensagem deve ser enviada.
msg: Apontador para o endereço onde está a mensagem a enviar. (Muitas linguagens fazem a conversão automática de string para este apontador)
menuoption: Menu para o qual o terminal vai depois de receber uma mensagem.

int __stdcall radio_message_hardware_ABCDEF(int terminal,int valor1,int valor2,int valor3,int valor4,int valor5,int valor6)

Esta função envia uma mensagem e configura a opção A,B,C,D,E e F do terminal com o valor respectivo.

Descrição :

Esta função actualiza a imagem que a DLL tem da memória do terminal rádio apenas para uma posição. Esta actualização deve ser feita para todas as posições que serão enviadas usando a função radio_upload_entries. (ver abaixo)

Com as novas funções para enviar os plus em arvore esta função não é utilizada, ficando OBSOLETA.

Só se deve usar esta função se se quiser alterar o texto dos menus do terminal.

Função:

int radio_set_entry(

int entry_no,

char far *name);

Parametros:

entry_no: Posição a ser actualizada
name: Texto a gravar nessa posição. Este poderá ter até 16 caracteres.

int __stdcall radio_upload_entry(int first_entry,int last_entry)

Descrição :

Esta função envia todas as entradas (previamente introduzidas com radio_set_entry) para os terminais rádio. Para que os terminais recebam é preciso previamente fazer 96195 6 quando o terminal se encontra no menu principal, para colocar o terminal em modo de download. Como alternativa pode-se por o terminal em modo de download enviando uma mensagem .
Esta função não tem correção de erros. Pode acontecer que um terminal não receba todas as entradas. Para evitar que isso aconteça pode-se enviar 2 vezes.

Com as novas funções para enviar os plus em arvore esta função não é utilizada, ficando OBSOLETA.

Função:

int radio_upload_entries(

int first_entry,

int last_entry);

Parametros:

• first_entry: Primeira entrada a ser enviada
  last_entry: Última entrada a ser enviada. Para enviar todas as entradas alteradas fazer first_entry = 10 e last_entry = 3079.

Mapa das posições:

0 a 9

Reservadas

11 a 13

NAO USADO

14

"Mesa"

15

"Prato Qtd"

16

"Enviando"

17

NAO USADO

18

NAO USADO

19

"Nº Pessoas" ou "LUGAR"

20

"Outras"

21 a 27

Nome das Funções "Outras"

28 a 29

"Reservados"

30

Metodos de Pagamento

31

"Imprime s/n"

32

Prompt "?" ( Por defeito )

33 a 3071

Descritivos de artigos de 1 a 3039

3072

1 - Pedido

3073

2 - Anulação

3074

3 - Subtotal

3075

4 - Conta

3076

5 - Transferencias

3077

6 - Pagamento Parcial

3078

7 - Outros

3079

8 - Desconto

3080

1 - Comando

3081

2 - Licenca

3082

3 - Config.A

3083

4 - Config.B

3084

5 – Config.C

3085

6 - Receber PLUs

3086

7 - Apagar PLUs

3087