GT-EcoDiF – Ecossistema Web de Dispositivos
Físicos
Manual de Usuário
Autores
Paulo de Figueiredo Pires – UFRJ
Flavia Coimbra Delicato – UFRJ
Thais Vasconcelos Batista – UFRN
Bruno Carlos da Cunha Costa – UFRJ
Thomaz Avila Barros – UFRJ
Everton Ranielly de Sousa Cavalcante – UFRN
Junho de 2013
Sumário
1. Apresentação dos cenários de utilização........................................................................................ 3
2. Realização do Cenário 1: Medição e média de temperaturas .......................................................... 3
Passo 1: Cadastro do Usuário “Fabricante de Dispositivos” ................................................................ 4
Passo 2: Cadastro do dispositivo ....................................................................................................... 4
Passo 3: Cadastro do Usuário “Provedor de Dados”........................................................................... 5
Passo 4: Conexão do dispositivo ....................................................................................................... 6
Passo 5: Criação da Feed ................................................................................................................. 6
Passo 6: Cadastro do Usuário “Desenvolvedor de Aplicações” ........................................................... 8
Passo 7: Cadastro da Aplicação ........................................................................................................ 8
Passo 8: Edição da aplicação ............................................................................................................ 9
Passo 9: Execução da aplicação ..................................................................................................... 10
Passo 10: Consulta das Feeds e Aplicações pelo usuário “Consumidor de Informações” .................. 11
3. Realização do Cenário 2.............................................................................................................. 12
Passo 1: Cadastro do Usuário “Fabricante de Dispositivos” .............................................................. 12
Passo 2: Cadastro do dispositivo ..................................................................................................... 12
Passo 3: Cadastro do Usuário “Provedor de Dados”......................................................................... 13
Passo 4: Conexão do dispositivo ..................................................................................................... 14
Passo 5: Criação da Feed ............................................................................................................... 14
Passo 6: Cadastro do Usuário “Desenvolvedor de Aplicações” ......................................................... 16
Passo 7: Cadastro da Aplicação ...................................................................................................... 16
Passo 8: Edição da aplicação .......................................................................................................... 17
Passo 9: Execução da aplicação ..................................................................................................... 17
Passo 10: Consulta das Feeds e Aplicações pelo usuário “Consumidor de Informações” .................. 17
EcoDiF – Manual de Usuário.
2
1.
Apresentação dos cenários de utilização
Os cenários de utilização são possibilidades de uso do EcoDiF. Eles contemplam todas as
funcionalidades do ecossistema, oferecendo um passo a passo de uso em um ambiente real. A figura
1 apresenta as atividades básicas para a realização dos cenários.
Figura 1 Atividades básicas de utilização da EcoDiF
O primeiro cenário (C1) de utilização contempla um contexto onde existe a necessidade da
medição e cálculo da média da temperatura em um Centro de Processamento de Dados. O dispositivo
utilizado para a medição de temperatura será o Arduino UNO, utilizando um sensor LM35.
O segundo cenário (C2) abrange a necessidade de se estimar a presença de público em
determinadas áreas a fim de se deslocar recursos para determinada área bem como estimar a
presença em um evento. Nesse cenário, serão utilizados dispositivos Android.
Os dispositivos utilizados nos cenários C1 e C2 são, respectivamente, o Arduino UNO (Figura 2) e
smartphones e tablets com o sistema operacional Android 2.3.3. ou superior (Figura 3).
Figura 2 Configuração do Arduino UNO para a
Figura 3 Exemplo de dispositivo Android
realização do cenário C1
EcoDiF – Manual de Usuário.
3
2.
Realização do Cenário 1: Medição e média de temperaturas
“Em uma instituição de pesquisa existe a necessidade de medir a temperatura dos diferentes
equipamentos dentro de um Centro de Processamentos de Dados (CPD). Uma vez que os
equipamentos utilizam tecnologias proprietárias, o monitoramento da temperatura dependeria, dentre
outros, do conhecimento específico por parte dos técnicos acerca das tecnologias. Nesse contexto, foi
decidido que o monitoramento seria feito com dispositivos Arduino, localizados nas proximidades dos
equipamentos e das saídas de ar, e configurados com um sensor LM35; tendo o EcoDiF como
ambiente para controle, visualização, processamento e armazenamento das informações.”
Para a realização deste cenário, siga os passos a seguir:
Passo 1: Cadastro do Usuário “Fabricante de Dispositivos”
1. Na parte superior direita, clique na opção “Cadastre-se”.
2. Preencha o formulário com as informações solicitadas.
Figura 4 Cadastramento de usuário
3. Clique em “Cadastrar”.
Passo 2: Cadastro do dispositivo
4. No menu Console, selecione a opção Cadastrar dispositivo > Incluir.
5. Preencha o formulário com as informações solicitadas.
Figura 5 Cadastramento de dispositivo
EcoDiF – Manual de Usuário.
4
6. Clique em “Salvar”.
7. No menu Console, selecione a opção Cadastrar dispositivo > Consultar.
8. Clique na opção “Editar”.
Figura 6 Consulta de dispositivo
9. Nesta tela é exibida a opção para upload do Driver do dispositivo.
10. Preencha o formulário do Driver com as informações solicitadas.
Figura 7 Submissão do driver
11. Clique em “Salvar”.
12. Na parte superior direita, clique em Sair.
Passo 3: Cadastro do Usuário “Provedor de Dados”
13. Na parte superior direita, clique na opção “Cadastre-se”.
14. Preencha o formulário com as informações solicitadas.
Figura 8 Cadastramento de usuário
EcoDiF – Manual de Usuário.
5
15. Clique em “Cadastrar”.
Passo 4: Conexão do dispositivo
16. No menu Console, selecione a opção Dispositivo > Conectar.
17. Preencha o formulário com as informações solicitadas.
Figura 9 Conexão de dispositivo
18. Clique em “Conectar”.
19. Após a conexão do dispositivo, clique em “Download do driver” para baixar o driver de
comunicação do dispositivo com o EcoDiF.
Passo 5: Criação da Feed
20. No menu Console, selecione a opção Feeds > Cadastrar.
21. Preencha o formulário com as informações solicitadas
Figura 10 Cadastramento de feed.
22. Clique em “Salvar”.
23. Será exibida a mensagem:
EcoDiF – Manual de Usuário.
6
Figura 11 Mensagem contendo as informações do feed criado.
24. O endereço exibido deverá ser usado no driver para envio das informações a Feed
cadastrada.
25. No menu Console, selecione a opção Feeds > Listar.
26. Clique na opção “Visualizar”.
Figura 12 Visualização dos feeds cadastrados.
27. As informações dos feeds estarão disponíveis.
28. Inicie o envio das informações do driver Arduino para o “Endereço para envio”.
Figura 13 Dados do feed cadastrado.
29. Repita os passos 20 a 23 para cadastrar o outro Feed: “Temperatura CPD2” e inicie o envio
das informações.
Figura 14 Dados do segundo feed.
EcoDiF – Manual de Usuário.
7
30. Clique em “Sair”, na parte superior direita.
Passo 6: Cadastro do Usuário “Desenvolvedor de Aplicações”
31. Na parte superior direita, clique na opção “Cadastre-se”.
32. Preencha o formulário com as informações solicitadas.
Figura 15 Cadastramento de usuário.
33. Clique em “Cadastrar”.
Passo 7: Cadastro da Aplicação
34. No menu Console, selecione a opção Aplicações > Criar.
35. Preencha o formulário com as informações solicitadas.
Figura 16 Cadastramento de aplicação.
36.
37.
38.
39.
Clique em “Cadastrar aplicação”.
Clique em “Incluir feeds”.
Selecione as feeds “Temperatura - CPD1” e “Temperatura - CPD2”.
Clique em “Incluir feeds”.
EcoDiF – Manual de Usuário.
8
Figura 17 Inclusão de feeds na aplicação.
Passo 8: Edição da aplicação
40. No menu Console, selecione a opção Aplicações > Consultar.
41. Clique na opção “Visualizar Aplicação”.
Figura 18 Lista de aplicações.
42. Clique na opção “Download”, do item “Arquivo EMML associado”.
Figura 19 Dados da aplicação.
43. Altere o arquivo EMML para o cálculo da média:
...
<variables>
<variable name="feed1" type="document" />
<variable name="temp1" type="document" />
<variable name="current_value1" type="number" />
EcoDiF – Manual de Usuário.
9
<variable name="feed2" type="document" />
<variable name="temp2" type="document" />
<variable name="current_value2" type="number" />
<variable name="average" type="number" />
</variables>
<directinvoke endpoint="http://localhost:8080/EcodifAPI/api/feeds/22/datastreams/20"
method="GET" outputvariable="$feed1" />
<xslt script="eeml.xsl" inputvariable="$feed1" outputvariable="$temp1" />
<directinvoke endpoint="http://localhost:8080/EcodifAPI/api/feeds/23/datastreams/21"
method="GET" outputvariable="$feed2" />
<xslt script="eeml.xsl" inputvariable="$feed2" outputvariable="$temp2" />
<assign fromexpr="$temp1//data[@id='20']/current_value/string()"
outputvariable="$current_value1" />
<assign fromexpr="$temp2//data[@id='21']/current_value/string()"
outputvariable="$current_value2" />
<assign fromexpr="($current_value1 + $current_value2) div 2" outputvariable="$average"
/>
<assign fromvariable="$average" outputvariable="$result" />
...
44. No menu Console, selecione a opção Aplicações > Consultar.
45. Clique na opção “Editar aplicação”.
Figura 20 Lista de aplicações.
46. Clique na opção “Escolher arquivo”.
47. Localize o arquivo editado no passo 43 e clique em “Abrir”.
48. Clique em “Cadastrar aplicação”.
Passo 9: Execução da aplicação
49. No menu Console, selecione a opção Aplicações > Consultar.
50. Clique na opção “Executar”.
Figura 21 Lista de aplicações.
51. Visualize o resultado da execução da aplicação.
EcoDiF – Manual de Usuário.
10
Figura 22 Resultado da aplicação.
52. Clique em “Sair”, na parte superior direita.
Passo 10: Consulta das Feeds e Aplicações pelo usuário “Consumidor de Informações”
53. Para visualizar as Feeds cadastradas, clique na opção “Feeds” do Menu Principal.
54. Para visualizar as Aplicações cadastradas, clique na opção “Aplicações” do Menu Principal.
EcoDiF – Manual de Usuário.
11
3.
Realização do Cenário 2
“Em um evento ou ambiente a localização das pessoas pode ser interessante para o deslocamento
de recursos e ações de apoio, bem como estimação de presença. Sendo assim, a utilização da
capacidade de geolocalização de smartphones e tablets Android se torna interessante como
ferramenta de envio desses dados para a plataforma EcoDiF, que irá realizar o processamento
necessário.”
Para a realização deste cenário, siga os passos a seguir:
Passo 1: Cadastro do Usuário “Fabricante de Dispositivos”
1. Na parte superior direita, clique na opção “Cadastre-se”.
2. Preencha o formulário com as informações solicitadas.
Figura 23 Cadastramento de usuário.
3. Clique em “Cadastrar”.
Passo 2: Cadastro do dispositivo
4. No menu Console, selecione a opção Cadastrar dispositivo > Incluir.
5. Preencha o formulário com as informações solicitadas.
Figura 24 Cadastramento de dispositivo
EcoDiF – Manual de Usuário.
12
6. Clique em “Salvar”.
7. No menu Console, selecione a opção Cadastrar dispositivo > Consultar.
8. Clique na opção “Editar”.
Figura 25 Consulta de dispositivos.
9. Nesta tela é exibida a opção para upload do Driver do dispositivo.
10. Preencha o formulário do Driver com as informações solicitadas.
Figura 26 Submissão do driver.
11. Clique em “Salvar”.
12. Na parte superior direita, clique em Sair.
Passo 3: Cadastro do Usuário “Provedor de Dados”
13. Na parte superior direita, clique na opção “Cadastre-se”.
14. Preencha o formulário com as informações solicitadas.
EcoDiF – Manual de Usuário.
13
Figura 27 Cadastramento de usuário.
15. Clique em “Cadastrar”.
Passo 4: Conexão do dispositivo
16. No menu Console, selecione a opção Dispositivo > Conectar.
17. Preencha o formulário com as informações solicitadas.
Figura 28 Conexão de dispositivos
18. Clique em “Conectar”.
19. Após a conexão do dispositivo, clique em “Download do driver” para baixar o driver de
comunicação do dispositivo com o EcoDiF.
Passo 5: Criação da Feed
20. No menu Console, selecione a opção Feeds > Cadastrar.
21. Preencha o formulário com as informações solicitadas.
EcoDiF – Manual de Usuário.
14
Figura 29 Cadastramento de feed.
22. Clique em “Salvar”.
23. Será exibida a mensagem:
Figura 30 Mensagem contendo as informações do feed criado.
24. O endereço exibido deverá ser usado no driver para envio das informações a Feed
cadastrada.
25. No menu Console, selecione a opção Feeds > Listar.
26. Clique na opção “Visualizar”.
Figura 31 Lista de feeds.
27. As informações da Feed estarão disponíveis.
28. Inicie o envio das informações do driver Android para o “Endereço para envio”.
EcoDiF – Manual de Usuário.
15
29. Repita os passos 20 a 23 para cadastrar o outro Feed: “Temperatura CPD2” e inicie o envio
das informações.
30. Clique em “Sair”, na parte superior direita.
Passo 6: Cadastro do Usuário “Desenvolvedor de Aplicações”
31. Na parte superior direita, clique na opção “Cadastre-se”.
32. Preencha o formulário com as informações solicitadas.
Figura 32 Cadastramento de usuário.
33. Clique em “Cadastrar”.
Passo 7: Cadastro da Aplicação
34. No menu Console, selecione a opção Aplicações > Criar.
35. Preencha o formulário com as informações solicitadas.
Figura 33 Cadastramento de aplicação.
36. Clique em “Cadastrar aplicação”.
37. Clique em “Incluir feeds”.
EcoDiF – Manual de Usuário.
16
38. Selecione os feeds a serem utilizados na aplicação.
39. Clique em “Incluir feeds”.
Passo 8: Edição da aplicação
40. No menu Console, selecione a opção Aplicações > Consultar.
41. Clique na opção “Visualizar Aplicação”.
Figura 34 Lista de aplicações.
42.
43.
44.
45.
46.
Clique na opção “Download” do item “Arquivo EEML associado”.
Altere o arquivo EMML para o cálculo da média.
No menu Console, selecione a opção Aplicações > Consultar.
Clique na opção “Editar aplicação”.
Clique na opção “Escolher arquivo”.
47. Localize o arquivo editado no passo 43 e clique em “Abrir”.
48. Clique em “Cadastrar aplicação”.
Passo 9: Execução da aplicação
49. No menu Console, selecione a opção Aplicações > Consultar.
50. Clique na opção “Executar”.
51. Visualize o resultado da execução da aplicação.
52. Clique em “Sair”, na parte superior direita.
Passo 10: Consulta das Feeds e Aplicações pelo usuário “Consumidor de Informações”
53. Para visualizar as Feeds cadastradas, clique na opção “Feeds” do Menu Principal.
54. Para visualizar as Aplicações cadastradas, clique na opção “Aplicações” do Menu Principal.
EcoDiF – Manual de Usuário.
17