Home

EasyVR

1. Figure 3 Conflicting commands The current status is displayed in the EasyVR Commander list view where groups that already contain commands are highlighted in bold The selected group of commands can also be tested by using the icon on the toolbar or the Tools menu to make sure the trained commands can be recognized successfully Note If you want to re train a command you have to erase the previous training first Note Vocal passwords group 16 are much more sensitive to environment noise and distance from the microphone be sure to train and give the password in similar conditions User Manual 2 3 EasyVR 29 Y wN VeeaR www veear eu Download a new Sound Table The EasyVR can also play one of the sounds or sentences saved on the internal flash memory A predefined beep sound is also always available even when no sounds have been downloaded to the module The custom sounds are organized in a so called sound table that users can prepare and build with the special QuickSynthesis tool Please refer to this application s own manual for details about creation of a sound table Once the sound table has been created it can be processed by the EasyVR Commander and downloaded to the module The user must first disconnect from the module and do the steps required to start it in boot mode see the section FLASH UPDATE Now the command Update Sound Table is enabled either on the toolbar
2. 16 2 see appendix In reply to CMD RECOG SI CMD RECOG SD CMD TRAIN SD CMD PLAY SX STS INVALID v 76h Invalid command or argument In reply to Any invalid command or argument STS TIMEOUT T 74h Timeout expired In reply to CMD RECOG SI CMD RECOG SD CMD TRAIN SD 16 EasyVR User Manual 2 3 v N WWW Veear eu VeeaR STS INTERR 69h Interrupted recognition In reply to CMD BREAK while in training recognition or playback STS SUCCESS o 6Fh OK or no errors status In reply to CMD BREAK CMD DELAY CMD BAUDRATE CMD TIMEOUT CMD KNOB CMD LEVEL CMD LANGUAGE CMD SLEEP CMD GROUP SD CMD UNGROUP SD CMD ERASE SD CMD NAME SD CMD RESETALL CMD QUERY IO CMD PLAY SX STS RESULT T 72h Recognised SD SV command or Training similar to SD SV command 1 Command position 0 31 In reply to CMD RECOG SD CMD TRAIN SD STS SIMILAR s 73h Recognised SI word or Training similar to SI word 1 Word index 0 31 In reply to CMD RECOG SI CMD RECOG SD CMD TRAIN SD STS OUT OF MEM m 6Dh Memory error no more room for commands or sound table not present In reply to CMD GROUP SD CMD DUMP SX STS ID X 78h Provide firmware identification 1 Version identifier 0 In reply to CMD_ID STS_PIN p 70h Provide pin input status 1 Logic level 0 input low 1 input high In reply to CMD QUERY IO STS TABLE SX d 64h Provide sound table data 1 2 Two 5 bit values that fo
3. H W www veear eu VeeaR VeeaR TIGAL KG all right reserved All VeeaR branded boards and software are designed and manufactured by RoboTech srl 2 ROBO e ECH Srl Edutainment Robots and more RoboTech srl and TIGAL KG assume no responsibility for any errors which may appear in this manual Furthermore RoboTech srl and TIGAL KG reserve the right to alter the hardware software and or specifications detailed herein at any time without notice and does not make any commitment to update the information contained herein RoboTech srl TIGAL KG products are not authorized for use as critical components in life support devices or systems User Manual 2 3 EasyVR 33
4. EIE 17 Bell lee nz circ 18 Recommended wake up procedure esee nsn ninh nnns nna rines nean nnns nennen 18 Recommended setup Grocedure nennen nennen nnnn nnn nns nna nnne risks antris snas anra annes 18 Recognition of a built in Sl command l nennen nnnan nn esnni nnns nna sir s sna arse sa sinis 19 Adding a new SD Command EEN 19 Traning an SD commands EE 20 Recognition of an SD command EE 20 Read used command groupe 21 Read how many commands in a group sss sese eee eee eee 21 Read a user defined commande 21 Use general purpose V O d e ET 22 Use custom Sound h er ere ascsiiseiisetiik ainiin Ana eiea AE Erie A a aea E TERRE n ena Easain 22 Read Sound ie 23 Built in Command R 24 ENO COGS ERE E eee rene cele dome eateenmeeieeeetseuaicamuseeeanacadnawaceacennnedeuesueneceasens 25 Bee el INS ASE TE 26 E SVVR eu Le EE 27 CS TEI lS Le EEN 27 EE iio es O ERR T 28 Download anew Sound WR Ee EEN 30 How to gel Suppor c 32 2 EasyVR User Manual 2 3 H MN WWW Veear eu VeeaR Product Description EasyVR is the second generation version of the successful VRbot Module It is a multi purpose speech recognition module designed to easily add versatile robust and cost effective speech recognition capabilities to virtually any application The EasyVR module can be used with any hos
5. END IF NEXT UAY THEN FE EIES ax cce Oh Use general purpose I O pins sr See WOl o Tota ceo lhoeie low Lewell SEND q SEND B SEND A IF RECEIVE o THEN OK ELSE ERROR s xe 02 Teig b dixere arose wel SEND q SEND C SEND B IF RECEIVE o THEN OK ELSE ERROR set IO2 pin as SEND q SEND C SEND D iP NOT EE S THEN ERROR ack and read logic level SIND pum leval FECEIVET MTA set IO3 pin as high impedance input SEND q SEND D SEND C US DG Jed ED EE IHEN ERROR SS Use custom sound playback play a beep at full volume SENDET wi SEND A SEND A SENDANTE Lee Cry E TD TOO TELS E ERROR SEXES meno NT E ebe TN S SIE H SI SN D vcn EE Ee reading state is optional works with any or no table SIND V SEND Up d SmI EEE TE RECEIE USL THEN OF In Eja ERROR 22 EasyVR User Manual 2 3 WWW Veedr eu VeeaR play entry 123 3 32 26 SIND ye SEND TAT F gt SENDA AT e SEND TAT REFEREE ITE E EEN O ETE S T ele Read sound table dump sound table at max volume SEND SI EE EE read count of entries and name length SE Count PE ETET MAD a SENDE Count eo s LEE ER SENDE length RECEIVE A OC meme Yet IOS m D UO Eee egre co a E HIE label i RECEIVE NEXT User Manual 2 3 EasyVR 23 VeeaR WWW Veedr eu Built in Command Sets In the tables below a list of all built in commands for e
6. and read result SENDET Command RECE TVE TTA TS come cue eccle cM Co e ea Bec ccu EMEN 20 EasyVR User Manual 2 3 WWW Veedr eu timed out no word spoken Rios IF sesule e THEN error code ack and read which one END DN Crror ORIG BI MES VANE ee ING SUE ME Error error RECEIVE TAT EE ek ona SS i NN eo e OS ELDE invalid request or reply ERROR END IF Read used command groups request mask of groups in use SEND ine SEET lee read mask to 32 bits variable ut lia ERE cn E eee SENDTE mask RECEIVE TAT DENDA v Y mask mack EIC EIVE TAD SENDET Mas eE EE SENDE mask mask PECEIVE TAD 2 Die SE Read how many commands in a group Tose quest Command count tee dote ise SEND E SEND UP ID I EEN Mele de Ces coke nies aclae oun Siti Count RECEIVE AT Read a user defined command m cumo Conen O n oo NE SEND p SEND bs SEND As TE INO IRC Ib Wu Vey THEN ERROR read command data SEND M M Eeer EE Pex race tkaining Coume EE TE COUN Eent AND 7 a completely trained command ime MEGA pmlc for Con lieto eub oue T cal Elte deua DS ANID 24 EE Ee EE EE SENDE conillet PREC EIE A User Manual 2 3 EasyVR VeeaR 21 VeeaR www veear eu read label length SEND vo os length RECEIVE read label text Ett Qo MO Esp c MR SEND v n Kobe maS PE EIE decode digits Ir labeli ne SENDE labeli e
7. arr te salut a gauche a droite vers le baut vers le bas en avant en arri re z ro un deux trois quatre cinq SIX sept huit neuf dix 24 EasyVR User Manual 2 3 WWW Veedr eu Error codes In the table below a list of some the most useful error codes that may be returned by training or recognition commands 03h ERR DATACOL TOO NOISY too noisy 04h ERR DATACOL TOO SOFT spoke too soft 05h ERR DATACOL TOO LOUD spoke too loud 06h ERR DATACOL TOO SOON spoke too soon 07h ERR DATACOL TOO CHOPPY too many segments too complex 11h ERR RECOG FAIL recognition failed 12h ERR HRECOG LOW CONF recognition result doubtful 13h ERR HECOG MID CONF recognition result maybe 14h ERR HECOG BAD TEMPLATE invalid SD SV command stored in memory 17h ERR HECOG DURATION bad pattern durations 4Ah EHH SYNTH BAD VERSION bad release number in speech file 4Eh ERR SYNTH BAD MSG bad data in speech file or invalid compression 80h ERR NOT A WORD recognized word is not in vocabulary The first group of codes 03h 07h are due to errors in the way of speaking to the EasyVR or disturbances in the acquired audio signal that may depend on the surrounding environment The second group 11h 13h indicate an insufficient score of the recognized word from lowest to highest Acceptance of lower score results may be allowed by lowering the knob or level settings respectively for built in and custom c
8. group 1 pos 2 define CMD RECOG SD d do sd recog at group D 0 trigger mixed si sd define CMD ERASE SD e reset command at group lt I gt pos 2 define CMD NAME SD n label command at group D pos 2 with length 3 name 4 n define CMD COUNT SD c get command count for group 1 define CMD DUMP SD p read command data at group lt I gt pos 2 define CMD MASK SD m get active group mask define CMD RESETALL r vd reset all commands and groups define CMD ID x get version id define CMD DELAY y set transmit delay 1 log scale define CMD BAUDRATE a sef baudrate b bit time 123115200 define CMD QUERY IO q configure read or write I O pin I of type 2 define CMD PLAY SX w wave table entry 1 2 10 bit playback at volume 3 define CMD DUMP SX h dump wave table entries define STS MASK k mask of active groups 1 8 define STS COUNT c count of commands f define STS AWAKEN w back from power down mode define STS DATA d provide training lt 1 gt conflict 2 label 3 35 counted string define STS ERROR e signal error code 1 2 define STS INVALID v invalid command or argument define STS TIMEOUT t timeout expired define STS INTERR i back from aborted recognition see break define STS SUCCESS o no errors status define STS RESULT r recognised sd command
9. or the Tools menu and it can be used to start the update process C EasyVR GUI v2 1 8 Seles l y Sour P E Update Sound Table Build Sound Table n 43 Processing sound table Demo wie Group Group s Label END ahooga DND alarm SND burp SND calling whistle DND dock DND explosion SND gong SND horn toy hon SND avon SND photo shutter Group Group Group Group Group Group Group Group Password Wordset Wordset Wordset SoundTa Build and download a new sound table Figure 4 GSB 669 J mt M a TEE E E E GC E E E E E I E Er E E E Ea G G G B First the user will be prompted to open the QuickSynthesis project file just created and a new sound table will be generated The project must have been built already with the QuickSynthesis tool before the sound table generation can be completed successfully If a recent build is not available the user will receive a warning message the project can be opened in QuickSynthesis again and a fresh build started make sure the project file has been saved before the build Once back in the EasyVR Commander the project can be reloaded by pressing the Refesh button If the 30 EasyVR User Manual 2 3 y N WWW Veear eu VeeaR process completes successfully the Download button will be enabled and the flash update process can Start The download process will connect at a higher speed to the EasyVR module so the bridge p
10. 1 training similar to sd 1 define STS SIMILAR s recognised si lt D in mixed si sd training similar to si I define STS OUT OF MEM m no more available commands see group define STS ID x provide version id 1I define STS PIN p return pin state I define STS TABLE SX h provide table count 1 2 10 bit name 3 35 counted string protocol arguments are in the range 0x40 1 to Ox60 31 inclusive define ARG MIN 0x40 define ARG MAX 0x60 define ARG ZERO 0x41 define ARG ACK 0x20 to read more status arguments tendit PROTOCOL_H 26 EasyVR User Manual 2 3 Y N WWW Veear eu VeeaR EasyVR Commander The EasyVR Commander software can be used to easily configure your EasyVR module connected to your PC through an adapter board or by using the microcontroller host board with the provided bridge program available for ROBONOVA controller board Arduino 2009 UNO Parallax Basic Stamp The user can define groups of commands or passwords and generate a basic code template to handle them It is required to edit the generated code to implement the application logic but the template contains all the functions or subroutines to handle the speech recognition tasks Getting started Connect the adapter board or a microcontroller host board with a running bridge program to your PC then check that all devices are properly turned on and start the EasyVR Commander
11. ESS CMD RECOG SI T 69h Activate SI recognition from specified wordset 1 Wordset index 0 3 Expected replies STS SIMILAR GIG TIMEOUT STS ERROR CMD TRAIN SD T 74h Train specified SD SV command 1 Group index 0 trigger 1 15 generic 16 password 2 Command position 0 31 Expected replies STS SUCCESS STS RESULT GIG SIMILAR STS TIMEOUT STS ERROR CMD GROUP SD g 67h Insert new SD SV command 1 Group index 0 trigger 1 15 generic 16 password 2 Position 0 31 Expected replies STS SUCCESS STS OUT OF MEM CMD_UNGROUP_SD u 75h Remove SD SV command 1 Group index 0 trigger 1 15 generic 16 password 2 Position 0 31 Expected replies STS SUCCESS CMD_RECOG SD d 64h Activate SD SV recognition 1 Group index 0 trigger 1 15 generic 16 password Expected replies STS RESULT STS SIMILAR STS TIMEOUT STS ERROR CMD_ERASE SD e 65h Erase training of SD SV command 1 Group index 0 trigger 1 15 generic 16 password 2 Command position 0 31 Expected replies STS SUCCESS User Manual 2 3 EasyVR 13 VeeaR CMD_NAME_SD n 6Eh Label SD SV command 1 Group index 0 trigger 1 15 generic 16 password 2 Command position 0 31 3 Length of label 0 31 4 n Text for label ASCII characters from A to Expected replies STS SUCCESS CMD COUNT SD CG 63h Request count of SD SV commands in the specified group 1 Group index 0 trig
12. OMO TRAIN T AE EAE EO AT EEOAE E 13 S PECIOU IE eege 13 S BEU CIS LE DNER 13 CND RECOG SD cr 13 esc EDAM 13 euBN I MD 14 Ine 8 UB D 14 SUBEIS U eoo c o 14 CND MAR TTT 14 CMO RE EE 14 GME Eege 14 CMO DELAY 14 CMD BAUDRA geet 15 CMD OUER Y sere E 15 OMD PEAT eege 15 OMD DUMP DX aenieei EREE ee ee ee eee eee 15 EE SI SNS M 16 SER u e DTE M 16 cIEAQcesgpem UM 16 User Manual 2 3 EasyVR 1 Y MN VeeaR www veear eu ANAREN 16 FO eP 16 s E2109 c 16 SECH OR e p E 16 I 16 EE c T He 17 ES eec S 17 o RESULT 17 oTo INICA WEE 17 Ao OUT OR E 17 Se Eeer 17 SIE e 17 SIE
13. Select the serial port to use from the toolbar or the File menu then go with the Connect command C EasyVR GUI v2 1 6 Sele File Edit Tools Serial Port to use Connect button Figure 1 Main application window There are four kinds of commands in the software see Figure 1 and Figure 3 e Trigger is a special group where you have the built in SI trigger word Robot and you may add one user defined SD trigger word Trigger words are used to start the recognition process e Group where you may add user defined SD commands e Password a special group for vocal passwords up to five using Speaker Verification SV technology e Wordset built in set of SI commands for instance in Figure 1 above the Wordset 1 is selected On some systems the EasyVR Commander can automatically upload the bridge program to the host board once connected That applies to Robonova controller board and Parallax Basic Stamp User Manual 2 3 EasyVR 27 Y N VeeaR www veear eu Speech recognition The recognition function of the EasyVR works on a single group at a time so that users need to group together all the commands that they want to be able to use at the same time When EasyVR Commander connects to the module it reads back all the user defined commands and groups which are stored into the EasyVR module non volatile memory The user can add a new command by first selecting the group in which the command need
14. Y eea User Manual Helease 2 3 www veear eu Y MN WWW Veear eu VeeaR Table of Contents OCU 0 BO eLa C 3 EasyVR features TT 3 Technical specificat ONS MERE RETE a o mm 4 Physical dimensions and pin assignment sees eee eee eee eee ee 4 Recommended Operating Conditions nennen nnne nennen nnns nn naar nnns nar nnns 5 Selen Te e 5 Power Supply Requirements see ee eee eee eee 5 OS lel len Te N E E A T E AE AO A A E A E E I A N 5 Tene slris srne oe e EE EEA E E EE T E E 6 PI o D EE A EE EE 7 eua FUO SA ee 7 Usea pinasan Te EE 7 Usea pinas ab e DE 8 SEKR leie NE 9 Communicalion d pe oe1o EE 10 BAO 10 ee lune IWAN IG ENTE ERNEUT t 11 cm 11 1916 c 11 ARG As 0MRMMETTT 11 E TM H 11 Sei n a abi ARR U M 12 E 12 QIDE ZR E 12 esae 12 CND Mi U M E m 12 GME LANGUAGE 12 CMD TIMEOUT THE 13 CND REC COG EE 13
15. ach supported language along with group index trigger or wordset command index and language identifier to use with the communication protocol Trigger Wordset Index 0 0 sch O OCF PP Go M CH OAN OA PWN 0 0 P Ga ND mk 0 Command English US robot action move turn run look attack stop hello left right up down forward backward zero one two three four five SIX seven eight nine ten 1 Italian robot azione val gira corri guarda attacca fermo ciao a sinistra a destra in alto in basso avanti indietro zero uno due tre quattro cinque sei sette otto nove dieci LA oh BON LH Japanese Hub y27a3 ED Hhh ZEIL aA UE Eh c Aul SI D Language 3 Romaji German robotto roboter acution aktion susu me gehe magare wende hashire lauf miro schau kougeki attacke tomare halt konnichiwa hallo hidari nach links migi nach rechts ue hinauf shita hinunter mae vorw rts ushiro ruckwarts zero null ichi eins ni zwei san drei yon vier go f nf roku sechs nana sieben hachi acht kyu neun Jyuu zehn 4 Spanish robot acci n mu vete gira corre mira ataca para hola a la izquierda a la derecha arriba abajo adelante atr s Cero uno dos tres cuatro Cinco Seis siete ocho nueve diez 5 French robot action bouge tourne cours regarde attaque
16. also be connected to an external audio amplifier to drive lower impedance loudspeakers Note Connecting speakers with a lower impedance directly to the module may permanently damage the EasyVR audio output or the whole module It is possible to connect higher impedance loads such as headphones provided that you scale down the output power according to the speaker ratings for example using a series resistor The exact resistor value depends on the headphone power ratings and the desired output volume usually in the order of 10kQ Note Connecting headphone speakers directly to the EasyVR audio output may damage your hearing General Purpose UO Since the EasyVR communication interface takes two pins of the host controller a few spare I O pins are provided that can be controlled with the communication protocol to get those pins back for basic tasks such as lighting an LED The three I O pins 101 103 are connected directly to the embedded microcontroller on the EasyVR module so they are referenced to the internal 3 0V regulated power supply If you need to interface to circuits using a different supply there is a number of solutions you can adopt Some of these are outlined below here IOn indicates any one of the three I O pins of the EasyVH Use a pin as an output All the I O pins are inputs with weak internal pull up after power on You must explicitly configure a pin before you can use it as an output see the example cod
17. cimal 41 Stop Idle OV See also chapter COMMUNICATION PROTOCOL later on this manual for communication details User Manual 2 3 EasyVR 5 Y N VeeaR www veear eu Microphone The microphone provided with the EasyVR module is an omnidirectional electret condenser microphone Horn EM9745P 382 e Sensitivity 38dB OdB 1V Pa 1KHz e Load Impedance 2 2K e Operating Voltage 3V e Almost flat frequency response in range 100Hz 20kHz If you use a microphone with different specifications the recognition accuracy may be adversely affected No other kind of microphone is supported by the EasyVR Note Vocal commands should be given from about 60cm from the microphone but you can try at greater distances by talking louder Please note that improper acoustic positioning of the microphone will reduce recognition accuracy Many mechanical arrangements are possible for the microphone element and some will work better than others When mounting the microphone in the final device keep in mind the following guidelines 1 Flush Mounting The microphone element should be positioned as close to the mounting surface as possible and should be fully seated in the plastic housing There must be no airspace between the microphone element and the housing Having such an airspace can lead to acoustic resonance which can reduce recognition accuracy 2 No Obstructions Large Hole The area in front of the microphone elemen
18. de after power on To initiate communication send any character to wake up the module 10 EasyVR User Manual 2 3 H MN www veear eu VeeaR Arguments Mapping Command or status messages sent over the serial link may have one or more numerical arguments in the range 1 to 31 which are encoded using mostly characters in the range of uppercase letters These are some useful constants to handle arguments easily ARG MIN 40h Minimum argument value 1 ARG MAX 60h Maximum argument value 31 ARG ZERO A 41h Zero argument value 0 ARG ACK 20h Head more status arguments Having those constants defined in your code can simplify validity checks and the encoding decoding process For example in pseudo code T encode volve PIVE gt Ss Sr ARG ZERO decode volus 5 EA ARG ZERO 5 validity check IF ARG lt ARG MIN OR ARG gt ENG MURS THEN ERROR Just to make things clearer here is a table showing how the argument mapping works ASCII Q A B C u AAT Z YA T Bs T NM HEX 40 41 42 43 59 5A 5B 5C 5D sl oF 60 Value 1 0 1 2 24 25 26 2 28 29 30 31 User Manual 2 3 EasyVR 11 Y N VeeaR www veear eu Command Details Format of command strings accepted by the module Please note that numeric arguments of command requests are mapped to upper case letters see above section CMD_BREAK Abort recognition training or playback in progress if any o
19. e USE GENERAL PURPOSE l O PINS User Manual 2 3 EasyVR 7 Y N VeeaR www veear eu O AC MAINS Inverted Voltage OUT Switched Load SE I O pin directly driving a I O pin connected to high I O pin switching a load on a high voltage low current LED impedance 5V circuit such as line using a 12V relay MCU input pin The exact components values in these circuits may vary You need to calculate required values for your application and choice of components For example resistor value for the LED circuit can be calculated approximately as Vou B Vuen Rm LED m Where Vi cn is the LED forward voltage as reported on the LED datasheet at the driving current lop see section ELECTRICAL CHARACTERISTICS Let s assume a typical low current LED has a V 1 8V at 5mA the resistor value is 2 4 1 8 Boo Ec 1200h LED 0 005 m Now stay on the safe side and choose a slightly larger resistor such as 150 Ohm If you want to drive higher current LEDs you need a circuit like the second one where you put the LED between the output resistor and the collector of the NPN transistor Use a pin as an input All the I O pins are inputs with weak internal pull up after power on or reset You may also configure the pin to have a strong pull up or no pull up at all see the example code USE GENERAL PURPOSE l O PINS Isolated IN optional filler o SWITCH optocoupler I O p
20. ed wake up procedure wake up or interrupt recognition or do nothing s USe me Tene I Om ere tli mom EE DES E DO SIEIN IDE es COLO TEES ht Gian ii son Recommended setup procedure ak firmare 306 SEND x IF NOT RECEIVE x THEN ERROR send ack and read status expecting id 0 SEND Ti id RECRIVE IF id A THEN it s a VRbot ELSE abel a DEN it s an EasyVR ELSE next generation END iP set language for SI recognition Japanese DEND VE v XE BIEL Vv ER RECEIVE SENSORS Fish ERROR eee teneo 5 Seele SENDERO SE B D EI IE T RECRIVE e DEE 18 EasyVR User Manual 2 3 Y N www veear eu VeeaR Recognition of a built in SI command EE e aia eea l SENDAN SENDETID wait for reply if 5s timeout has been set wait for max 6s then abort i oae EE oue eeoa ERER ae mets HAZ 2 result RECEIVE IF result s THEN 7 SUCCESS ul eso om ack and Gead cesult SENDE Command RECEIVE UA i excuso Oe Ton ETT EL mec EB timed out no word spoken ELSE IF result e THEN TCL LOL code eck ame neac which ome SENDER Error SENDAN Error error RECEIVE UNS i Perom actions a EI eO E ELSE invalid request or reply ERROR ENDETE SEN De Adding a new SD command te oisi Eegen 0 iin nnen S SEND g SEND D SEND A IF RECEIVE o THEN OK ELSE ERROR t set command label to ARDUINO 20097 SEND g CEND c pee SEND AM S NID VU aame Jeexovepcim di9 C
21. evel 4 ETX O Serial Data Transmit level pn Ennen 1 MG BET Microphone reference m 2 MGN OPAC input signal 03 mt e low asynchronous reset tema 100K pulp 03 M mapan TK pudou 0 4 e IO General purpose YOO VDCTILie 5 103 IO General purpose OO VDCTTLie Note the GPIO J4 3 J4 4 and J4 5 are at nominal 3 0VDC level Do not connect 5VDC directly to these pins 4 EasyVR User Manual 2 3 Y WWW Veear eu VeeaR Recommended Operating Conditions symbol rumm wm Typ Max Unit Ta Ambient Operating Temperature Rane SSH ERK sopan naf o weu o SwaPoTammtDma o weu Electrical Characteristics These are applicable to J4 pins only including 101 3 XM and RST symbol rumm wm Typ Max Unt Vu mulae an 00 neu k Int Leakage Ouret O lt Vo lt 0V Hil a 0 ORA Mo wee e Weak Dm KO Wa Power Supply Requirements symbol aane Mn Typ Mc mm oe Separe en Om Serial Interface The EasyVR is a slave module communicating via an asynchronous serial interface commonly known as UART interface with the following features e Baud Rate 9600 default 19200 38700 57600 115200 e Frame 8 Data bits No parity 1 Stop bit The receiver input data line is ERX while the transmitter output data line is ETX No handshake lines are used Example of a serial data frame representing character A decimal 65 or hexade
22. ger 1 15 generic 16 password Expected replies STS COUNT CMD DUMP SD p 70h Read SD SV command data label and training 1 Group index 0 trigger 1 15 generic 16 password 2 Command position 0 31 Expected replies STS DATA CMD MASK SD m 6Dh Request bit mask of non empty groups Expected replies STS MASK CMD RESETALL r 72h Reset all commands and groups R 52h Confirmation character Expected replies STS SUCCESS CMD ID X 78h Request firmware identification Expected replies STS ID CMD DELAY y 79h Set transmit delay 1 Time 0 10 0 10 ms 11 19 20 100 ms 20 28 200 1000 ms Expected replies STS SUCCESS 14 EasyVR www veear eu User Manual 2 3 D MN WWW Veear eu VeeaR CMD BAUDRATE a 61h Set communication baud rate Speed mode 12115200 1 2 57600 3 38400 6 19200 12 9600 Expected replies STS SUCCESS CMD QUERY IO d 71h Configure query or modify general purpose UO pins 1 Pin number 1 pin IO1 2 pin IO2 3 pin 103 Pin mode 0 output low 1 output high 2 input 3 input strong 4 input weak 2 High impedance input no pull up Strong means 10K internal pull up Weak means 200K internal pull up default after power up Expected replies STS SUCCESS mode 0 1 STS PIN mode 2 4 CMD PLAY SX w 6Eh Wave table entry playback 1 2 Two 5 bit values that form a 10 bit index to the sou
23. imelieeds EE EE EEN SEND AT xls E SJEINID eps SEND TU CEND aI SENDT Z OI GREIS SEND S encode each digit with a preii i LOLILOWEC oy time digit uso TT Case leues SD e exu ND VOV SEET Et SEND A us GHE V SEND A User Manual 2 3 EasyVR 19 Y MN VeeaR WWW Veear eu SEND we SE HHE At I eRe CH Vi COSTS ESI TO SE ETE ET ERROR Training an SD command repeat the whole training procedure twice for best results train command 0 in group 3 DEND SEND p SEND TAT wait for reply default timeout is 3s walt for max ls more then abort result RECEIVE Le NGC E wg o HEN training successful OK Bick IRE esu CEN EE ee aSsavied OU bes Olen OMmMa me Ee 7 anokhner SD Command reac which ome SENS a Command ahi Ob LV TAT may notify user and erase training or keep it ELSE I ess bie EREET foie mS E Sce SIUE sO Olen 1 TRIES IKE SUN EE f another SI command always trigger may skip reading SENDE Command RECEIVE UA may notify user and erase training or keep it S SE cs LIMES EE EE EE SO eras ue eard ELSE IF result e THEN error code ack and read which one SEND EE d eX ONES UEBER UE IS EEG SENDE error error RECEIVE TAT t perform actions according tO error ELSE invalid request or reply ERROR ENDTIE Recognition of an SD command EE eon R ET ENDETE SIND VIB wait for reply result RECEIVE EENEG EE EIERE EE ack
24. in connected to a switch I O pin connected 5V source I O pin with isolated input for safety or switching sensor such as MCU output pin circuits All these circuits assume the EasyVR pin has been configured with an internal pull up passive components value can be adjusted to account for weak or strong pull up Disabling the internal pull up could be used to put the pin in high impedance state for example to simulate a tri state or open drain output port 8 EasyVR User Manual 2 3 v N WWW Veear eu VeeaR Again you should refer to the manufacturer s datasheet when interfacing any external components and to calculate required resistors values or other passive components Flash Update The EasyVR module includes a bootloader that allows to update the firmware and to download new sound tables to the on board memory The boot mode is activated by keeping the XM signal to a high logical level at power on or reset This can be easily done with a jumper taking the signal to a suitable pull up resistor To download a firmware update or a sound table to the EasyVR power on the module with the jumper closed For normal operation just leave the jumper open Do not change the jumper position while the module is already powered on It is safe to change XM level while the module is reset RST low Internal 1KQ Pull down O O Jumper Boot mode selection circuit The pull up resistor value to use depe
25. nd table index 1 32 2 3 Playback volume 0 31 0 min volume 15 full scale 31 double gain Expected replies STS SUCCESS STS ERROR CMD DUMP SX h 68h Read wave table data Expected replies GIG TABLE SX STS OUT OF MEM User Manual 2 3 EasyVR 15 Y N VeeaR www veear eu Status Details Replies to commands follow this format Please note that numeric arguments of status replies are mapped to upper case letters see the related section STS_MASK K 6Bh Mask of non empty groups 1 8 4 bit values that form 32 bit mask LSB first In reply to CMD MASK SD STS COUNT CG 63h Count of commands 1 Integer 0 31 In reply to CMD COUNT SD STS AWAKEN w 77h Wake up back from power down mode In reply to Any character after power on or sleep mode STS DATA d 64h Provide command data Training information 1 empty 1 6 training count 8 SD SV conflict 16 SI conflict Known issues 1 In firmware ID 0 command creation deletion might cause other empty commands training count to change to 7 Treat count values of 1 O or 7 as empty training markers Never train commands more than 2 or 3 times 2 Conflicting command position 0 31 only meaningful when trained 3 Length of label 0 31 4 n Text of label ASCII characters from A to In reply to CMD DUMP SD STS ERROR e 65h Signal recognition error 1 2 Two 4 bit values that form 8 bit error code error 1
26. nds on the VCC power supply voltage For the voltage of the XM pin when the jumper is closed short the following relation holds note you have a voltage divider circuit Vy uid V AM R 1K Now if you want XM to be at 3V logic high and solving for R you get V Rpy a 1000 1000 That makes 1000 for 3 3V and around 6800 for 5V power supplies Other kinds of circuit are possible that is just an example and one of the simplest to realize To learn how to download new sound tables to your EasyVR module have a look at the section DOWNLOAD A NEW SOUND TABLE User Manual 2 3 EasyVR 9 Y MN VeeaR www veear eu Communication Protocol Basics Communication with the EasyVR module uses a standard UART interface compatible with 3 3 5V TTL CMOS logical levels according to the powering voltage VCC A typical connection to an MCU based host EasyVR Host MCU 3 3V 5V GND TX RX The initial configuration at power on is 9600 baud 8 bit data No parity 1 bit stop The baud rate can be changed later to operate in the range 9600 115200 baud The communication protocol only uses printable ASCII characters which can be divided in two main groups e Command and status characters respectively on the TX and RX lines chosen among lower case letters e Command arguments or status details again on the TX and RX lines spanning the range of capital letters Each command sent on the TX line with zero or mo
27. ommands see CMD KNOB and CMD LEVEL A third group of codes 14h 17h reports errors in the stored commands that may be due to memory corruption We suggest you check power level and connections then erase all the commands in the faulty group and train them again The fourth group 4Ah 4Eh deals with errors in the compressed sound data either because the wrong version of the QuickSynthesis M tool has been used to generate the sound table or because a not supported compression scheme has been selected or data is generically corrupt The last code 80h means that a word has been recognized that is not in the specified built in sets This is due to how Speaker Independent recognition works and should be ignored User Manual 2 3 EasyVR 25 Y N VeeaR WWW Veear eu Protocol header file This file protocol h can be used with applications written in the C language ifndef PROTOCOL H define PROTOCOL H define CMD BREAK b abort recog or ping define CMD SLEEP s go to power down define CMD KNOB k set si knob D define CMD LEVEL v set sd level I define CMD LANGUAGE l vd sert si language D define CMD TIMEOUT o set timeout lt b gt define CMD RECOG SI i do si recog from ws I define CMD TRAIN SD t train sd command at group lt 1 gt pos 2 define CMD GROUP SD g insert new command at group 1 pos 2 define CMD UNGROUP SD u remove command at
28. r do nothing b 62h Known issues In firmware ID 0 any other character received during recognition will prevent this command from stopping recognition that will continue until timeout or other recognition results Expected replies STS SUCCESS STS_INTERR CMD_SLEEP Se 73h Goto the specified power down mode Sleep mode 0 8 0 wake on received character only 1 1 wake on whistle or received character 2 wake on loud sound or received character 3 5 wake on double clap with varying sensitivity or received character 6 8 wake on triple clap with varying sensitivity or received character Expected replies STS SUCCESS CMD KNOB K Bh Set SI knob to specified level Confidence threshold level 0 4 0 loosest more valid results 1 2 typical value default 4 tightest fewer valid results Note knob is ignored for trigger words Expected replies STS SUCCESS CMD_LEVEL v 76h Get SD level Strictness control setting 1 5 1 easy 1 2 default 5 hard A higher setting will result in more recognition errors Expected replies STS SUCCESS CMD_LANGUAGE T 6Ch Set SI language Language 0 English 1 Italian 1 2 Japanese 3 German 4 Spanish 5 French Expected replies STS_SUCCESS 12 EasyVR User Manual 2 3 v N WWW Veear eu VeeaR CMD TIMEOUT oO 6Fh Set recognition timeout 1 Timeout 1 default O infinite 1 31 seconds Expected replies STS SUCC
29. re additional argument bytes receives an answer on the RX line in the form of a status byte followed by zero or more arguments There is a minimum delay before each byte sent out from the EasyVR module to the RX line that is initially set to 20 ms and can be selected later in the ranges 0 9 ms 10 90 ms 100 ms 1 s That accounts for slower or faster host systems and therefore suitable also for software based serial communication bit banging Since the EasyVR serial interface also is software based a very short delay might be needed before transmitting a character to the module especially if the host is very fast to allow the EasyVH to get back listening to a new character The communication is host driven and each byte of the reply to a command has to be acknowledged by the host to receive additional status data using the space character The reply is aborted if any other character is received and so there is no need to read all the bytes of a reply if not required Invalid combinations of commands or arguments are signalled by a specific status byte that the host should be prepared to receive if the communication fails Also a reasonable timeout should be used to recover from unexpected failures If the host does not send all the required arguments of a command the command is ignored by the module without further notification and the host can start sending another command The module automatically goes to lowest power sleep mo
30. rm a 10 bit count of entries in the sound table count 1 32 2 3 Length of table name 0 31 4 n Text of table name ASCII characters from A to In reply to CMD DUMP SX User Manual 2 3 EasyVR 17 Y N VeeaR www veear eu Communication Examples These are some examples of actual command and status strings exchanged with the EasyVR module by host programs and the expected program flow with pseudo code sequences The pseudo instruction SEND transmits the specified character to the module while RECEIVE waits for a reply character a timeout is not explicitly handled for simple commands but should be always implemented if possible Also the OK and ERROR routines are not explicitly defined since they are host and programming language dependent but appropriate code should be written to handle both conditions Lines beginning with a sharp character are comments Please note that in a real programming language it would be best to define some constants for the command and status characters as well as for mapping numeric arguments that would be used throughout the program to minimize the chance of repetition errors and clarify the meaning of the code See the PROTOCOL HEADER FILE for sample definitions that can be used in a C language environment Here below all the characters sent and received are written explicitly in order to clarify the communication protocol detailed in the previous sections Recommend
31. rogram running on your host device might not work in particular Robonova and Basic Stamp cannot be used for this purpose and you might need a true serial adapter The full speed used is 230400 bit s but the option Slow transfer can be used to reduce it to 115200 One adapter that can go to full speed is the VoiceGP DevBoard Otherwise any USB Serial adapter with TTL CMOS interface can be used for updating the flash After the download completes a new connection can be established with the EasyVR module in normal mode and the new sounds will be displayed by the EasyVR Commander in the special group Sound Table the last one in the list with a yellow icon They can be played back and tested using the Play Sound command on the toolbar or in the Tools menu See also how to do that in your application in the code example USE CUSTOM SOUND PLAYBACK User Manual 2 3 EasyVR 31 Y MN VeeaR WWW Veear eu How to get support Please feel free to contact us with any questions queries or suggestions If your question is about technical support or troubleshooting for one of our products we kindly ask you to first check our Forum for a possible solution http www veear eu If you cannot find an existing solution on the forum we strongly recommend posting your support request on the forum for as quick a response as possible The more detail you provide the better support we can give 32 EasyVR User Manual 2 3
32. s to be created and then using the toolbar icons or the Edit menu A command should be given a label and then it should be trained twice with the user s voice the user will be guided throughout this process see Figure 2 when the Train Command action is invoked Command raining Command 0 of Group 9 ch TEST CMD ZERO Phase 1 2 Press the Phase 1 button and say the word comesponding to the command TEST CMD AERO within seconds Figure 2 Guided training dialog Note after clicking on Phase 1 or Phase 2 buttons remember to start speaking only when you see this little window Speak now If any error happens command training will be cancelled Errors may happen when the user s voice is not heard correctly there is too much background noise or when the second word heard is too different from the first one The software will also alert if a command is too similar to another one by specifying the index of the conflicting command in the Conflict column For example in the following Figure 3 the command TEST CMD ONE sounds too similar to TEST CMD ZERO i e they have been trained with a similar pronunciation Note TEST CMD ZERO and TEST CMD ONE are just examples of labels you should use label names that reflects the real command that you are going to train 28 EasyVR User Manual 2 3 Y N WWW Veear eu VeeaR a EasyVR GUI v2 1 6 Edit Tools TEST CMD ONE TEST CMD TWO
33. t must be kept clear of obstructions to avoid interference with recognition The diameter of the hole in the housing in front of the microphone should be at least 5 mm Any necessary plastic surface in front of the microphone should be as thin as possible being no more than 0 7 mm if possible clear area BAD internal diaphragm 3 Insulation The microphone should be acoustically isolated from the housing if possible This can be accomplished by surrounding the microphone element with a spongy material such as rubber or foam The provided microphone has this kind of insulating foam The purpose is to prevent auditory noises produced by handling or jarring the device from being picked up by the microphone Such extraneous noises can reduce recognition accuracy 6 EasyVR User Manual 2 3 v N WWW Veear eu VeeaR BAD fastened directly absorbent material 4 Distance If the microphone is moved from 15 cm to 30 cm from the speakers mouth the signal power decreases by a factor of four The difference between a loud and a soft voice can also be more than a factor of four Although the internal preamplifier of the EasyVR compensates for a wide dynamic range of input signal strength if its range is exceeded the user application can provide feedback to the speaker about the voice volume see appendix ERROR CODES Audio Output The EasyVR audio output interface is capable of directly driving an 8Q speaker It could
34. t with an UART interface powered at 3 3V 5V such as PIC and Arduino boards Some application examples include home automation such as voice controlled light switches locks or beds or adding hearing to the most popular robots on the market EasyVR features e A host of built in Speaker Independent SI commands for ready to run basic controls in the followings languages o English US ltalian German French Spanish o Japanese e Supports up to 32 user defined Speaker Dependent SD triggers or commands as well as Voice Passwords SD custom commands can be spoken in ANY language Easy to use and simple Graphical User Interface to program Voice Commands and audio Module can be used with any host with an UART interface powered at 3 3V 5V Simple and robust documented serial protocol to access and program through the host board 3 GPIO lines IO1 IO2 IO3 that can be controlled by new protocol commands PWM audio output that supports 8 ohm speakers Sound playback feature O O O O User Manual 2 3 EasyVR 3 Y MN VeeaR WWW Veear eu Technical specifications Physical dimensions and pin assignment PWM z 71 47270101 101 3H O 0L 0003A6 ES a gn ae ag lt gt e KE LE e KE J1 Pinout ETX e ERXe Vvcce GND 45mm Connector Number Name Type Desplon J1 2 veo i Voltage DC input 8 ERX Serial Data Receive TTL l

EasyVR

Contents

Download Pdf Manuals

Related Search

Related Contents