Audio Card for Jetson Nano

From Waveshare Wiki
Jump to: navigation, search
Audio Card for Jetson Nano
Audio Card for Jetson Nano





This is a USB sound card, supports recording and playback, stereo codec, built-in microphone, and speaker. It is suitable for Jetson Nano. driver-free, plug, and play.


  • USB connector, suits Jetson Nano Developer Kit series, multi-systems compatible.
  • Incorporates SSS1629 audio chip, using USB bus, driver-free, plug and play.
  • 2 x quality MEMS si-microphone, dual soundtrack recording, better sound quality.
  • Standard 3.5mm audio jack for connecting earphones.
  • Dual channel speaker header for direct driving speakers, with volume adjustment knob.
  • Providing demo codes for speech synthesis, speech dictation, speech wake-up, and speech dialog.


  • Power voltage:5V
  • Audo Encoder/Decoder:SSS1629A5
  • Control port:USB

Using with Jetson Nano

Hardware connection

1. Connect the Audio Card for Jetson Nano to Jetson Nano with the USB adapter.
2. Connect the 8Ω5W speaker to the speaker connector.
3. Start the Jetson Nano.

Check the Audio card

  • Test playing:aplay -l
jetson@linux:~$ aplay -l
**** List of PLAYBACK Hardware Devices ****
... ...
... ...
card 2: Device [USB PnP Audio Device], device 0: USB Audio [USB Audio]
  Subdevices: 1/1
  Subdevice #0: subdevice #0
  • Test recording:arecord -l
jetson@linux:~$ arecord -l
**** List of CAPTURE Hardware Devices ****
... ...
... ...
card 2: Device [USB PnP Audio Device], device 0: USB Audio [USB Audio]
  Subdevices: 1/1
  Subdevice #0: subdevice #0

Recording test

  • Record:
jetson@linux:~$ arecord -D plughw:2,0 -f S16_LE -r 48000 -c 2 test.wav
Recording WAVE 'test.wav' : Signed 16 bit Little Endian, Rate 48000 Hz, Stereo

-D "plughw:1,0": stands for card 1, device 0, that is the USB card connected.
-f S16_LE: Little-endian signed 16 bits;
-c 2: Dual-track;
test.wav: The video file is saved.
Youc an press Ctrl+C to stop recording.

  • Playing:
jetson@linux:~$ aplay -D hw:2,0 test.wav 
Playing WAVE 'test.wav' : Signed 16 bit Little Endian, Rate 48000 Hz, Stereo

Play the audio recorded.

Adjust volume

sudo alsamixer

You can press F6 to select the audio device if you didn't set the USB audio card as the default audio device.
Speaker is the volume of the speaker and the Mic is the volume of the Microphone.

Configure default audio card

Because the GUI of the Jetson Nano 4GB and the 2GB version are different, please read the guide according to your Jetson Nano Board.
Note: If you didn't set the Audio Card for Jetson Nano as the default audio card, the examples may not work normally.

Jetson nano 4G

Enter the GUI, and click the audio icon to configure the audio. Choose USB PnP Audio Device for Output/Input.

Jetson nano 2G

Enter the GUI, and click the Menu on the right-bottom. Choose Sound & Video -> PulseAudio Volume Control and open.
On the Playback/Recording page, set the audio output as USB PnP Audio Device.
Note: The options can only work when your run the codes, otherwise, you can only find the System Sounds option but not the SoX. If you didn't read the sound when running the codes, please check if you have set the USB PnP Audio Device as the default audio output.

Download the Examples

tar zxvf Audio_Card_for_jetson_nano.tar.gz

Audio examples

Install Python3 virtual environment

sudo apt-get update
sudo apt-get install python3-dev python3-venv
python3 -m venv env
env/bin/python -m pip install --upgrade pip setuptools wheel
source env/bin/activate
Note: The commands below are all run in the virtual environment. If you exit the env, please run the following command to enter the env.
source ~/env/bin/activate

Install Google Assistant Service

To use Google Assistant, you need to first install the Google Assistant Service.
Official guides:
Please follow step 3 of the guides to configure the developer project and the account, and then create an OAuth Client ID JSON file. And you need to copy the JSON file to your jetson nano.
Please follow step 4 to register the device model.

Install Google Assistant SDK

(env) $ sudo apt-get install portaudio19-dev libffi-dev libssl-dev
(env) $ python -m pip install --upgrade google-assistant-sdk[samples]

Authorize the Google Assistant SDK Install or update the authorization tools.

(env) $ python -m pip install --upgrade google-auth-oauthlib[tool]

Generate the credential for running examples and tools. Import the JSON file downloaded before. Please directly copy the JSON file and do not rename it,

(env) $ google-oauthlib-tool --scope \
      --save --headless --client-secrets /path/to/client_secret_ client-id .json

Following the command you will get a URL:

Please visit this URL to authorize this application: https://...

Copy the URL and go to the website by the browser. The link is the login page of Google, you should log in with your Google account (Please use the developer account created before) Allow the license request from the API, and you will get a CODE like "4 / XXXX", please copy the code to the terminal of Jetson Nano:

Please go to this URL: https://...
Enter the authorization code:

If the authorize successful, you will get the response below. If you get an InvalidGrantError response, you may input the wrong code, please try it again.

credentials saved: /path/to/.config/google-oauthlib-tool/credentials.json

Running examples

Button Toggle

Run the following command to test my-dev-project is the Google Cloud Platform device ID of the Action Console project created. You need to find the project ID in Actions Console, my-model is the device model registered.

(env) $ googlesamples-assistant-pushtotalk --project-id my-dev-project --device-model-id my-model

Press Enter and try to test: Who am I? What time is it? Google Assitant will answer if all the settings are correct.

snowboy Wakeup

cd ~/Audio_Card_for_jetson_nano/google
deactivate   #Exit env
python3 hotword.pmdl

Run the command and you will get the information that "Listening...", means that the examples are standby and you can speaker keyword to wake up the assistant and talk. For example: "ok google, Who am I? What time is it?". The assistants will respond with a tone.
Note 1: The hotword.pmd is the voice model of Waveshare, and you need to train your own voice model and replace it, otherwise you may fail to wake it up.
Note 2: The account used in the demo codes is a personal account and it has limitations of login times. Please create your own account and modify the device_model_id and device_id in

Snowboy Guide

snowboy is an open-source project for audio detecting. You can use it for sound wake-up.

Install libraries

sudo apt-get install swig
sudo apt-get install libatlas-base-dev
sudo apt-get install portaudio19-dev
sudo apt-get install flac
pip3 install PyAudio
pip3 install SpeechRecognition

Download the souces code and compile

Download snowboy:
git clone
cd snowboy/swig/Python3
Modify the Makefile, find the line, and add the content.
 vi Makefile

The contents:

 ifneq (,$(findstring aarch64,$(shell uname -m)))
     SNOWBOYDETECTLIBFILE = $(TOPDIR)/lib/aarch64-ubuntu1604/libsnowboy-detect.a

And then compile


Run the examples

cd ../../examples/Python3
Modify file and change from . import snowboydetect to import snowboydetect
Test to wake up with snowboy
cd ~/snowboy/examples/Python3
python3 resources/models/smart_mirror.umdl
Say smart_mirror, the device will sound ding and display information:
INFO:snowboy:Keyword 1 detected at time: 2019-12-03 11:30:16

Note: The keyword use public model, you can train you own model and change the keyword for better detecting.

Train voice model

Because the Snownoy is not updated anymore and the website is closed. You need to train the model with a third-party platform.
Go to and train your voice model.
We provide a pre-built Ubuntu 16.04 OS (password: mylinux) for VMware, you can open it with VMware WorkStation software.

Connect the Audio Card for the Jetson Nano module to Ubuntu 16.04 OS and run the following command to record audio triple times. You can use the same Audio Card for Jetson Nano to record the voice.

cd snowboy/examples/Python
rec -r 16000 -c 1 -b 16 -e signed-integer -t wav record1.wav

Run the following command to train your voice model.

python -r1=record1.wav -r2=record2.wav -r3=record3.wav -lang=en -n=hotword.pmdl

record1.wav,record2.wav,record3.wav are the three record files and hotword.pmdl is the model generated.



Technical Support

If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)