mikroElektronika SpeakUp User Manual

Page 1

The SpeakUp is a speech recognition click™ board. You can set it up to recognize over 200 different voice commands and have the on-board MCU carry them out instantly.

user manual

Page 2

I want to express my thanks to you for being interested in our products and for having

condence in MikroElektronika.

The primary aim of our company is to design and produce high quality electronic products

and to constantly improve the performance thereof in order to better suit your needs.

TO OUR VALUED CUSTOMERS

Nebojsa Matic

General Manager

The STM32® and Windows® logos and product names are trademarks of ST microelectronics® and Microsoft® in the U.S.A. and other countries.

Page 3

1. Introduction 4

2. Applications 5

3. Package Contains 6

4, How to use it? 7

5. Tech Specs 8

6. Schematics 9

7. How It Works? 10

SpeakUp Firwmware Algorithm 11

8. Conguration Through Software 12

8.1. Typical Workow 13

8.2. Getting Started 14

8.3. Creating a new project 15

8.4. New Voice Command 16

8.5. Conguring Project Settings 18

8.6. Assigning An Action 20

8.7. Uploading Project 22

8.8. Exporting Constants 23

9. Direct Conguration 24

10. Recording Tips 25

11. Examples 26

Table of Contents

Page 4

1. Introduction

The SpeakUp is a speaker dependent speech recognition click board with standalone capabilities. You can set it up to recognize over 200 voice commands and have the onboard STM32F415RG MCU carry them out. It works by matching sounds with pre-recorded commands. Sound is received through an

onboard microphone and then processed by a VS1053 IC with a built in stereo-audio codec. The SpeakUp comes with

a dedicated software tool for easy configuration. The board is

lined with 12 user programmable GPIOs for standalone functionality. It also carries a standard mikroBUS™ host socket.

Easy

configuration

Over 200 commands

Ultra fast

operation

Standalone

mode

Page 5

2. Applications

Wouldn't you rather issue verbal commands and have your machines comply, instead of pressing keys, pushing buttons and flipping switches all the time? There's a wide range of applications for the SpeakUp.

Command your lights, doors and home appliances.

Create voice commanded remotes for TVs or media centers.

Reduce complexity and cost of control interfaces.

When doing something with both hands and voice command is the only option.

Page 6

3. Package Contains

Package dimensions: L 70mm, W 60mm, H 30mm

Box

User manual

1x8 headers

SpeakUp click

™

board

Recycle Bin document

Package weight: ~40g

Page 7

4. How To Use It?

Before using your click™ board on your target platform, make sure to solder 1x8 male headers to both left and right side of the board. Two 1x8 male headers are included with the board in the package.

Turn the board upside down so that the bottom side is facing you upwards. Place shorter pins of the header into the appropriate soldering pads. Turn the board upward again. Make sure to align the headers so that they are perpendicular to the board, then solder the pins carefully.

Now you need to train your SpeakUp to obey your commands. Plug in the board to your PC through USB cable. Configure it using the free software (see page 12). Alternatively you can configure the board directly using the on-board buttons (see page 24).

1. Prepare it 2. Configure it

The SpeakUp now understands your commands. Connect relays, motors or other electronic actuators directly to SpeakUp’s GPIO pins. Alternatively plug the SpeakUp into any board or shield carrying a mikroBUS™ socket. You can now control your devices with your voice.

3. Use it

Page 8

5. Tech Specs

Along with its key components, the SpeakUp packs other useful bits like two buttons for recording or deleting voice commands manually, while three signal LEDs give recognition feedback and indicate power.

Line out pads

USB connector

Audio jack

Microcontroller

mikroBUS connector

(STM32415RG)

Microphone

12 GPIOs

25.40 mm

57.15 mm

10.30 mm

(user programmable)

1000 mils

2550 mils

405.50 mils

Audio Codec

(VS1053)

Signal LEDs

Push-buttons

JTAG connector

Page 9

6. Schematics

VCC-USB

C35

2.2uF

R37 39K

R34 287K

GND

OUT

EN ADJ

AP7331-ADJ

C33

10uF

VCC-3.3V

PMEG3010ER

R38 OR

AN RST CS SCK

MOSI

MISO

+3.3V GND

PWM

INT

SCL SDA +5V GND

MIKROBUS DEVICE CONN.

R3 2K2

LD3

VCC-3.3V

PWM

VCC-USB

FP1 FERRITE

R26 220

1 2 3 4 5

GND

D+

D-

VBUS

CN3

USB MINIB

USB-DET USB-D_N USB-D_P

INT UART3-TX UART3-RX

I2C1-SCL I2C1-SDA

LEFT

RIGHT

C12

10nF

C10

47nF

C11

10nF

GBUF

C34

2.2uF

2 3 4 5 6 7

11 12

242322

10 27

404142

4445464748

MICP/LN1 MICN XRESET DGND0 CVDD0 IOVDD0 CVDD1 DREQ GPIO2 GPIO3 GPIO6 GPIO7

XDCS/BSYNC

IOVDD1

VC0

DGND1

XTAL0

XTAL1

IOVDD2

DGND2

DGND3

DGND4

XCS

CVDD2

GPIO5

SCLK

CVDD3

XTEST

GPIO0

GPIO1

GND

GPIO4

AGND0

AVDD0

AVDD2

AGND1

AGND2

AGND3

LN2

LEFT

RCAP

AVDD1

GBUF

RIGHT

VS1053

GND

OUT

EN ADJ

AP7331-ADJ

R33

100K

R35

27K4

R36

R1210R13

R14

R5 10

R9 10

VCC-1.8VVCC-3.3V

LEFT

RIGHT

GBUF

R23 10K

GPIO

R15 10K

VCC-3.3V

R19 27

MP3-MISO MP3-MOSI MP3-SCLK

MP3-DCS

MP3-DREQ

MP3-RST#

MICN

MP3-CS#

12.288MHz

R24 1M

C19 18pF

C18

18pF

R17 10K

R22 10K

VCC-3.3V

VCC-3.3V VCC-1.8V

R16 1K

R18 1K

VCC-3.3V

MICP

C14 100pF

MICP

CN2

SJ-43516-SMT

MICN

C16 100pF

C15 100PF

R20 1K

R21 1K

MIC1

MICROPHONE

302928

34 33

5655545352

36 35

11 12

5 6 7 8

1 2

626160

PC3

PC8

PB1 PD2

PB3

PB2

PA13 PA12 PA11 PA10

PA9 PA8 PC9

PB14

PB12

PB13

PB15

PC7 PC6

VDD

VCAP2

PB4

PC12

PC11

PC10

PA15

PA14

PB9

PB8

BOOT0

PB7

PB6

PB5

VSS

VDD

PC15

PC14

VBAT PC13

PH0 PH1 NRST PC0

PC2

PC1

PA2

PA1

PA0

VDDA

VSSA

PB0

PC5

PC4

PA7

PB11

PB10

VDD

VCAP1

VSS

PA3

VDD

PA4

PA5

PA6

STM32F415RG

USB-DET

USB-D_N

USB-D_P

USB-ID

C13

2.2uF

C17

2.2uF

VCC-3.3V

RST#

MP3-MISO

MP3-MOSI

MP3-SCLK

MP3-CS#

SPI1-MISO

SPI1-MOSI

SPI1-SCLK

SPI1-CS#

SPI1-MISO SPI1-MOSI

SPI1-SCLK

SPI1-CS#

I2C1-SCL

I2C1-SDA

IO9-PA0 IO8-PA1 IO7-PA2

IO3-PA3

IO2-PB0

IO1-PB1

1 2 3 4 5 6 7 8

HD1

1 2 3 4 5 6 7 8

HD2

VCC-3.3V VCC-3.3V

IO6-PC9 IO5-PC8 IO4-PC7

IO6-PC9

IO5-PC8

IO4-PC7

IO9-PA0

IO8-PA1

IO7-PA2

UART3-TX

UART3-RX

IO12-PC0 IO11-PC1 IO10-PC2

IO12-PC0

IO11-PC1

IO10-PC2

IO3-PA3

IO2-PB0

IO1-PB1

MP3-RST#

MP3-DREQ

MP3-DCS

INT

PWM

C21

100nF

USB-ID

SW1

VCC-3.3V

R25 10K

C20

100nF

SW1-PB10

SW2

VCC-3.3V

R31 10K

C32

100nF

SW2-PD2

LD1LD2

R1 4K7

R2 4K7

LD1-PB2

LD2-PC12

LD1-PB2 LD2-PC12

SW1-PB10

SW2-PD2

R6 470

3.3nF R4

100K

R10470

3.3nF

R11 100K

1 2 3

HD3

R29 10K

R30 10K

R28 10K

VCC-3.3V

100nFC2100nFC3100nFC4100nFC5100nFC62.2uF

VCC-3.3V

TMS-SWDIO

TCK-SWCLK 6 8 109

1 2 3 4

CN4

JTAG

VCC-3.3V

TMS-SWDIO

TCK-SWCLK

RST#

C31 100nF

C30 100nF

C28 100nF

C25 100nF

C29 100nF

C22 100nF

C23 100nF

C24 100nF

C26 100nF

VCC-1.8VVCC-3.3V

C27 100nF

1uF

C38 10uF

C39 10uF

C40 10uF

C41

10uF

C42

10uF

C43 10uF

R39 10K

C44

100nF

RST#

Page 10

7. How It Works?

Input:

Output:

What gives the SpeakUp its speech recognition capabilities is the firmware we developed for the on-board MCU. It’s based on the DTW algorithm, which makes it decisive, it turns your talk into action almost instantly.

Sound is received through an on-board microphone. There’s also a 3.5mm jack for connecting an external microphone.

After the processed sound has been forwarded to the STM32F415RG MCU that interprets the voice command, there are two output options which can be utilized at the same time or separately:

STANDALONE MODE: On-board MCU directly controls external devices using 12 user programmable GPIOs

CLICK

™

MODE:

Sends index of the matched voice command to a selectable interface: USB or UART.

Between the mic and the MCU sits a VS1053 IC with a built in stereo audio codec to process the raw signal.

Page 11

The main goal of a speech recognition system is to substitute a human listener, although it is very difficult for an artificial system to achieve the flexibility offered by human ear and human brain. The work principle of speech recognition systems is roughly based on the comparison of input data to prerecorded patterns. These patterns can be arranged in the form of phoneme or word. By this comparison, the pattern to which the input data is most similar is accepted as the symbolic representation of the data. It is very difficult to compare raw speech signals directly. Because the intensity of speech signals can vary significantly, a preprocessing on the signals is necessary. This preprocessing is called Feature Extraction.

First, short time feature vectors are obtained from the input speech data, and then these vectors are compared to the patterns classified prior to comparison. The feature vectors extracted from speech signal are required to best represent the speech data, to be in size that can be processed efficiently, and to have distinct characteristics.

The SpeakUp Firmware uses Dynamic Time Warping (DTW) algorithm - word-based, isolated word, speaker dependent and template matching algorithm :

In the word based speech recognition the smallest recognition unit is a word

In the isolated word recognition, words that are uttered with short pauses are recognized,

Speaker dependent reference patterns are constructed for a single speaker,

Template matching algorithm is a form of pattern recognition. It represents speech data as sets of feature/parameter vectors called

templates. Each word or phrase in an application is stored as a separate template. The input speech is then compared with stored templates and the stored template most closely matching the incoming speech pattern is identified as the input word or phrase.

SpeakUp Firmware Algorithm

Page 12

http://www.mikroe.com/downloads/get/2077/ speakup_app.zip

8. Conguration Through Software

The SpeakUp software configuration tool is a free PC application for configuring the SpeakUp click board. With it, you can configure the board to recognize over 200 different voice commands and have the on-board MCU carry them out instantly. You can download the software from the following link:

The software is designed with ease of use and simplicity in mind. The UI is based on tabs and drop-down menus requiring no programming skills to use.

Still, it has all the essential features and options that give you full control of the set-up process.

Page 13

8.1. Typical workow

First time you launch the app a new project is created automatically. Otherwise, the last project you were working on will open.

Launch the app

Add or Edit

voice commands

Upload

Assign actions

Adjust

Settings

New project created

or last one loaded

automatically

Create a new

project or open

existing manually

Everything OK?

YES

Page 14

8.2. Getting Started

Connect the SpeakUp click board to the computer via the USB cable. It will be recognized as a USB Human Interface Device (HID) in the Device Manager of the Control Panel.

After the successful connection, the SpeakUp click™ board will perform ambient noise detection and calibrate itself. The process lasts about 10 seconds. It’s done when the red signal LED turns off. After that the board is ready for recording voice commands. You can set custom calibration parameters for any subsequent usage in the Project Settings (see page 18).

Ambient Noise Detection

Once you connect the SpeakUp to your computer you’re just a few clicks away from configuring it. The set-up process is dead simple. Launch the application, and it will lead you through the initial steps of recording and assigning commands.

Page 15

8.3. Creating A New Project

To create a new project, press the Create New Project button from the main toolbar of the SpeakUp software.

A new window will open, where you can enter your project’s name and destination folder (if the destination folder doesn’t exist, the software will prompt you to create it).

To finish project creation after inputting the required information, press the Create button.

Alternatively, you can choose to open the settings menu as soon as you create a project, by checking the appropriate box.

Page 16

8.4. New Voice Command

To record a new voice command, press the Add New Voice Command button.

A New Voice Comand dialog window will appear. Press the Record button.

The length of the recording is set in the Project Settings window (see page 18).

The recorded command will be played back automatically, so you can make sure it’s OK.

Add a voice command Record it Stay within the time limit Hear it back

Page 17

If you’re satisfied with the recording, enter a name for your command and click the Save & Close button.

The recorded command will appear as a new tab. You can play it back, edit or delete it anytime.

If the SpeakUp fails to detect a voice command, your surrounding might be too noisy. Try again by speaking a bit louder. If it still doesn’t work, launch Settings and adjust the Noise treshhold.

Troubleshoot

Name it and save it You’re done!

Page 18

8.5. Conguring Project Settings

General Settings

To configure project settings, press the Open Settings Window button and the Settings window will open.

In the General Settings you can configure the SpeakUp’s functionality:

Acceptance threshold: This is the parameter you should adjust to define how

closely your delivery has to match your pre-recorded command. At lower values, you’ll have to deliver the command precisely the way you recorded it. At higher values the matching doesn’t have to be so precise, but this increases the probability that the SpeakUp will pick up irrelevant speech and interpret it as a command. You should be able to reach the sweet spot value through some trial & error.

Recording timeout: Timeframe in which the SpeakUp click board expects recording input after the record button is being pressed. User can choose between 5, 10 and 15 seconds timeframes.

Word Length: Length of the voice command being recorded, in seconds. Can be 1, 1.5 and 2 seconds.

Page 19

Noise level: Minimal sound volume level that can trigger a voice command recognition. Lower values require quieter pronunciation, resulting in higher noise/hiss sensitivity. On the contrary, higher level values require louder pronounciation and they are less sensitive to noise/hiss.

We recommend that you keep auto detection enabled. That way the SpeakUp Click board will measure the noise level, and perform noise calibration automatically. Auto detection can last a bit longer, usually around 10 seconds. Sudden

changes in sound levels will lengthen the time of calibration and will result in improper sound level values.

Notify master: Notifies the master (MCU or PC) when the voice command is recognized by sending a 16-bit index number of voice command via chosen communication interface (UART or USB).

Data rate: Sets the speed used for sending data to the master (MCU or PC).

Pin Aliases And Initial Pin States

In this section, you can rename GPIO pins according to your needs and set their starting conditions. The new GPIO pin aliases will be applied in the main window too. Set the corresponding initial GPIO pin state in the Initial Pin States section. Condition can be either low (logical 0) or high (logical 1).

Page 20

8.6. Assigning An Action

When a new command is recorded, it is time to assign it an action. The action will be performed when the voice command is recognized. Also, a 16-bit index number of the voice command will be sent via chosen communication interface (UART or USB) .

NONE: When this option is selected, no action will be performed on the corresponding GPIO pin upon voice command matching.

ON: When this option is selected, a corresponding GPIO pin will be set to logical high state upon voice command matching.

OFF: When this option is selected, a corresponding GPIO pin will be set to logical low state upon voice command matching.

TOGGLE: When this option is selected, a corresponding GPIO pin state will be toggled upon voice command matching.

PULSE: When this option is selected, a train of pulses will be sent to the corresponding GPIO pin upon voice command matching.

There are five types of action that can be assigned :

Page 21

Pulse parameters

The pulse parameters can be set in the Pulse Parameters window (click on the Edit pulse parameters icon Edit pulse parameters to open it) :

A period (T) is the time it takes for a signal to complete a single cycle (sum of the high state and low state time periods).

Duty ratio (D) is the percentage of T in which a signal is active, i.e. ratio of the high state period and a complete period.

N is the number of times the pulse is repeated.

Thus, a 60% duty cycle means the signal is ON 60% of the time period but OFF 40% of the time period.

Page 22

8.7. Uploading Project

When you’re finished recording and configuring voice commands, it is time to upload the project to the SpeakUp click™ board. This is done via the Upload Project button.

You can monitor the upload process in the Toolbar.

After it’s done, an appropriate message will be displayed in the Status Bar.

Page 23

mikroBasic mikroPascal

8.8. Exporting Constants

Each recorded voice command is given an index number which is sent to the host MCU. You can export voice command names and their indexes as constants. The exported document will be in the form of a source file (in any of the three languages), as shown below.

mikroC

/* This file is generated by SpeakUp Software. It containts voice commands constants. Creation date: 4/3/2014 Creation time: 11:20:09 AM Name: Turn ON Program A Index: 0 Length: 0.0 s Description: Turns on Program A */

const VCMD_TURN_ON_PROGRAM_A = 0;

Name: Turn ON program B Index: 1 Length: 0.0 s Description: Turns on Program A */

const VCMD_TURN_ON_PROGRAM_B = 1;

Page 24

9. Direct Conguration

You can perform some basic configuration directly on the SpeakUp without using the software. Different combinations of button presses will allow you to record, re-record or erase commands. You’ll get feedback from the on-board LEDs. However you won’t be able to assign specific actions with this method.

Two indicator LEDs provide the following signals:

Amber LED - the board is ready for recording

or listening.

Red LED - the board is perfoming an operation.

When the voice command is recognized,

both LEDs are lit for a half a second.

On-board LEDs

Use push-buttons to operate the board:

Push-button 1 - To record your voice command,

press and hold the button while speaking. You must stay within the time limit for each command (default settings: 1 second). You can also record multiple commands at once by pronouncing them one by one while keeping the button pressed. Just make sure to wait for the red LED to flash between pronouncing subsequent commands. Proceed in this way for as many commands as you need. Each command will be assigned a unique index.

Push-button 2 - If you press it for more than 2

seconds, all recorded voice commands will be erased.

If both push-buttons are pressed for more

than 2 seconds, the SpeakUp click board will reset.

On-board push-buttons

1 2

Acceptance Threshold: 15 Recording Timeout: 5s Word Length: 1s Noise Level: Auto Notify Master: USB

Standalone mode default settings:

Page 25

10. Recording Tips

For better recording results, it is necessary to provide conditions with lowest amounts of ambient noise and speaker distance from the microphone in the range from 10 to 20cm.

If there are problems with the voice command detection, please record it several times due to the pronounciation diversity.

It is mandatory to play back the recorded voice command in order to hear if some ambient noise was recorded also.

Because of this, it is recommended that the SpeakUp click™ board is placed on a surface that doesn’t transfer mechanical vibrations.

This is a speaker dependent system. If there are more users, each person should record voice commands separately, due to the pronounciation diversity.

Number of voice commands that can be recorded depend on their lengths, typically more than 200 for the voice command length of 1 second.

Please keep in mind that the recording is performed by the SpeakUp click™ board, not the computer, so there is no need to connect an external microphone to the computer.

Here are some general recording Tips :

Page 26

11. Examples

SpeakUp has a world of applications. It’s up to your imagination to come up with the coolest ideas. Here’s a hint or two:

Use SpeakUp on top of the Pi click Shield to command XBMC Home Media Center on Raspberry Pi®. It’s a great a replacement for a mouse and a keyboard.

Replace your lamp switch with a SpeakUp click and a relay. Tell your light to turn ON or OFF if your hands are busy doing something important.

Page 27

DISCLAIMER

All the products owned by MikroElektronika are protected by copyright law and international copyright treaty. Therefore, this manual is to be treated as any other copyright material. No part of this manual, including product and software described herein, may be reproduced, stored in a retrieval system, translated or transmitted in any form or by any means, without the prior written permission of MikroElektronika. The manual PDF edition can be printed for private or local use,

but not for distribution. Any modication of this manual is prohibited.

MikroElektronika provides this manual ‘as is’ without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties or

conditions of merchantability or tness for a particular purpose.

MikroElektronika shall assume no responsibility or liability for any errors, omissions and inaccuracies that may appear in this manual. In no event shall MikroElektronika,

its directors, ocers, employees or distributors be liable for any indirect, specic, incidental or consequential damages (including damages for loss of business prots and business information, business interruption or any other pecuniary loss) arising out of the use of this manual or product, even if MikroElektronika has

been advised of the possibility of such damages. MikroElektronika reserves the right to change information contained in this manual at any time without prior notice, if necessary.

TRADEMARKS

The MikroElektronika name and logo, the MikroElektronika logo, the click boards

™

are trademarks of MikroElektronika. All other trademarks mentioned herein are property of their respective companies. All other product and corporate names appearing in this manual may or may not be registered trademarks or copyrights of their respective companies, and are only

used for identication or explanation and to the owners’ benet, with no intent to infringe.

HIGH RISK ACTIVITIES

The products of MikroElektronika are not fault – tolerant nor designed, manufactured or intended for use or resale as on – line control equipment in hazard-

ous environments requiring fail – safe performance, such as in the operation of nuclear facilities, aircraft navigation or communication systems, air trac

control, direct life support machines or weapons systems in which the failure of Software could lead directly to death, personal injury or severe physical or

environmental damage (‘High Risk Activities’). MikroElektronika and its suppliers specically disclaim any expressed or implied warranty of tness for High

Risk Activities.

Page 28

If you want to learn more about our products, please visit our website at www.mikroe.com

If you are experiencing some problems with any of our products or just need additional

information, please place your ticket at www.mikroe.com/support/

If you have any questions, comments or business proposals,

do not hesitate to contact us at oce@mikroe.com