docs/debugging.md

   1 Debugging libmraa                         {#debugging}
   2 =================
   3
   4 This page contains a few debugging tip. When filing an issue please go through
   5 this list as it's the first thing we'll ask you to do.
   6
   7 ### Finding your mraa version
   8
   9 Getting the exact version of libmraa you're running is really important to us.
  10 The best way to get this is to call mraa_get_version() or mraa.getVersion(). If
  11 mraa returns x.x.x-dirty then your version was not built from a git tree or you
  12 built out of tree (see our building doc) - or you don't have git installed.
  13
  14 ### Finding error logs
  15
  16 mraa logs pretty much everything that goes wrong to syslog. These days it'll go
  17 to the systemd journal so check with `sudo journalctl -f` whilst running your
  18 app or check all libmraa messages with `journalctl -t libmraa`.  Grab all the
  19 messages from the initialisation message right up to your last one. Using a
  20 pastebin is always a good idea, I like dpaste.com. If your system does not have
  21 systemd 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