Home | History | Annotate | Download | only in docs
      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 
     32