Troubleshooting

Having trouble with the AVS Device SDK? Here's a list of workarounds for common issues. If you run into a problem that's not listed here, create a new issue on our GitHub page.

All platforms

Issue Cause Error message Resolution
The SDK doesn't load AlexaClientSDKConfig.jsondoesn't reference a database file miscDatabase: E SQLiteMiscStorage:createFailed:reason=Could not load config value,key=databaseFilePath Open AlexaClientSDKConfig.json and find the `databaseFilePath` entry. Make sure it's linking to a database. To see an example of this, run the genConfig.sh script to populate the field for you.
Amazon Music won't play The device isn't set with the correct date. This causes certificate issues when contacting Amazon server curlEasyPerformFailed:error=Peer certificate can't authenticate with the provided CA certificates Change the date on the device to the current date. For example, to change the date to Jan 31, 2018: date +%Y%m%d -s "20180131". To change the time: date +%T -s "16:11:00"
No audio output The SDK is referencing the incorrect audiosink element The SDK automatically selects the best audiosink based on your system configuration. This can cause issues depending on how you build the SDK Run this command: gst-launch-1.0 -m audiotestsrc ! autoaudiosink. If the system is working, a test tone plays. If the system isn't working, a test tone doesn't play

Use -m to show which audiosink you've set up. If needed, change the sink in the AlexaClientSDKConfig.json file

Linux

Issue Cause Error message Resolution
No sound when using the Plantronix Speakerbox gstreamer is incorrectly configured N/A Update gstreamer by running sudo apt install gstreamer1.0-alsa. You also must set some additional configurations. See issue 212 for details
Can't play more than one sound simultaneously Missing dmix plugin N/A Install the dmix plugin. See Issue 415 for details

macOS

Issue Cause Error message Resolution
The SDK fails to build Missing dependencies N/A Sometimes runningbrew installduring steps 1,2 or 3 doesn't work if a dependency is already installed. To fix any missing dependencies, run a brew install command for each missing dependency
The Sample App failed to build Your version of curl doesn't support HTTP/2 N/A curl didn't link properly. To fix, run brew uninstall curl, then repeat the steps in section 1.2.2

RaspberryPi

Issue Cause Error message Resolution
No option to output sound to a USB soundcard The SampleApp uses the default input and output for audio. N/A To use a USB soundcard, install the dsnoop and dmix plugins. Paste this code into .asoundrc, and into asound.conf
Kitt.ai causes the SDK build to fail The default gcc version might need to be updated ../src/libKITTAI.so: undefined reference to snowboy::SnowboyDetect::SetSensitivity The Kitt-AI GitHub has some helpful suggestions. You can pass in CXX flags to the SampleApp CMake command like so: -DCMAKE_CXX_FLAGS:STRING="-D_GLIBCXX_USE_CXX11_ABI=0 -pg"

Windows

Issue Cause Error message Resolution
The system can't locate libwinpthread-1.dll when running the sample app Windows can't find the libwinthread library because it's not installed or it's not in the path environment variable N/A Verify that the library exists and that it's nested within the proper file path, such as /msys64/mingw64/bin
The sample app hangs at startup and the CPU is running at ~35% Pacman isn't updated N/A Update Pacman by following the steps in the Windows Quick Start Guide
Unable to run sample app with GStreamer 1.14 or later GSTreamer 1.14 or later is missing directsoundsink Sample app failed to load As a workaround, delete INetCache in the registry and restart the sample app. Directsoundsink should reappear. Run sample app again. See here for more information