1

1 INTRODUO .............................................................................................................................................................................. 3 2 REQUERIMENTOS DO SISTEMA ............................................................................................................................................ 4 3 INSTALANDO ASTROBOX........................................................................................................................................................ 4 4 CONFIGURANDO REDE NO VIRTUALBOX ......................................................................................................................... 9 5 EXECUTANDO APLICAES GERAIS ................................................................................................................................ 11 5.1 5.2 5.3 5.4 COPIANDO ARQUIVOS PARA A MQUINA VIRTUAL .......................................................................................................... 11 EXECUTANDO APLICAES NCL E NCL/LUA ................................................................................................................ 11 EXECUTANDO APLICAES JAVA ................................................................................................................................... 14 EXECUTANDO APLICAES STICKER .............................................................................................................................. 16

6 MAPA DE TECLAS .................................................................................................................................................................... 19

1 INTRODUO
O AstroBox um software capaz de simular a operao de um ambiente de TV para desenvolvimento de aplicaes interativas de TV Digital baseadas no padro de middleware Ginga.

Este o Desktop da virtual machine utilizada para executar o AstroBox. Aqui podemos ver alguns itens no Desktop, sendo os mais importantes: pasta Applications, AstroBox Configure, e AstroBox. O diretrio Applications onde as aplicaes Ginga so armazenadas, ambas NCL e Java. Ele no deve ser removido, caso contrrio o emulador no ir funcionar. O script AstroBox Configure permite configurar que aplicao que ir executar. importante configurar o tipo e o entry-point da aplicao antes de rod-la no emulador. Uma vez configurado, no necessrio reconfigurar a cada vez que a mesma aplicao for executada.

2 Requerimentos do Sistema
Para rodar o AstroBox, o sistema deve possuir os seguintes requisitos mnimos de configurao: Processador: Intel Core 2 (ou equivalente) 2Ghz Memria RAM: 4GB Mquina Virtual: Virtual Box 3.2.6 Disco Rdigo: de 3 10GB Memria de Vdeo: 128MB Outros: Porta USB e dispositivo de armazenamento USB.

3 Instalando AstroBox
1 Instalar o software VirtualBox <www.virtualbox.org> e abra-o. 2 Baixe a Virtual Machine utilizada para executar o AstroBox do site do AstroDevNet. Copie o .vmdk para o sistema. Caso esteja em algum formato de compresso (zip, bz2, rar, etc), use alguma ferramenta para extrair. 3 No VirtualBox, clique no boto New para abrir uma janela de configurao.

4 Na janela de dilogo, siga a sequncia: Clique em Next.

Selecione o nome da sua mquina no campo Name. Em OS Type escolha Linux e Ubuntu. Clique em Next.

5 Selecione Base Memory Size de acordo com sua configurao de hardware. Na maioria dos casos, pode ser configurado entre 700 e 1024Mb. Clique em Next.

6 Selecione as opes Boot Hard Disk e Use existing hard disk.

7 Clique no cone open file e no boto Add. Selecione o arquivo .vmdk localizado no seu sistema e pressione Select e Next.

8 Pressione Finish. 9 Abra sua mquina virtual, clicando duas vezes nela.

10 Para logar no emulador, use o seguinte usurio/senha: Usurio: totvs Senha: astrobox

11 Ao logar pela primeira vez, o AstroBox ser descarregado e instalado. Utilize o seu email e senha cadastrados no AstroDevNet para fazer o download.

12 Clique em Ok e a seguir, digite sua senha.

O AstroBox ser descarregado e instalado na sua virtual machine. cones sero criados no Desktop.

4 Configurando rede no VirtualBox

O VirtualBox disponibiliza trs interfaces de rede, so elas: Network Address Translation (NAT), Host Inferface (bridge) e Internal Networking (bridge seguro). Por padro, j vem com a placa de rede configurada e sua correta utilizao depende do sistema operacional do sistema hospedeiro. Para maiores informaes acessar o manual do usurio no site da Virtual Box: https://www.virtualbox.org/manual/UserManual.html Para ilustrar a configurao usaremos o modo NAT. 1 No VirtualBox clique em Settings e procure a opo Rede.

2 - No item Rede selecione a opo Habilitar Placa de Rede. Na opo Conectado a, deixe no modo NAT.

3 - No item Tipo de Placa da opo Avanado (D), selecione a placa: Intel PRO/1000 MT Desktop (82540EM). 4 Clique em OK para prosseguir e inicie novamente a VM

10

5 Executando aplicaes gerais 5.1 Copiando arquivos para a mquina virtual

Em algum momento, ser necessrio copiar arquivos para o sistema de arquivos da mquina virtual. Muitos mecanismos podem ser usados como montar o sistema via NFS ou atravs do compartilhamento (samba). Isto pode ser configurado e customizado pelo usurio de acordo com o ambiente e necessidades. Um mtodo simples usar um dispositivo de armazenamento USB para copiar arquivos. Segue abaixo o procedimento: 1- insira o dispositivo de armazenamento USB no computador; 2- copie os arquivos a serem transferidos para o dispositivo USB; 3- clique com o boto direito no cone USB na janela do VirtualBox;

4- marque o dispositivo USB na lista que ir abrir; o dispositivo ser montado automaticamente e o gerenciador de arquivos ir abrir; 5- usando o gerenciador de arquivos, copie os arquivos do dispositivo USB para o diretrio destino (normalmente os diretrios Applications ou Sticker); 6- uma vez feita a transferncia, clique com o boto direito no cone USB da VirtualBox e desmarque o dispositivo USB da lista; o dispositivo ir ser desmontado automaticamente.

5.2 Executando aplicaes NCL e NCL/Lua

Para executar aplicaes NCLua ou NCL, necessrio copi-las para o diretrio Applications, localizado no Desktop.

11

Clicando em AstroBox Configure, possvel configurar o tipo da aplicao e seu entry-point, como mostrado na imagem abaixo:

12

Quando a opo Ginga-NCL for escolhida, o dispositivo tambm deve ser selecionado (Fullseg ou One-seg). Quando One-seg for selecionado, o formato da tela ser adaptado e os eventos de mouse podem ser usados para simular toques na tela do celular. Aps, configure o entry-point da aplicao.

Se o entry-point for configurado corretamente, uma mensagem de sucesso ir aparecer aps pressionar Ok. Caso contrrio uma mensagem de erro aparecer informando que o entry-point no foi encontrado. Uma vez a configurao completa, o emulador estar pronto para ser executado clicando no cone AstroBox no Desktop. Veja abaixo um exemplo da aplicao sendo executada:

13

Esta rea preta representa a rea de vdeo. Nota: Quando a aplicao rodar num ambiente real, o vdeo ir aparecer ao invz da tela preta. Para fechar o emulador, pressione Ctrl+C na janela de logs.

5.3 Executando aplicaes Java

Para executar aplicaes Java, necessrio copi-la para o diretrio Applications, localizado no Desktop.

14

 importante notar que aplicaes Ginga-J devem seguir o modelo Xlet. Nesta verso do emulador requerido que a classe Xlet principal esteja no pacote principal. Ento configure o tipo da aplicao e seu entry-point usando AstroBox Configure. Primeiro, selecione o tipo da aplicao: DVB/Ginga-J.

Segundo, configure o entry-point da aplicao.

Se o entry-point for configurado corretamente, uma mensagem de sucesso ir aparecer aps pressionar Ok. Caso contrrio, uma mensagem de erro aparecer informando que o entry-point no foi encontrado.

Uma vez feita a configurao, o emulador estar pronto para ser executado clicando no cone AstroBox no Desktop.

15

Para fechar o emulador, pressione Ctrl+C na janela de logs.

5.4 Executando aplicaes Sticker

Para executar aplicaes Sticker, necessrio copi-las para o diretrio Sticker, localizado no Desktop.

No diretrio Sticker, crie um arquivo chamado config.ini contendo uma entrada Entrypoint apontando para o entry-point do Sticker. Um exemplo de config.ini:

16

Entrypoint=/source/main.lua

No caso de stickers Java, voc dever omitir a extenso do arquivo (.class).

Clicando no atalho AstroBox Configure, possvel configurar o tipo da aplicao como mostrado na figura abaixo:

17

Selecione Stickers para rodar sticker Lua ou Java. Uma vez completa a configurao, o emulador estar pronto para ser executado atravs do cone AstroBox no Desktop. Logo que o emulador for inicializado, pressione a tecla do StickerCenter (S) e seu sticker ser executado. Veja abaixo um exemplo de sticker:

18

6 Mapa de teclas
A seguinte tabela lista as teclas do controle remoto requeridas pelo padro Ginga e como elas so mapeadas no emulador. Teclas do controle remoto Selecionar/OK Voltar Tecla vermelha Tecla verde Tecla amarela Tecla azul Teclas de navegao (setas) Teclas numricas (0 at 9) Tecla StickerCenter Emulador Enter Backspace F1 F2 F3 F4 Teclas de setas do teclado 0 at 9 S

19

20