STK (Start Kit DARUMA) Utilizando DarumaFramework.dll para conexão GPRS com o Modem

Transcrição

1 STK (Start Kit DARUMA) Utilizando DarumaFramework.dll para conexão GPRS com o Modem Conexão GPRS é um serviço disponibilizado pelas operadoras de telefonia móvel, que possibilita a troca de dados e também acesso à internet. A conexão feita neste STK foi entre dois Modens, ambos utilizando chip de dados da TIM. Este STK divide-se em 7 partes: 1. Configuração da APN, Usuário e Senha 2. Efetuando configuração Servidor (Modem 1) 3. Obtendo Status da Conexão 4. Obtendo o IP da conexão GPRS 5. Efetuando configuração Cliente (Modem 2) 6. Enviando e Recebendo dados 7. Fechar conexão Obs: As passos 3 e 4 poderão ser feitos em ambos os Modens. 1. Configuração da APN, Usuário e Senha Primeiramente precisamos informar qual a APN, Usuário e Senha que o Servidor (Modem 1) ou Cliente (Modem 2) ira utilizar. Esta configuração sempre ficará gravada no DarumaFramework.xml. Para alteramos em tempo de execução, iremos utilizar o método regalterarvalor_daruma( MODEM\Apn, <apn> ): Temos aqui as seguintes APN s que poderá utilizar: Para chip TIM: tim.br Para chip VIVO: zap.vivo.com.br" Para chip CLARO: claro.com.br Para chip OI: oi.com.br Em relação ao usuário e senha normalmente são os próprios nomes das operadoras: tim, vivo, claro, oi, entre outras. function regalterarvalor_daruma(pszpathchave:string,pszvalor:string):integer; StdCall; External 'DarumaFramework.dll'; Int_Retorno:=regAlterarValor_Daruma( MODEM\Apn, tim.br ); Int_Retorno:=regAlterarValor_Daruma( MODEM\Usuario, tim ); Int_Retorno:=regAlterarValor_Daruma( MODEM\Senha, tim ); public static extern int regalterarvalor_daruma(string pszchave, string pszvalor); Declaracoes.regAlterarValor_Daruma("MODEM\\Apn", "tim.br"); Declaracoes.regAlterarValor_Daruma("MODEM\\Usuario", "tim"); Declaracoes.regAlterarValor_Daruma("MODEM\\Senha", "tim"); 2. Efetuando configuração Servidor (Modem 1) 2.1 Para esta configuração iremos utilizar o método econfigurarservidorgprs_modem_darumaframework, onde configura o Modem para realizar conexão GPRS, preparando o mesmo para receber uma conexão assim que tiver um IP (conectado à rede).

2 function econfigurarservidorgprs_modem_darumaframework: Integer; StdCall; External 'DarumaFrameWork.dll' iretorno := econfigurarservidorgprs_modem_darumaframework(); public static extern int econfigurarservidorgprs_modem_darumaframework(); Declaracoes.iRetornoModem=Declaracoes.eConfigurarServidorGprs_MODEM_DarumaFramework(); 2.2 Logo após, vamos ativar o modem, onde já esta pré-configurado para conexão GPRS, obtendo para ele um IP, que servirá para que um outro IP (que pode ser de outro modem) se conecte a ele. A partir de sua execução o modem estará pronto para receber uma conexão GPRS. Para isso vamos utilizar a função eativarservidorgprs_modem_darumaframework. function eativarservidorgprs_modem_darumaframework: Integer; StdCall; External 'DarumaFrameWork.dll' iretorno := eativarservidorgprs_modem_darumaframework(); public static extern int eativarservidorgprs_modem_darumaframework(); Declaracoes.iRetornoModem = Declaracoes.eAtivarServidorGprs_MODEM_DarumaFramework(); 2.3 Agora com o Servidor configurado, vamos ficar em looping verificando status da conexão do modem, até que tenha outro IP conectado ao seu, no caso o Modem 2, ou enquanto não atingir o Timeout da função, que equivale a dois minutos. Após a configuração do Modem2, obtenha o IP dele com o passo 4, configure em seu DarumaFramework.xml o IpCliente e chame a função eaguardarconexaogprs_modem_darumaframework. function eaguardarconexaogprs_modem_darumaframework: Integer; StdCall; External 'DarumaFrameWork.dll' iretorno := eaguardarconexaogprs_modem_darumaframework(); public static extern int eaguardarconexaogprs_modem_darumaframework(); Declaracoes.iRetornoModem = Declaracoes.eAguardarConexaoGprs_MODEM_DarumaFramework(); 3. Obtendo Status da Conexão Para saber se a conexão foi efetuada com a rede sem problemas, deverá chamar o método robterstatusconexaogprs_modem_darumaframework. function robterstatusconexaogprs_modem_darumaframework: Integer; StdCall; External 'DarumaFrameWork.dll' iretorno := robterstatusconexaogprs_modem_darumaframework(); public static extern int robterstatusconexaogprs_modem_darumaframework(); Declaracoes.iRetornoModem=Declaracoes.rObterStatusConexaoGprs_MODEM_DarumaFramework();

3 4. Obtendo o IP da conexão GPRS Agora vamos receber o IP que o Modem obteve assim que conseguiu se conectar a rede GPRS, método utilizado robteripconexaogprs_modem_darumaframework. Método que recebe através de uma variável string por referência, o endereço de IP adquirido pelo modem que já está conectado à rede, e também já escreve este IP no arquivo XML/ Registry de acordo com o tipo de conexão que está sendo utilizada no momento (Servidor - que aguarda uma conexão, ou Cliente que solicita a conexão). function robteripconexaogprs_modem_darumaframework(pszipconexao: String): Integer; StdCall; External 'DarumaFrameWork.dll' Str_IpConexao:= StringOFChar(#0,15); iretorno := robteripconexaogprs_modem_darumaframework(str_ipconexao); public static extern int robteripconexaogprs_modem_darumaframework(stringbuilder pszipconexao); Declaracoes.iRetornoModem = Declaracoes.rObterIpConexaoGprs_MODEM_DarumaFramework(sIp); 5. Efetuando configuração Cliente (Modem 2) 5.1 Temos que definir qual será o Ip Servidor que nosso Modem 2 ira se conectar. Para fazermos isso em modo de execução vamos utilizar o método regalterarvalor_daruma( MODEM\IpServidor, <ip> ): function regalterarvalor_daruma(pszpathchave:string,pszvalor:string):integer; StdCall; External 'DarumaFramework.dll'; Int_Retorno:=regAlterarValor_Daruma( MODEM\IpServidor, ); public static extern int regalterarvalor_daruma(string pszchave, string pszvalor); Declaracoes.regAlterarValor_Daruma("MODEM\\IpServidor", " "); 5.2 Agora utilizar o método econfigurarclientegprs_modem_darumaframework, ele configura/prepara o modem para realizar uma conexão GPRS com um outro IP. Após este passo, deverá efetuar os passos 3 e 4 novamente. function econfigurarclientegprs_modem_darumaframework: Integer; StdCall; External 'DarumaFrameWork.dll' iretorno := econfigurarclientegprs_modem_darumaframework(); public static extern int econfigurarclientegprs_modem_darumaframework(); Declaracoes.iRetornoModem = Declaracoes.eConfigurarClienteGprs_MODEM_DarumaFramework(); 5.3 Terminando o processo, vamos agora realizar a conexão com o Servidor utilizando o método erealizarconexaoclientegprs_modem_darumaframework. function erealizarconexaoclientegprs_modem_darumaframework: Integer; StdCall; External 'DarumaFrameWork.dll'

4 iretorno := erealizarconexaoclientegprs_modem_darumaframework(); public static extern int erealizarconexaoclientegprs_modem_darumaframework(); Declaracoes.iRetornoModem=Declaracoes.eRealizarConexaoClienteGprs_MODEM_DarumaFramework(); 6. Enviando e Recebendo dados Agora com a conexão estabelecida, poderemos começar a enviar e receber comandos e informações entre o Servidor e Cliente. Vamos utilizar os métodos rreceberdadosgprs_modem_darumaframework e tenviardadosgprs_modem_darumaframework. function rreceberdadosgprs_modem_darumaframework(pszrespostagprs: String ): Integer; StdCall; External 'DarumaFrameWork.dll' Str_Dados := StringOFChar(#0,1000); iretorno := rreceberdadosgprs_modem_darumaframework(str_dados); MostrarRetorno_MODEM_GPRS(iRetorno); function tenviardadosgprs_modem_darumaframework(pszdados: String): Integer; StdCall; External 'DarumaFrameWork.dll' Str_Dados := InputBox('DarumaFramework', 'Texto que será enviado: ', 'Digite aqui...'); if (Str_Dados = '') then Exit else begin iretorno := tenviardadosgprs_modem_darumaframework(str_dados); MostrarRetorno_MODEM_GPRS(iRetorno); end; public static extern int rreceberdadosgprs_modem_darumaframework(stringbuilder pszrespostagprs); StringBuilder rtexto = new StringBuilder(); Declaracoes.iRetornoModem=Declaracoes.rReceberDadosGprs_MODEM_DarumaFramework(rtexto); if (Declaracoes.iRetornoModem == 1) { TB_Texto.Text = rtexto.tostring(); } else { Declaracoes.ModemRetorno(Declaracoes.iRetornoModem); } public static extern int tenviardadosgprs_modem_darumaframework(system.string pszdados); int posx = ((SystemInformation.WorkingArea.Width / 2) - 200); int posy = ((SystemInformation.WorkingArea.Height / 2) - 200); string stexto = Microsoft.VisualBasic.Interaction.InputBox("Texto que será enviado: ", "Daruma Framework", "Digite o texto..", posx, posy); Declaracoes.iRetornoModem = Declaracoes.tEnviarDadosGprs_MODEM_DarumaFramework(sTexto);

5 7. Fechar conexão Para finalizar a conexão que estiver estabelecida entre modem e a rede, utilizaremos o método efinalizarconexaogprs_modem_darumaframework. function efinalizarconexaogprs_modem_darumaframework: Integer; StdCall; External 'DarumaFrameWork.dll' iretorno := efinalizarconexaogprs_modem_darumaframework(); public static extern int efinalizarconexaogprs_modem_darumaframework(); Declaracoes.iRetornoModem = Declaracoes.eFinalizarConexaoGprs_MODEM_DarumaFramework(); APÊNDICE A RETORNOS DOS MÉTODOS Para todos os métodos citados acima, você terá uma variável para receber o retorno, retornos estes: 0: Método não executado 1: Método executado com sucesso -1: Erro de comunicação com o Modem -2: Erro de método, enviou mas não foi executado -3: TimeOut -9: Fechar a conexão atual -10: Realizar configuração do modem -11: Realizar conexão -12: Já conectado -13: Não foi possível conectar ao Servidor -14: TimeOut no aguardo de conexão -15: Sem conexão/ Serviço inexistente -20: Serviço alocado, configurado -21: Conectado à rede -22: Serviço Fechado -23: Serviço Indisponível -24: Serviço Inexistente -25: Serviço Ocupado/ Conectado

6 Para interpretar melhor este procedimento veja o Fluxograma com os métodos para conexão GPRS, onde MODEM 1 recebe a conexão e MODEM 2 é o que se conecta a um Ip. Para verificar, acesse nosso Help Online, pelo link: Framework/MODEM/Metodos_GPRS/Conexão_GPRS.htm Se tiver alguma dúvida e/ou dificuldade, entre em contato com a nossa equipe de suporte ao desenvolvedor. Telefone: Suporte ao Desenvolvedor s: desenvolvedores.suporte@daruma.com.br, suporte.desenvolvedores@daruma.com.br, suporte@daruma.com.br, ddc.suporte@daruma.com.br, suporte.alexandre@daruma.com.br, claudenir@daruma.com.br Skypes: desenvolvedores_suporte_daruma,suporte_desenvolvedores_daruma,ddc_suporte_daruma,suporte_daruma, suporte_alexandre_daruma, claudenir_andrade