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.
| 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 |
