1Debugging libmraa {#debugging} 2================= 3 4This page contains a few debugging tip. When filing an issue please go through 5this list as it's the first thing we'll ask you to do. 6 7### Finding your mraa version 8 9Getting the exact version of libmraa you're running is really important to us. 10The best way to get this is to call mraa_get_version() or mraa.getVersion(). If 11mraa returns x.x.x-dirty then your version was not built from a git tree or you 12built out of tree (see our building doc) - or you don't have git installed. 13 14### Finding error logs 15 16mraa logs pretty much everything that goes wrong to syslog. These days it'll go 17to the systemd journal so check with `sudo journalctl -f` whilst running your 18app or check all libmraa messages with `journalctl -t libmraa`. Grab all the 19messages from the initialisation message right up to your last one. Using a 20pastebin is always a good idea, I like dpaste.com. If your system does not have 21systemd likely your log is in /var/log/messages or a similar location. 22 23### Common errors to check for 24 25* Not running as root 26* Incorrect IO pin numbers, mraa uses physical connector pin numbering see your 27 platform documentation for details 28* Your platform is unsupported 29* Using the wrong pin, check pin capabilities either using the API or your 30 platform documentation 31 32