BitVicer 1.2 Manual d Usuári Prtuguês Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 1
Sumári 1 APRESENTAÇÃO 3 1.1 REQUISITOS MÍNIMOS 3 1.2 COMPATIBILIDADE 3 1.3 AVISO DE SEGURANÇA 3 2 PRIMEIROS PASSOS 3 2.1 INSTALAÇÃO 3 2.2 INTERFACE GRÁFICA 4 2.3 ATIVAÇÃO 4 3 CONFIGURAÇÕES 5 3.1 INICIALIZAÇÃO 6 3.2 RECONHECIMENTO DE VOZ 7 3.2.1 SPEECH RECOGNITION LANGUAGE (IDIOMA DO RECONHECIMENTO DE VOZ) 7 3.2.1.1 Idimas Adicinais 7 3.2.2 ACCEPTABLE CONFIDENCE LEVEL (NÍVEL DE CONFIANÇA ACEITÁVEL) 8 3.2.3 MINIMUM AUDIO LEVEL (NÍVEL MÍNIMO DE ÁUDIO) 8 3.2.4 AUDIO LEVEL ACTIVATED PERIOD (PERÍODO ATIVADO POR NÍVEL DE ÁUDIO) 9 3.2.5 LATENCY PERIOD (PERÍODO DE LATÊNCIA) 10 3.2.6 DESEMPENHO DO RECONHECIMENTO DE VOZ 10 3.3 COMUNICAÇÃO 11 3.4 AUDIO INPUT (ENTRADA DE ÁUDIO) 11 3.4.1 AUDIO STREAMING CALIBRATION (CALIBRAÇÃO DE ÁUDIO STREAMING) 11 4 CRIANDO, EDITANDO E USANDO ESQUEMAS DE VOZ 12 4.1 O ESQUEMA DE VOZ 12 4.2 ADICIONANDO SENTENÇAS 14 4.3 ITENS DE SENTENÇA 15 4.4 PALAVRA DE ATIVAÇÃO 16 4.5 INICIANDO E PARANDO O RECONHECIMENTO DE VOZ 17 4.6 TIPO DE DADO PADRÃO PARA COMANDOS 18 4.7 EXEMPLO PRÁTICO 18 5 COMUNICAÇÃO 18 5.1 PROTOCOLO BITVOICER 18 5.2 ENVIANDO DADOS AO BITVOICER 20 5.3 COMANDOS 20 5.4 BIBLIOTECA BITVOICER PARA ARDUINO 20 5.4.1 REFERÊNCIA DA BIBLIOTECA BITVOICER PARA ARDUINO 21 5.5 EXEMPLOS DE UTILIZAÇÃO DA BIBLIOTECA BITVOICER 23 5.5.1 ÁUDIO CAPTADO PELO MICROFONE DO COMPUTADOR 23 5.5.2 ÁUDIO CAPTADO POR UM MICROFONE CONECTADO AO MICRO-CONTROLADOR 25 6 ÁUDIO STREAMING 28 6.1 SINALIZANDO PARA O BITVOICER 29 7 PAINÉIS DE INFORMAÇÃO 30 7.1 NÍVEL DE ÁUDIO, ATIVIDADE, STATUS E ERROS 30 7.2 MONITOR DE COMUNICAÇÃO 34 8 SUPORTE E CONTATO 34 Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 2
1 Apresentaçã BitVicer é sftware de recnheciment de vz que traz para univers ds micr-cntrladres td pder de prcessament e análise de vz ds PCs. Sua tecnlgia de recnheciment de vz e us de padrões de cmunicaçã cmuns na indústria (TCP/IP e Serial/UART) trnam extremamente fácil e rápida a criaçã de funcinalidades cmplexas de recnheciment de vz para praticamente qualquer micrcntrladr prgramável dispnível n mercad. Este manual irá guia-l pel prcess de instalaçã e cnfiguraçã d BitVicer, demnstrar a incrível flexibilidade ds Esquemas de Vz da BitSphia e apresentar tdas as ferramentas dispníveis n aplicativ. 1.1 Requisits mínims Sistema peracinal Windws Vista u Windws 7 Micrsft.NET Framewrk 4.0 u psterir Uma das interfaces de cmunicaçã a seguir: Prta Serial USB (usada cm prta COM virtual) Adaptadr Ethernet Adaptadr Wireless Cnexã cm a internet (para ativaçã u instalaçã de idimas adicinais) 1.2 Cmpatibilidade A principi, BitVicer é cmpatível cm qualquer micr-cntrladr prgramável e/u shield que utilize cmunicaçã TCP/IP baseada em sckets u cmunicaçã serial (interface UART). N entant, vcê deve cnsultar atentamente a dcumentaçã d fabricante d seu dispsitiv e certificar-se que ele é cmpatível cm estes padrões de cmunicaçã. Durante desenvlviment d BitVicer alguns prduts ds fabricantes abaix fram utilizads e estã mais prpenss a serem cmpatíveis: Arduin Rving Netwrks Digi Internatinal Atmel Crpratin Sparkfun Electrnics 1.3 Avis de segurança O BitVicer nã deve ser utilizad em qualquer aplicaçã de missã crítica, suprte a vida, cnduçã e peraçã de maquinári u veículs autmtres, u ainda, qualquer aplicaçã cuj mau funcinament pssa causar dan à prpriedade e a mei-ambiente u atentar cntra a saúde de pessas u animais. A BitSphia nã autriza us de seu sftware em qualquer uma destas aplicações, assumind, usuári, quaisquer respnsabilidades pela vilaçã desta pribiçã. 2 Primeirs passs 2.1 Instalaçã Para realizar s prcediments de instalaçã a seguir, será necessári ter iniciad Windws em uma cnta cm permissões administrativas: Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 3
1º) Baixe arquiv de instalaçã BitVicerSetup_v12_xXX.exe d site da BitSphia (www.bitsphia.cm). 2º) Execute arquiv de instalaçã e siga s passs d assistente de instalaçã. Será necessári cncrdar cm s terms d cntrat de licença d BitVicer e esclher a pasta para instalaçã d aplicativ. 3º) Execute aplicativ através d link criad em sua área de trabalh u através d link em Iniciar Tds s Prgramas BitShia BitVicer. A ativaçã d BitVicer nã será slicitada até que se pressine btã para iniciar mtr de recnheciment de vz. 2.2 Interface gráfica A interface gráfica d BitVicer é cmpsta basicamente pr 2 áreas: menus e área de trabalh. Os menus, descrits abaix e encntrads n tp da tela, acessam funcinalidades exibidas sempre na área de trabalh: File New: inicia a criaçã de um nv Esquema de Vz iniciand editr na área de trabalh d aplicativ. File Open: permite a abertura de Esquemas de Vz previamente gravads. Pr padrã, a pasta inicial exibida é a mesma infrmada em File Preferences Default utput flder. File Clse: fecha Esquema de Vz atualmente abert. Cas Esquema de Vz atual tenha sid alterad, uma caixa de mensagem perguntará a usuári se deseja salvar Esquema de Vz atual. OBS: a utilizaçã de qualquer uma das pções acima interrmpe recnheciment de vz cas ele esteja send executad. File Save: grava Esquema de Vz atual. Cas este esquema ainda nã tenha sid gravad anterirmente, uma caixa de dialg slicitará a usuári que infrme nme e a lcalizaçã d arquiv a ser gravad. File Save as: grava Esquema de Vz atual em arquiv e lcal a ser especificad pel usuári. File Preferences: abre frmulári nde devem ser infrmadas tdas as cnfigurações padrões d BitVicer. File Exit: encerra aplicativ e mtr de recnheciment de vz cas ela esteja send executada. Se Esquema de Vz abert tiver sid alterad e nã fr salv, BitVicer irá perguntar a usuári se este deseja gravar Esquema de Vz antes de encerrar aplicativ. Help BitVicer manual: abre manual de referência d BitVicer. Help Activatin: abre frmulári que iniciará prcess de ativaçã da sua cópia d BitVicer. Cas a ativaçã já tenha sid feita, este frmulári ficará inacessível a usuári. Help Abut BitVicer: exibe tdas as infrmações sbre sua cópia d BitVicer além de dads para cntat. 2.3 Ativaçã Para pder utilizar as interfaces de cmunicaçã d BitVicer, é necessári realizar a ativaçã de sua cópia cm uma chave de prdut válida. Cas vcê ainda nã pssua esta chave, adquira a sua em www.bitsphia.cm. Cm a chave de prdut em mãs, abra BitVicer cm administradr (clique n atalh d BitVicer cm btã direit d muse e selecine Executar cm administradr ) e acesse a pçã Activatin n menu Help d BitVicer. Vcê deverá ver frmulári a seguir: Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 4
Após infrmar uma chave de prdut válida, clique em Activate. Neste pnt, seu cmputadr deverá estar cnectad à internet para que serviç de ativaçã da BitSphia pssa cnfirmar a chave de prdut infrmada. Na caixa de text abaix d btã Activate, é pssível acmpanhar prcess de ativaçã e visualizar qualquer err que crra durante este prcess. Cas a ativaçã seja bem sucedida, uma caixa de mensagem irá avisar que sua cópia d BitVicer está ativada e mtr de recnheciment de vz já pde ser iniciad. Durante prcess de ativaçã, BitVicer gera um códig exclusiv para seu cmputadr. Este códig será criptgrafad e armazenad ns servidres da BitSphia, prém nã será utilizad para cntata-l n futur e nã será cmpartilhad cm terceirs. Uma vez ativada, a chave de prdut nã pderá ser utilizada para ativaçã de qualquer versã d BitVicer em utr cmputadr. Send assim, ative sua cópia d BitVicer apenas na máquina que deseja utilizar sftware. 3 Cnfigurações Para acessar frmulári de cnfiguraçã d BitVicer clique em Preferences n menu File. Vcê deverá visualizar frmulári a seguir: Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 5
O BitVicer já vem cnfigurad cm um cnjunt de preferências padrã e mtr de recnheciment de vz pde ser iniciad sem qualquer cnfiguraçã inicial. 3.1 Inicializaçã As seguintes pções de inicializaçã pdem ser alteradas nas cnfigurações de inicializaçã d BitVicer: Open BitVicer when yu lg n t the cmputer (Abra BitVicer quand vcê lgar n cmputadr): quand esta pçã estiver marcada, BitVicer irá iniciar junt cm Windws e aparecerá minimizad na barra de tarefas d seu cmputadr. Activate speech recgnitin when the BitVicer starts (Ativar recnheciment de vz quand BitVicer iniciar): quand esta pçã estiver marcada, BitVicer irá iniciar mtr de recnheciment de vz lg após ser abert. Cas esta pçã seja marcada, será necessári infrmar também um Esquema de Vz padrã (Default Vice Schema) que será carregad lg após a abertura d BitVicer. Vcê pde utilizar a ferramenta de busca de arquivs (btã Search), lcalizada à direita da caixa de text Default Vice Schema, para selecinar arquiv padrã. Default utput flder (Pasta de saída padrã): esta é a pasta padrã utilizada para gravar s esquemas de vz criads n BitVicer. Vcê pde utilizar a ferramenta de busca de pastas Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 6
(btã Search), lcalizada à direita da caixa de text Default utput flder, para selecinar a pasta padrã. 3.2 Recnheciment de vz Esta seçã das preferências é respnsável pel adequad funcinament d mtr de recnheciment de vz. Embra BitVicer já venha cnfigurad cm um cnjunt de preferências padrã, é necessári ler atentamente s itens 3.2.1 a 3.2.6 cas deseje aprimrar seu funcinament. 3.2.1 Speech Recgnitin Language (Idima d recnheciment de vz) A caixa de seleçã Speech recgnitin language exibe s idimas de recnheciment de vz instalads em seu cmputadr. Até mment, s seguintes idimas estã dispníveis: Alemã (Alemanha) Catalã Chinês (China, Hnk Kng e Taiwan) Crean (Créia) Dinamarquês (Dinamarca) Espanhl (Méxic e Espanha) Finlandês (Finlândia) Francês (Canada e França) Hlandês (Hlanda) Inglês (Austrália, Canada, Índia, Rein Unid e Estads Unids) Italian (Itália) Japnês (Japã) Nrueguês (Nruega) Plnês (Plônia) Prtuguês (Brasil e Prtugal) Russ (Rússia) Suec (Suécia) Pr padrã, BitVicer é instalad cm inglês (US) apenas. Se vcê precisar instalar qualquer idima adicinal, cnsulte a seçã Idimas Adicinais (item 3.2.1.1). 3.2.1.1 Idimas Adicinais Para pder instalar idimas adicinais, é necessári iniciar BitVicer cm privilégis administrativs ( Executar cm Administradr ) e estar cnectad a Internet. Primeir, clique em Additinal Languages (idimas adicinais) n menu File (arquiv). Vcê deverá ver frmulári abaix: Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 7
A caixa de listagem cm s idimas exibe apenas s idimas que nã estã instalads em seu cmputadr. Selecine um ds idimas da lista e clique n btã Install (instalar). Depis d dwnlad e instalaçã d pacte de idima, será pssível selecinar idima recentemente instalad n frmulári de preferências (cnsulte a seçã 3). 3.2.2 Acceptable Cnfidence Level (Nível de cnfiança aceitável) O nível de cnfiança aceitável representa a prbabilidade relativa mínima que é necessária para que mtr de recnheciment de vz d BitVicer aceite determinada fala. O nível de cnfiança nã indica a prbabilidade absluta da alternativa recnhecida crrespnder a uma determinada fala, mas sim a prbabilidade de ela estar crreta dentre as múltiplas alternativas dispníveis n Esquema de Vz. Supnha um Esquema de Vz cm dez alternativas de recnheciment: durante prcess de recnheciment, será dada a cada uma dessas alternativas uma nta (1 a 100%) que representa a prbabilidade desta alternativa, dentre tdas as alternativas dispníveis, crrespnder à fala detectada. A alternativa que receber a mair nta será aquela aceita pel mtr de recnheciment de vz. A infrmar um nível de cnfiança aceitável, vcê estabelece um limite mínim para esta nta e tds s recnheciments que tenham nível de cnfiança inferir a este limite, serã rejeitads, u seja, nã será enviad qualquer cmand a micr-cntrladr. O nível de cnfiança aceitável é um valr percentual entre 1 e 100 e us de casas decimais é significativ para determinar se uma fala será aceita u rejeitada. A cnfigurar nível de cnfiança, deve-se cnsiderar que diferentes interlcutres bterã diferentes níveis de cnfiança para a mesma fala. Dessa frma, é precis cnfigurar nível de cnfiança aceitável de md a satisfazer as ntas btidas pels diverss interlcutres usuáris d aplicativ. N entant, baixar demasiadamente nível de cnfiança aceitável pde levar BitVicer a aceitar recnheciments que, na verdade, deveriam ser rejeitads. A melhr frma de bter uma base para nível de cnfiança aceitável é realizand testes de recnheciment de vz. Para iss, desabilite a cmunicaçã d BitVicer (cnsulte item 3.3 deste manual), carregue um Esquema de Vz e inicie mtr de recnheciment (item 4.5). Observe s níveis de cnfiança btids n painel de atividade (item 7.1). Neste painel é pssível ver a nta atribuída a cada recnheciment e bter uma base para nível de cnfiança aceitável. É imprtante ressaltar que mudanças n ambiente também afetam significativamente s níveis de cnfiança btids. Pr esta razã, quand huver mudança significativa n ambiente (aument de ruíds de fund u mudança n nível de áudi médi), pderá ser necessári rever a cnfiguraçã de nível de cnfiança aceitável. Para mais infrmações sbre nível de cnfiança aceitável, cnsulte a seçã Desempenh d recnheciment de vz (item 3.2.6). 3.2.3 Minimum Audi Level (Nível mínim de áudi) O nível mínim de áudi funcina de frma semelhante a nível de cnfiança aceitável, u seja, é um limite mínim que deve ser superad para que determinada fala seja aceita pel BitVicer. Assim que mtr de recnheciment de vz é iniciad, ele passa a armazenar nível de áudi captad d ambiente. Cm base na cnfiguraçã d item a seguir (Audi level activate perid) é feita uma média d nível de áudi n períd. Cas nível de áudi, durante recnheciment, nã atinja esta média acrescida d nível mínim de áudi, a fala será rejeitada. Em utras palavras, para que uma fala seja recnhecida e aceita, em algum mment d prcess de recnheciment, nível de áudi deve atingir u ultrapassar valr representad pela média d nível de áudi acrescid d nível de áudi mínim. Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 8
A figura a seguir ilustra cnceit pr traz dessa cnfiguraçã: 3.2.4 Audi Level Activated Perid (Períd ativad pr nível de áudi) O períd ativad pr nível de áudi se inicia quand nível mínim de áudi é atingid. Este períd se renva sempre que nível mínim de áudi é atingid e tda fala recnhecida neste períd será aceita pel BitVicer, independentemente d nível de áudi n mment d recnheciment, a nã ser que: O nível de cnfiança seja inferir a nível de cnfiança aceitável; O mment d recnheciment esteja dentr d períd de latência (item 3.2.5); A palavra de ativaçã (item 4.4) nã tenha sid identificada, cas esta pçã tenha sid selecinada; O mment d recnheciment nã esteja dentr d períd de ativaçã pr palavra de ativaçã, cas esta pçã tenha sid selecinada. Para entender melhr a funçã desta cnfiguraçã, é precis entender em que rdem s filtrs d BitVicer atuam e seus graus de priridade: Filtr Atuaçã Priridade Nível de cnfiança 1º a atuar 5º Nível de áudi 2º a atuar 4º Períd de ativaçã pr nível de áudi 3º a atuar 3º Períd de latência 4º a atuar 2º Períd de ativaçã pr palavra de ativaçã 5º a atuar 1º De acrd cm a tabela acima, s níveis de priridade mais alta (send 1 a mais elevada e 5 a mais baixa) anulam recnheciment aceit pr filtrs de priridade mais baixa. Pr exempl, se tds s filtrs validarem um recnheciment de vz, mas 5º filtr (cuja priridade é mais elevada) recusar recnheciment, BitVicer irá cnsiderar a fala rejeitada. Em utras palavras, tds s filtrs devem validar um recnheciment para que BitVicer aceite determinada fala. O períd ativad pr nível de áudi deve ser infrmad em milissegunds (1000 milisegunds = 1 segund) e deve ser levada em cnsideraçã a quantidade de palavras e temp necessári para cncluir a prnúncia das sentenças presentes n Esquema de Vz. Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 9
Para mais infrmações sbre períd ativad pr nível de áudi, cnsulte a seçã Desempenh d recnheciment de vz (item 3.2.6). 3.2.5 Latency Perid (Períd de latência) O períd de latência se inicia lg após um recnheciment de vz ter sid aceit pel BitVicer ( recnheciment tem que ter passad pr tds s filtrs). Neste períd, qualquer recnheciment será rejeitad mesm que passe pels filtrs anterires. O períd de latência impede que nvs recnheciments sejam aceits lg após um recnheciment válid, prevenind envi de cmands em sequência, que pderia interferir na execuçã de um cmand previamente enviad a micr-cntrladr. 3.2.6 Desempenh d recnheciment de vz Esta seçã frnece algumas dicas para melhrar desempenh d mtr de recnheciment de vz d BitVicer em diversas situações. Talvez seja necessári executar mais de uma dessas dicas para atingir desempenh desejad: Fale de maneira clara e firme. Quant mais temp mtr de recnheciment de vz permanecer em execuçã, mair será a precisã n estabeleciment de níveis de cnfiança adequads; Prnunciar as palavras cm staque adequad é fundamental para aumentar nível de cnfiança das sentenças recnhecidas. Se idima utilizad nã fr seu idima nativ, será necessári dar mair atençã à prnúncia crreta das palavras. Mantenha micrfne a, n mínim, um metr de utras fntes de sm cm alt-falantes e televisres. Se a interferência de utras fntes de áudi persistir, cnsidere a adçã de um micrfne direcinal neste cas; Evite criar sentenças muit curtas que cntenham apenas palavras cm uma u duas sílabas. O mtr de recnheciment de vz d BitVicer pde identificar estas palavras em diversas partes da linguagem ctidiana e gerar falss psitivs. Cas vcê esteja utilizand uma palavra de ativaçã (item 4.4), recmendams us de palavras cm 3 u mais sílabas e cuja crrência na linguagem ctidiana seja pequena; Para evitar falss psitivs (recnheciment aceit que deveria ter sid rejeitad), aumente gradativamente nível de cnfiança aceitável (precisã decimal) nas cnfigurações d BitVicer; Em ambientes aberts, cm grande quantidade de ruíd e/u utras pessas faland, cnsidere a adçã de um headset (há pções sem fi n mercad) e aumente nível mínim de áudi nas cnfigurações d BitVicer. A utilizar um headset, a bca fica mais próxima d micrfne e a qualidade e nível de áudi aumentam. Aumentand também nível mínim de áudi n BitVicer, vcê evita que a fala de utras pessas a redr sejam recnhecidas pel mtr de recnheciment de vz. Cnsidere aumentar gradativamente nível mínim de áudi cas estejam crrend falss psitivs prvenientes de utras fntes de áudi cuj vlume é baix; Cnsidere aumentar períd de latência para evitar falss psitivs. Dessa frma, BitVicer irá ignrar recnheciments imediatamente psterires a um recnheciment válid. Cas vcê também esteja utilizand uma palavra de ativaçã, períd de latência deve ser menr, já que, na mairia ds cass, uma fala deve sim ser recnhecida lg após a palavra de ativaçã; Estabelecer um períd de ativaçã pr nível de áudi crret também pde evitar falss psitivs. Se este períd de ativaçã fr muit mair que temp necessári para se prnunciar as sentenças d Esquema de Vz, aumentará a prbabilidade de um recnheciment cm baix nível de áudi ser aceit. Iss crre prque BitVicer nã irá rejeitar pr baix nível de áudi recnheciments crrids dentr deste períd. Cas a captaçã de áudi esteja send realizada através de um micrfne cnectad a micrcntrladr, certifique-se que a frequência de amstragem nã seja menr que 8000 u mair Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 10
que 8200 captações pr segund. O desempenh d recnheciment de vz pde ser alterad de frma imprevisível cas a amstragem esteja fra desta faixa. Certifique-se também que áudi enviad a BitVicer está livre de interferências u ruíds causads pela CPU d micrcntrladr, pr errs de cmunicaçã, pr variações de vltagem u pr flutuações de mediçã. 3.3 Cmunicaçã Nesta seçã das preferências, vcê cnfigura mei utilizad pel BitVicer para se cmunicar cm seu micr-cntrladr: Use USB/Serial Cmmunicatin (Use cmunicaçã USB/Serial): a selecinar esta pçã, é necessári infrmar a qual prta serial seu micr-cntrladr está cnectad (ex. COM4, COM8, etc) e s utrs parâmetrs de cmunicaçã serial. É pssível que velcidades de cmunicaçã (Bits per Secnd) elevadas prvquem errs de cmunicaçã em determinads cmputadres u micr-cntrladres. Se vcê acreditar que está recebend infrmações incrretas em seu micr-cntrladr, tente reduzir a velcidade de cmunicaçã. Use TCP/IP Cmmunicatin (Use cmunicaçã TCP/IP): a selecinar esta pçã, é necessári infrmar endereç IP de destin ds cmands e a prta de cmunicaçã n endereç de destin. O micr-cntrladr de destin deve suprtar cmunicaçã baseada em squetes (Berkeley sckets). Em ambas as interfaces de cmunicaçã, BitVicer irá blquear as prtas em us assim que mtr de recnheciment de vz fr iniciad. Nenhuma utra aplicaçã n cmputadr terá acess a estas prtas. N entant, é pssível enviar dads de seu micr-cntrladr de vlta para PC e visualizar s dads enviads n painel mnitr de cmunicaçã (item 7.2). Vcê também pde desabilitar envi de infrmações a micr-cntrladr selecinand Disable cmmunicatins. Mesm cm esta pçã selecinada, é pssível iniciar mtr de recnheciment de vz e mnitrar a atividade d BitVicer n painel de atividade (item 7.1). 3.4 Audi Input (Entrada de áudi) O BitVicer pde prcessar áudi captad através d micrfne instalad n cmputadr u através de um micrfne cnectad a micr-cntrladr. A pçã Audi Input permite que seja selecinada a fnte de áudi desejada. Para maires infrmações a respeit da captaçã de áudi através de micrcntrladres, cnsulte a seçã Audi Streaming (item 6). 3.4.1 Audi Streaming Calibratin (Calibraçã de Áudi Streaming) Se a captaçã de áudi fr feita pel micr-cntrladr e enviada a BitVicer na frma de flux de áudi, será necessári executar esta ferramenta para que BitVicer pssa estabelecer crretamente nível d áudi recebid. O painel de infrmações sbre s níveis de áudi (item 7.1) e filtr de nível de áudi (item 3.2.3) dependem diretamente ds valres btids nesta ferramenta. Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 11
O camp Samples per Secnd (amstras pr segund) exibe a quantidade de amstras recebidas pel BitVicer a cada segund. Esse valr pde ser usad cm referência para que seja ajustada a quantidade de captações de áudi feitas pel micr-cntrladr. O camp Reference Audi Level (nível de áudi de referência) exibe valr médi das amstras recebidas. Em uma nda de áudi, este valr representa centr da amplitude da nda cm demstrad na figura abaix. Cm BitVicer prcessa amstras de 8 bits (0 a 255), s valres ideais para este camp sã 128 u 129. Mais infrmações sbre áudi streaming na seçã 6 deste manual. A clicar n btã Start (Iniciar), BitVicer envia cmand Start Sampling (Iniciar amstragem) para micr-cntrladr. O btã Stp, pr sua vez, envia cmand Stp Sampling (Parar amstragem) quand pressinad. Mais infrmações sbre cmands d BitVicer na seçã Cmunicaçã (item 5) deste manual. 4 Criand, editand e usand Esquemas de Vz 4.1 O Esquema de Vz O esquema de vz é a estrutura sbre a qual BitVicer trabalha para assciar um cmand específic a uma sentença recnhecida pel mtr de recnheciment de vz. Para atingir esse bjetiv, BitVicer se utiliza de duas funções principais d Esquema de Vz: criar tdas as permutações (chamads de anagramas) pssíveis para uma sentença e mapear cada um desses anagramas para cmand crrespndente. Os anagramas sã criads calculand-se tdas as permutações pssíveis a partir ds itens de sentença (item 4.3). Cnsidere mdel de sentença abaix: Item Simgle Item Optin Item Single Item Optin turn n the lights ff tube ven shwer O BitVicer criaria s seguintes anagramas n Esquema de Vz: Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 12
Anagrams turn n the lights turn n the tube turn n the ven turn n the shwer turn ff the lights turn ff the tube turn ff the ven turn ff the shwer Para melhr cmpreensã, esta seria a árvre de pssibilidades encntrada n Esquema de Vz: lights n the tube shwer ven turn lights ff the tube ven shwer N Editr de Esquemas de Vz d BitVicer, esta seria a apresentaçã d Esquema de Vz acima: Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 13
Após criar tds s anagramas pssíveis, BitVicer permite mapeament de um cmand específic para cada anagrama, cm pde ser vist na parte inferir da tela. Outra característica imprtante ns Esquemas de Vz da BitSphia é a flexibilidade. A qualquer mment é pssível inserir, alterar u excluir itens de sentença u sentenças inteiras. O BitVicer imediatamente recalcula tda a árvre de pssibilidades e cria s anagramas crrespndentes n Esquema de Vz. A capacidade de incluir sentenças u itens de sentença nã fi limitada n aplicativ e tamanh de um Esquema de Vz virtualmente nã tem limites. Os únics fatres limitadres de um Esquema de Vz sã a capacidade de prcessament de sua máquina e a memória dispnível. Uma última cnsideraçã imprtante sbre s Esquemas de Vz: a iniciar recnheciment de vz, BitVicer carrega tdas as sentenças e analisa as entradas de áudi para prcurar a melhr crrespndência (anagrama) dentre tdas as sentenças dispníveis. Pr esta razã, pde-se dizer que as sentenças cnstituem vcabulári d mtr de recnheciment de vz. Cas usuári prnuncie uma palavra fra deste vcabulári, em qualquer psiçã da sentença, mtr de recnheciment de vz fará uma aprximaçã cm as palavras dispníveis nesta psiçã a fim de encntrar uma crrespndência n Esquema de Vz. N entant, essa aprximaçã, na mairia das vezes, levará a uma rejeiçã n recnheciment de vz. 4.2 Adicinand sentenças O primeir pass para iniciar a cnstruçã de um Esquema de Vz é adicinar uma sentença. Para iss, vcê deve utilizar btã Add New Sentence (identificad pela seta vermelha na figura abaix) lcalizad n cant superir esquerd d Editr de Esquemas de Vz. Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 14
A clicar neste btã, uma nva sentença é adicinada a Esquema de Vz. Pr padrã, esta sentença já é criada cm um item Single (simples) em branc. À direita d item de sentença, também aparecem dis btões para adiçã e exclusã de itens (mais detalhes n item 4.3). O btã Delete Selected Sentences, lcalizad à direita d btã Add New Sentences, remve as sentenças marcadas na caixa de seleçã lcalizada n iníci de cada sentença (identificad pela seta laranja). Remver qualquer sentença d Esquema de Vz também remve tds s cmands assciads a esta sentença. Cas seus cmands pssuam dads que vcê nã quer perder, lembre-se de cpiar s dads ds cmands antes de remver uma sentença. Nte que, a inserir uma sentença, um anagrama é criad na área Sentence Anagrams d quadr de cmands. Este anagrama aparece cm a descriçã {EMPTY}, pr que nã há qualquer dad nesta psiçã da sentença que permita a criaçã de um anagrama cmplet. Diferente de um item Single, um item de sentença d tip Optin (cnsulte item 4.3 lg a seguir) aparecerá cm a descriçã [{EMPTY}] quand este estiver vazi. Um Esquema de Vz pde cnter inúmeras sentenças e s anagramas criads cm base em cada uma dessas sentenças serã clcads em rdem n painel de cmands. Tme cm exempl um Esquema de Vz cm duas sentenças, send que cada sentença pssui quatr anagramas pssíveis. O painel de cmands exibirá primeir s quatr anagramas da primeira sentença e, em seguida, s quatr anagramas da segunda sentença, u seja, s anagramas nã se misturam. O últim anagrama de uma sentença sempre define iníci ds anagramas da sentença seguinte. Um aspect muit imprtante sbre mtr de recnheciment de vz d BitVicer é que ele sempre identifica uma sentença pr inteir e nã apenas parte dela. Supnha que vcê pssua a seguinte sentença em seu esquema de vz: vá para frente dez centímetrs. O mtr de recnheciment de vz espera uvir a frase cmpleta e nã apenas parte dela cm, pr exempl, vá para frente. Nesta situaçã, mtr de recnheciment de vz deve rejeitar recnheciment. Se vcê desejar que BitVicer identifique ambas as sentenças ( vá para frente e vá para frente dez centímetrs ), será necessári criar duas sentenças. Uma para cada frase. 4.3 Itens de sentença Cada sentença em um Esquema de Vz é cmpsta pr uma sequência de itens de sentença. Estes itens de sentença pdem ser de dis tips: Single (Simples): s itens Single representam uma psiçã na sentença cuj cnteúd é cmum a tdas as permutações pssíveis. Um item Single pde cnter uma palavra u um cnjunt de palavras cnsideradas cm uma unidade. Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 15
Optin (Opçã): s itens Optin sã cmpsts pr um cnjunt de pções que pdem variar dentr daquela psiçã na sentença. Se um item Optin cntiver apenas uma pçã, ele apresentará mesm cmprtament de um item Single dentr d Esquema de Vz. Da mesma frma que um item Single, cada pçã dentr de um item Optin pde ser cmpsta pr apenas uma palavra u um cnjunt de palavras cnsideradas cm uma unidade. A sentença abaix utiliza alguns itens Single e Optin em sua cnstruçã: E este é cnjunt de anagramas criads cm base na sentença acima: Veja que s itens Single (1º e 4º itens) se repetem em tds s anagramas. Mesm para primeir item Single, frmad pr duas palavras, nã há criaçã de permutações para cada uma das palavras cntidas neste item. O 2º e 3º item sã itens d tip Optin e, neste cas, s anagramas sfrem permutações exatamente na psiçã a que cada um deles pertence. Nestes itens d tip Optin, é pssível ntar que númers nã devem ser utilizads em um Esquema de Vz em sua frma numeral (1,2,3...), mas, sim, em sua frma literal (um, dis, três...). Para diferenciar entre um item de sentença d tip Single u Optin, basta selecinar a pçã crrespndente em cada item. Ns itens d tip Single, s btões de + (adiçã) e (remçã) e a caixa de listagem de pções ficam desabilitadas. A alterar um item de sentença para tip Optin, estas pções d item trnam-se ativas. Para adicinar uma pçã em um item Optin, vcê deve digitar text da pçã na caixa de text d item e clicar n btã + (adiçã) u, ainda, simplesmente digitar text e pressinar ENTER. O BitVicer autmaticamente adicinará a pçã à lista de pções. Para remver uma pçã em um item Optin, selecine a pçã na caixa de listagem de pções e clique n btã (remçã). Remver qualquer pçã de um item Optin também remve tds s cmands assciads a esta pçã. Cas seus cmands pssuam dads que vcê nã quer perder, lembre-se de cpiar s dads ds cmands antes de remver uma pçã. 4.4 Palavra de ativaçã A palavra de ativaçã é uma palavra, u um cnjunt de palavras, que deve ser prnunciada antes da sentença prpriamente dita. Vcê pde prnunciar a palavra de ativaçã e a sentença de frma cntínua u apenas a palavra de ativaçã e, dentr d períd de ativaçã, a sentença prpriamente dita. A selecinar Use Activatin Wrd(s) (Use palavra(s) de ativaçã) n esquema de vz (figura abaix), BitVicer só irá aceitar um recnheciment se a palavra de ativaçã fr prnunciada antes da sentença. Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 16
O períd de ativaçã pr palavra de ativaçã representa períd durante qual nã é necessári repetir esta palavra para que BitVicer cnsidere um recnheciment cm válid. Este períd deve ser infrmad em segunds. A palavra de ativaçã pde ser usada para imprimir pessalidade a Esquema de Vz u cm frma de evitar falss psitivs. Neste últim cas, deve-se cnsiderar a utilizaçã de palavras de ativaçã cuja crrência seja pequena na linguagem ctidiana e recmenda-se us de palavras cm 3 u mais sílabas. Vale lembrar que a palavra de ativaçã é um ds filtrs utilizads pel BitVicer para aceitar u rejeitar um recnheciment (cnsulte item 3.2.4). 4.5 Iniciand e parand recnheciment de vz Para iniciar recnheciment de vz, basta clicar n btã Start lcalizad n centr da parte superir d Editr de Esquemas de Vz. É necessári estar cm um Esquema de Vz abert para pder iniciar recnheciment de vz e este esquema nã pde cnter qualquer anagrama cm a descriçã {EMPTY} u [{EMPTY}], u seja, nã pde haver qualquer item de sentença vazi n Esquema de Vz. Nã é necessári estar cm tds s cmands preenchids n painel de cmands, mas quand anagrama crrespndente a este cmand fr identificad pel mtr de recnheciment de vz, painel de atividade irá infrmar um err a enviar cmand. Só será pssível utilizar as interfaces de cmunicaçã se vcê pssuir uma cópia ativada d BitVicer. Para ativar sua cópia cnsulte item 2.3 deste manual. Vale lembrar que BitVicer irá blquear a prta de cmunicaçã especificada nas preferências e esta prta permanecerá blqueada até que mtr de recnheciment de vz seja parad. A iniciar recnheciment, também nã será pssível realizar qualquer ediçã n Esquema de Vz e s painéis de infrmaçã (cnsulte item 7) passarã a exibir diversas infrmações sbre estad d aplicativ e da cmunicaçã. Para ganhar acess nvamente a Esquema de Vz, é necessári parar mtr de recnheciment. A clicar n btã Start u Stp, BitVicer envia uma atualizaçã de status para micr-cntrladr. Este status pde ser Engine Runnning (mtr funcinand) u Engine Stpped (mtr parad). Para maires infrmações sbre a trca de dads entre micr-cntrladres e BitVicer, cnsulte a seçã Cmunicaçã (item 5). Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 17
4.6 Tip de dad padrã para cmands Sempre que um nv anagrama é criad n Esquema de Vz, ele é adicinad a painel de cmands. O tip de dad padrã deste cmand é definid de acrd cm valr da caixa de listagem Default Cmmand Data Type (tip de dad padrã ds cmands) lcalizada lg abaix d btã Add New Sentence d Editr de Esquemas de Vz. Esta ferramenta é especialmente útil se vcê está criand um Esquema de Vz cm muits anagramas e lhe pupará trabalh quand estiverem send definids s cmands d Esquema de Vz. 4.7 Exempl prátic N pacte de instalaçã d BitVicer há um exempl de Esquema de Vz cmplet (Sample.vsc). Este esquema pde ser encntrad na pasta ViceSchemas da pasta de instalaçã d BitVicer. Trata-se de um Esquema de Vz para cntrle de uma cama hspitalar autmatizada. Esse esquema seria útil em um centr médic nde s pacientes se encntram em estad de mbilidade reduzida. 5 Cmunicaçã O BitVicer pde se cmunicar cm micr-cntrladr através de prtas seriais u prtas TCP/IP (cnsulte item 3.3). Qualquer que seja mei de cmunicaçã utilizad, a mairia ds dads trcads entre BitVicer e micr-cntrladr sã frmatads em um prtcl própri descrit n item 5.1. Este prtcl só nã é utilizad quand BitVicer está recebend flux de áudi enviad pel micrcntrladr (item 6). A cmunicaçã entre BitVicer e micr-cntrladr se dá em 5 situações: A utilizar a ferramenta de Calibraçã de Áudi Streaming (item 3.4.2), quand se clica n btã Start u Stp; A iniciar u parar mtr de recnheciment de vz; Quand um recnheciment de vz é aceit; Quand se envia alguma infrmaçã d micr-cntrladr para ser exibida n painel Mnitr de Cmunicaçã; Durante td períd que BitVicer estiver recebend flux de áudi enviad pel micrcntrladr. 5.1 Prtcl BitVicer O Prtcl BitVicer cnsiste em uma série de parâmetrs de frmataçã que devem ser seguids para trcar infrmações entre BitVicer e s micr-cntrladres. Este prtcl deve ser utilizad em ambs s sentids de cmunicaçã: BitVicer micr-cntrladr e micr-cntrladr BitVicer. A tabela abaix descreve a frmataçã ds datagramas enviads e recebids pel BitVicer: Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 18
Nme Psiçã d Byte Valr Descriçã Inici de transmissã 1 1 Marcadr de inici de transmissã Tip de dad 2 1 = Char 2 = Int 3 = Byte 4 = String 254 = Cmand 255 = Status Indica tip de dad carregad pel datagrama Cmpriment ds Dads 3 X Cmpriment, em bytes, d camp dads Dads 4 a n X Cntém s dads prpriamente dits n = 3 + Cmpriment ds dads Fim de transmiçã n + 1 4 Marcadr de fim de transmissã Embra s cmands sejam frmatads segund estes parâmetrs, em essência, tds s dads enviads sã uma sequência de bytes cuj cmpriment irá variar em funçã d tip de dad e da quantidade de infrmaçã a ser enviada. O primeir byte de um datagrama sempre deve cnter valr 1 (0x01). Este byte sinaliza cmeç de um datagrama. O segund byte, cuj valr pde ser aqueles da cluna Valr na tabela acima, infrma tip de dad cntid n camp Dads. O terceir byte indica cmpriment, em bytes, d camp Dads. Cm camp Cmpriment ds Dads é cmpst de apenas um byte, mair cmpriment pssível para camp Dads é 255 (mair valr pssível em apenas um byte). O quart camp cntém s dads prpriamente dits e seu cmpriment é aquele infrmad n terceir byte. O quint camp deve cnter valr 4 (0x04) e indica fim d datagrama. Este camp pde ser utilizad para checar se um datagrama cmplet fi recebid. As infrmações cntidas n camp Dads d datagrama sã frmatadas cnfrme a descriçã a seguir: Dads Char: crrespnde a apenas um caractere imprimível da tabela ASCII (http://en.wikipedia.rg/wiki/ascii). O cmpriment deste tip de dad será sempre 1 byte e seu valr será valr decimal crrespndente a caractere na tabela ASCII; Dads Int: cntém um valr inteir de 16 bits entre -32768 e 32767. O cmpriment deste tip de dads será sempre 2 bytes (little-endian: http://en.wikipedia.rg/wiki/endianness) que, quand cmbinads, cnstituem valr inteir enviad; Dads Byte: crrespnde a um inteir sem sinal de 8 bits entre 0 e 255. A inserir um valr d tip byte n painel de cmands d BitVicer (lcalizad lg abaix d cnstrutr de sentenças), deve-se seguir seguinte frmat: b00000000, nde 0 pde ser 0 u 1 (exempls de cmands d BitVicer n item 5.3); Dads String: crrespnde a uma sequência de caracteres cuj cmpriment máxim varia em funçã da direçã da cmunicaçã. Pr causa da limitaçã de tamanh d buffer de entrada de alguns micr-cntrladres, a mair sequência de caracteres que pde ser enviada para micr-cntrladr é igual a 59 caracteres. N sentid cntrári, quand uma string é enviada a BitVicer, mair cmpriment da sequência de caracteres está limitad a tamanh máxim d camp Dads d prtcl BitVicer (255 caracteres). O valr de cada caractere será valr decimal crrespndente a caractere na tabela ASCII (http://en.wikipedia.rg/wiki/ascii); Dads Cmand: este tip de dad nã deve ser cnfundid cm s cmands enviads a micr-cntrladr em respsta a um recnheciment válid e cuj cnteúd é definid pel usuári (item 5.3). Atualmente, BitVicer envia apenas dis valres d tip cmand a micrcntrladr: Start Sampling (Iniciar amstragem) e Stp Sampling (Parar amstragem). Este cmand é enviad apenas pela ferramenta Calibraçã de Áudi Streaming (item 3.4.2) e Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 19
cnterá valr 1 (0x01) para iniciar a amstragem u valr 0 (0x00) para encerrar a amstragem; Dads Status: um datagrama cm este tip de dad é enviad sempre que se inicia u se encerra mtr de recnheciment de vz. A iniciar recnheciment de vz através d btã Start d Editr de Esquemas de Vz (item 4.1), valr 1 (0x01 Engine Running) é empactad em um datagrama e enviad a micr-cntrladr. A clicar n btã Stp, valr 0 (0x00 Engine Stpped) é enviad da mesma frma. 5.2 Enviand dads a BitVicer O BitVicer mnitra cnstantemente s dads recebids na prta utilizada para se cmunicar cm micr-cntrladr. Os dads recebids nesta prta também devem ser frmatads de acrd cm s parâmetrs d Prtcl BitVicer e seu cnteúd é exibid n painel Mnitr de Cmunicaçã (item 7.2). Smente é pssível enviar a BitVicer dads d tip Char (1 caractere), Int (16 bits), Byte (inteir sem sinal de 8 bits) u String (sequência de caracteres). Cas a captaçã de áudi esteja send feita através de um micrfne cnectad a micr-cntrladr, td dad enviad a BitVicer enquant ele está prcessand flux de áudi, é cnsiderad parte d áudi. Pr esta razã, cas seja necessári enviar dads para exibiçã n Mnitr de Cmunicaçã, é necessári sinalizar a BitVicer para que ele pare de prcessar flux de áudi e passe a manipular s dads recebids cm datagramas. Mais detalhes sbre sinalizaçã n flux de áudi n item 6 deste manual. 5.3 Cmands Os cmands sã dads que BitVicer envia a micr-cntrladr em respsta a um recnheciment de vz. Estes dads sã frmatads em um prtcl própri (cnsulte item 5.1) e pdem ser ds seguintes tips: Byte (byte): um byte escrit n frmat b00000000, nde 0 pde ser 0 u 1. Char (caractere): apenas 1 caractere alfa-numéric. Int (inteir): númer inteir de 16 bits entre -32768 e 32767. String (trech de text): uma sequência de caracteres de n máxim 59 caracteres. O painel de cmands (lcalizad lg abaix d cnstrutr de sentenças) é lcal nde se infrmam s cmands para cada anagrama gerad n Esquema de Vz. A figura abaix mstra um trech d painel de cmands e alguns cmands de exempl: 5.4 Bibliteca BitVicer para Arduin O pacte de instalaçã d BitVicer cntém uma bibliteca pen suce que pde ser utilizada cm referência para desenvlviment de seus sketchs. Vcê também pde usar esta bibliteca diretamente em seu códig para recuperar s dads enviads pel BitVicer e para realizar captaçã de áudi. Esta bibliteca encntra-se dispnível dentr da pasta Library da pasta de instalaçã d BitVicer. Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 20
Para utilizar a bibliteca BitVicer em seu sketch, é necessári cpiar tda a pasta BitVicer11 para a sub-pasta libraries lcalizada dentr da pasta de instalaçã da IDE Arduin. Em seguida, adicine a referência para a bibliteca BitVicer n iníci d códig cm exibid abaix: #include <BitVicer11.h> Para bter maires infrmações sbre cm utilizar uma bibliteca em seus sketches, cnsulte tutrial sbre biblitecas dispnível n site d Arduin (http://arduin.cc/en/hacking/librarytutrial). OBS 1: A bibliteca BitVicer para Arduin fr feita para funcinar cm tdas as bards Arduin excet a bard Arduin Due. OBS 2: Pr padrã, a bibliteca BitVicer utiliza a classe Serial da platafrma Arduin para implementar cmunicaçã serial. Se fr necessári utilizar qualquer utra interface serial (Serial1, Serial2 u Serial3), será necessári substituir tdas as crrências da classe Serial na bibliteca BitVicer pela interface serial desejada. O pnt central da bibliteca BitVicer para Arduin é a classe BitVicerSerial. Esta classe cntém uma série de variáveis e funções utilizadas para se cmunicar cm BitVicer e recuperar dads enviads pel prgrama. Para ter acess as funções desta classe, crie uma instância glbal da classe BitVicerSerial adicinand trech de códig abaix antes das funções setup() e lp() n seu sketch: BitVicerSerial bvserial = BitVicerSerial(); Antes de utilizar a instância da classe BitVicerSerial criada acima, será necessári iniciar a cmunicaçã serial de sua bard Arduin. Para iss, insira trech de códig abaix dentr da funçã setup() de seu sketch: Serial.begin(115200); Lembre-se que a velcidade de cmunicaçã acima deve ser a mesma infrmada nas preferências d BitVicer (item 3.3) cas a cmunicaçã se dê através de prta serial. Neste pnt, tdas as cnfigurações necessárias para cmeçar a interagir cm BitVicer fram cncluídas. Cnsulte tópic a seguir para bter infrmações sbre tdas as variáveis e funções dispníveis na classe BitVicerSerial. O item 5.5 deste manual cntém também dis exempls prátics de cm ligar u desligar um LED cnectad a sua bard. O primeir exempl utiliza captaçã de áudi pel micrfne d cmputadr e segund utiliza um micrfne cnectad a micr-cntrladr. 5.4.1 Referência da bibliteca BitVicer para Arduin Cnstrutr: BitVicerSerial(): retrna uma instância da classe BitVicerSerial cm tdas as variáveis públicas cnfiguradas cm seus valres padrã. Cnstantes: BUFFER_SIZE: cntém valr padrã d buffer intern da classe BitVicerSerial. Valr = 64; BV_DEFAULT: utilizada para cnfigurar a vltagem de referência ns pins de entrada analógica. Valr = 3; BV_EXTERNAL: utilizada para cnfigurar a vltagem de referência ns pins de entrada analógica. Valr = 1; BV_UNDEFINED: pde ser usada para testar tip de dad retrnad pela funçã getdata(). Valr = 0; BV_CHAR: pde ser usada para checar tip de dad retrnad pela funçã getdata(). Valr = 1; Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 21
BV_INT: pde ser usada para checar tip de dad retrnad pela funçã getdata(). Valr = 2; BV_BYTE: pde ser usada para checar tip de dad retrnad pela funçã getdata(). Valr = 3; BV_STR: pde ser usada para checar tip de dad retrnad pela funçã getdata(). Valr = 4; BV_COMMAND: pde ser usada para checar tip de dad retrnad pela funçã getdata(). Valr = 254; BV_STATUS: pde ser usada para checar tip de dad retrnad pela funçã getdata(). Valr = 255; BV_STARTSAMPLING: pde ser usada para checar dad cntid em um datagrama d tip Cmand. Valr = 1; BV_STOPSAMPLING: pde ser usada para checar dad cntid em um datagrama d tip Cmand. Valr = 0; BV_ENGINERUNNING: pde ser usada para checar status d mtr de recnheciment de vz na variável pública enginerunning da classe BitVicerSerial. Valr = 1; BV_ENGINESTOPPED: pde ser usada para checar status d mtr de recnheciment de vz na variável pública enginerunning da classe BitVicerSerial. Valr = 0; Variáveis Públicas: byte bytedata: armazena valr da última leitura feita pela funçã getdata() cas haja algum dad n buffer serial de entrada e cas dad seja d tip byte. Essa variável pde ser acessada e alterada a qualquer mment pel códig d usuári. Default = 0; char chardata: armazena valr da última leitura feita pela funçã getdata() cas haja algum dad n buffer serial de entrada e cas dad seja d tip char. Essa variável pde ser acessada e alterada a qualquer mment pel códig d usuári. Default = 0; int intdata: armazena valr da última leitura feita pela funçã getdata() cas haja algum dad n buffer serial de entrada e cas dad seja d tip int. Essa variável pde ser acessada e alterada a qualquer mment pel códig d usuári. Default = 0; String strdata: armazena valr da última leitura feita pela funçã getdata() cas haja algum dad n buffer serial de entrada e cas dad seja d tip String. Essa variável pde ser acessada e alterada a qualquer mment pel códig d usuári. Default = 0; byte cmddata: armazena valr da última leitura feita pela funçã getdata() cas haja algum dad n buffer serial de entrada e cas dad seja d tip cmand. Essa variável pde ser acessada e alterada a qualquer mment pel códig d usuári. Esta variável só será alterada pela classe BitVicerSerial durante a execuçã da ferramenta de Calibraçã de Áudi Streaming (item 3.4.2). Default = 0; blean enginerunning: armazena valr da última leitura feita pela funçã getdata() cas haja algum dad n buffer serial de entrada e cas dad seja d tip status. Essa variável pde ser acessada e alterada a qualquer mment pel códig d usuári. O valr desta variável será alterad a iniciar u parar mtr de recnheciment de vz (item 4.5). Default = false; Funções: getdata(): realiza uma leitura d buffer de entrada d Arduin, armazena dad existente n datagrama na variável pública crrespndente e retrna tip de dad cntid n datagrama. Se datagrama estiver crrmpid u nã crrespnder a frmat d prtcl BitVicer, s dads d buffer sã descartads até inici d próxim datagrama e a funçã retrna 0 (BV_UNDEFINED). setaudiinput(byte pin): cnfigura Arduin para fazer leituras analógicas rápidas n pin de entrada analógic passad à funçã. Sem a utilizaçã desta funçã, cnversr analógic-digital (ADC) d micr-cntrladr ATMEL trabalha cm um clck Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 22
muit baix. Uma vez que uma precisã de apenas 8 bits é necessária para que BitVicer pssa analisar flux de áudi recebid, aumentar clck d cnversr ADC nã causa prejuíz à precisã d cnversr e trna pssível a btençã de pel mens 8000 amstras pr segund. undaudiinput(): retrna as cnfigurações d cnversr ADC para s padrões riginais de fábrica. setanalgreference(byte mde): altera a vltagem de referência a ser utilizada pel cnversr analógic-digital. Pr padrã, as bards Arduin utilizam 3.3 u 5 vlts cm vltagem de referência nas medições feitas pel ADC. Se fr utilizada qualquer vltagem de referência cnectada a pin AREF, brigatriamente, deve-se chamar esta funçã passand a cnstante BV_EXTERNAL cm parâmetr antes de chamar a funçã setaudiinput() u prcessaudi(). Se iss nã fr feit, a vltagem de referência interna d Arduin e a vltagem recebida em AREF causarã um curtcircuit que pde danificar sua bard. startstplistening(): sinaliza a BitVicer para iniciar u parar de cnsiderar s dads recebids d micr-cntrladr cm flux de áudi. Antes de iniciar a transmissã de flux de áudi, é necessári chamar esta funçã para que BitVicer passe a direcinar áudi recebid para mtr de recnheciment de vz e nã para painel Mnitr de Cmunicaçã. Uma vez iniciada a transmissã de áudi, para enviar qualquer dad a ser exibid n Mnitr de Cmunicaçã, é necessári chamar esta funçã para que BitVicer deixe de cnsiderar s dads recebids cm flux de áudi e direcine s dads para Mnitr de Cmunicaçã. Se ist nã fr feit, qualquer infrmaçã recebida pel BitVicer enquant ele estiver prcessand flux de áudi, será cnsiderada áudi e enviada a mtr de recnheciment de vz. O sinal enviad a BitVicer cnsiste em uma sequencia de bytes cm s seguintes valres: {255, 255, 255, 255, 0, 0, 0, 0}. prcessaudi(unsigned int wait): realiza uma leitura rápida n pin analógic passad à funçã setaudiinput(). O valr passad a esta funçã é temp que a funçã irá esperar antes de realizar uma leitura e deve ser infrmad em micrssegunds (1 micrsegund = 1000 milisegunds). Este temp deve ser utilizad para calibrar as tmadas de mediçã de md que se atinja valr mais próxim pssível de 8000 leituras pr segund. Assim que a mediçã estiver cmpleta, esta funçã envia a BitVicer valr da mediçã (1 byte valr 0 a 255). Pr esta razã, esta funçã deve ser chamada em intervals regulares de temp a fim de evitar distrções n áudi digitalizad. sendtbv(var data): empacta dad passad a ela em um datagrama d BitVicer e envia esta infrmaçã a BitVicer a fim de exibi-la n Mnitr de Cmunicaçã. Os dads aceits sã d tip char, byte, int u String. Cas esteja send prcessad flux de áudi, é necessári chamar a funçã startstplistening() antes e depis desta funçã. 5.5 Exempls de utilizaçã da bibliteca BitVicer 5.5.1 Áudi captad pel micrfne d cmputadr N exempl abaix, um LED cnectad a pin digital 4 d Arduin irá acender u apagar em respsta a um cmand captad pel micrfne d cmputadr. Primeir, cnecte seu Arduin cnfrme indicad na figura abaix: Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 23
Em seguida, cpie e cle sketch abaix na IDE Arduin e envie códig para a bard. Lembre-se que é precis cpiar a pasta cntend s arquivs da bibliteca BitVicer para a pasta library da IDE Arduin antes de cmpilar e enviar seu sketch (cnsulte item 5.4). //Imprts the BitVicer library t the sketch #include <BitVicer11.h> //Instantiates the BitVicerSerial class BitVicerSerial bvserial = BitVicerSerial(); //Stres the data type retrieved by getdata() byte datatype = 0; //Stres the state f pin 4 byte pinval = 0; vid setup() { //Starts serial cmmunicatin at 9600 bps Serial.begin(9600); //Sets digital pin 4 as OUTPUT pinmde(4, OUTPUT); //Turns ff pin 4 digitalwrite(4, pinval); } vid lp() { Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 24
} //Updates the state f pin 4 n every lp digitalwrite(4, pinval); //This functin runs every time serial data is available //in the serial buffer after a lp vid serialevent() { //Reads the serial buffer and stres the received data type datatype = bvserial.getdata(); } //Checks if the data type is the same as the ne in the //Vice Schema if (datatype == BV_BYTE) { //Checks the stred value in bytedata by getdata() and //changes the value f the pin if (bvserial.bytedata == 0) pinval = LOW; else pinval = HIGH; } Pr fim, abra esquema de vz Sample2.vsc, lcalizad na sub-pasta ViceSchemas da pasta de instalaçã d BitVicer, e clique em Start para iniciar recnheciment de vz. O LED cnectad à bard Arduin deverá se acender a prnunciar turn led n" e se apagar a prnunciar turn led ff. Cas nã haja mudança n estad d LED a prnunciar s cmands acima, certifique-se que: Vcê selecinu Inglês cm idima de recnheciment n frmulári de preferências. Se idima Inglês nã está dispnível em seu cmputadr, selecine idima de sua preferência e traduza a frase n Esquema de Vz para idima selecinad; As cnfigurações de cmunicaçã estã crretas n frmulári de preferências (item 3.3); A velcidade de cmunicaçã (baud rate) é a mesma n sketch Arduin e n frmulári de preferências; O áudi captad pel micrfne d cmputadr está em um nível adequad para recnheciment (itens 3.2.3 e 7.1). 5.5.2 Áudi captad pr um micrfne cnectad a micr-cntrladr N exempl abaix, um LED cnectad a pin digital 4 d Arduin irá acender u apagar em respsta a um cmand captad pr um micrfne ligad à bard Arduin. O micrfne utilizad é micrfne electrec da Sparkfun (BOB-09964 - https://www.sparkfun.cm/prducts/9964). Primeir, cnecte seu Arduin cnfrme indicad na figura abaix: Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 25
Observaçã imprtante: nte na ligaçã acima que pin de 3.3 vlts d Arduin está send utilizad cm vltagem de referência (AREF) para cnversr analógic-digital (ADC). Esta cnfiguraçã se fez necessária, pis, embra micrfne electrec da Sparkfun funcine em vltagens de 2.7V a 5.5V, nã fi pssível bter leituras satisfatórias cm este micrfne cnectad diretamente à fnte de 5 vlts d Arduin. Fi necessári cnectar micrfne à fnte de 3.3 vlts da bard e cnectar AREF (referência analógica) à mesma fnte de 3.3 vlts. Dessa frma, fi pssível bter leituras em td espectr de valres de 8 bits (0 a 255) cm leituras em ambiente silencis sciland entre 128 e 129. Atencã: nã utilize a funçã analgread() d Arduin cm qualquer vltagem de referência cnectada à AREF. Iss pde danificar sua bard se a funçã analgreference() nã fr chamada anterirmente. N códig abaix, a funçã setanalgreference() da bibliteca BitVicer é chamada para cnfigurar adequadamente a vltagem de referência para cnversr ADC d Arduin. Essa funçã DEVE ser chamada antes de qualquer utra funçã da classe BitVicerSerial cas esteja send aplicada qualquer vltagem à AREF. Em seguida, cpie e cle sketch abaix na IDE Arduin e envie códig para a bard. Lembre-se que é precis cpiar a pasta cntend s arquivs da bibliteca BitVicer para a pasta library da IDE Arduin antes de cmpilar e enviar seu sketch (cnsulte item 5.4). //Imprts the BitVicer library t the sketch #include <BitVicer11.h> //Instantiates the BitVicerSerial class BitVicerSerial bvserial = BitVicerSerial(); //Stres the data type retrieved by getdata() byte datatype = 0; Cpyright BitSphia Sftware Ltda. 2013. Tds s direits reservads. 26