summaryrefslogtreecommitdiff
path: root/peripheral/libmraa/docs/debugging.md
blob: 26f5b2ebd04851adb147f424602e0b5e80c0d8e3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
Debugging libmraa                         {#debugging}
=================

This page contains a few debugging tip. When filing an issue please go through
this list as it's the first thing we'll ask you to do.

### Finding your mraa version

Getting the exact version of libmraa you're running is really important to us.
The best way to get this is to call mraa_get_version() or mraa.getVersion(). If
mraa returns x.x.x-dirty then your version was not built from a git tree or you
built out of tree (see our building doc) - or you don't have git installed.

### Finding error logs

mraa logs pretty much everything that goes wrong to syslog. These days it'll go
to the systemd journal so check with `sudo journalctl -f` whilst running your
app or check all libmraa messages with `journalctl -t libmraa`.  Grab all the
messages from the initialisation message right up to your last one. Using a
pastebin is always a good idea, I like dpaste.com. If your system does not have
systemd likely your log is in /var/log/messages or a similar location.

### Common errors to check for

* Not running as root
* Incorrect IO pin numbers, mraa uses physical connector pin numbering see your
  platform documentation for details
* Your platform is unsupported
* Using the wrong pin, check pin capabilities either using the API or your
  platform documentation