Difference between revisions of "Raspberry Pi"

From uGFX Wiki
Jump to: navigation, search
(Prerequisites)
Line 19: Line 19:
  
 
For more information about the Linux framebuffer, please see [[Linux#Framebuffer|Linux Framebuffer]].
 
For more information about the Linux framebuffer, please see [[Linux#Framebuffer|Linux Framebuffer]].
 +
 +
== Troubleshooting ==
 +
The most common issues are:
 +
* The Linux kernel you are using has not been compiled with framebuffer support. ''(See [[#Prerequisites|Prerequisites]]).''
 +
* The framebuffer device is not accessible through one of the standard paths. ''(See Linux#Framebuffer|Linux Framebuffer).''
 +
* The user executing the µGFX application doesn't have the permission required to access the framebuffer device. ''(See Linux#Framebuffer|Linux Framebuffer).''

Revision as of 12:14, 23 August 2016

µGFX applications can run natively (without emulation/simulation) on any Linux system. This means that µGFX can run without any problems on a Raspberry Pi. This is a step-by-step setup & configuration guide that will explain everything necessary to run µGFX on a Raspberry Pi.

Introduction

The most common question asked in this context is why to run µGFX on an embedded Linux device. Today's single board computers running Linux are powerful enough to run X and a complete desktop environment. Therefore, GUI applications can be written using desktop GUI frameworks such as Qt or GTK. Running µGFX instead on such as system has two main, but very important advantages:

  • Dependencies: Installing X, a desktop environment all required desktop applications and the required libraries to run custom built desktop applications pull many dependencies. This makes the system become heavy and bloated. However, the most important issue is that all these dependencies need to be maintainer. For example, when performing as sytem update, more components have to be tested to ensure the continuous and uninterrupted functioning of the device. This becomes even more important for mission critical equipmenet such as medical devices where each component needs to be audited and certified individually. Running µGFX on such a device vastly reduces the complexity of the system and therefore allows to built more stable & cheaper devices featuring a GUI while still running on a powerful Linux based system.
  • Resource requiremenets: ToDo

Used utilities

The following utilities will be used in this tutorial:

However, this guide has been kept as generic as possible. Following the same steps should allow running µGFX on any embedded Linux system.

Prerequisites

It is important that the used Linux kernel has been compiled with framebuffer support. With the latest version of Raspberian (state of 2016-08-23) this is the case. Therefore, we don't need to modify anything. If your Linux distribution doesn't come with a Linux kernel with enabled framebuffer support, please consult the corresponding documentation on how to enable it.

If your Linux kernel comes with built-in framebuffer support, you should see the framebuffer device under /dev/fb0, /dev/fb/0 or similar.

For more information about the Linux framebuffer, please see Linux Framebuffer.

Troubleshooting

The most common issues are:

  • The Linux kernel you are using has not been compiled with framebuffer support. (See Prerequisites).
  • The framebuffer device is not accessible through one of the standard paths. (See Linux#Framebuffer|Linux Framebuffer).
  • The user executing the µGFX application doesn't have the permission required to access the framebuffer device. (See Linux#Framebuffer|Linux Framebuffer).