Difference between revisions of "Linux"
(→Makefile) |
|||
| Line 3: | Line 3: | ||
== SDL == | == SDL == | ||
Using the SDL driver is the recommended way of running µGFX inside a Linux system with a desktop environment. | Using the SDL driver is the recommended way of running µGFX inside a Linux system with a desktop environment. | ||
| + | |||
| + | === Dependencies === | ||
| + | SDL2 is required to use the µGFX SDL driver. As we are compiling an SDL application ourselves, the development version of the SDL2 library used. On most common Linux distributions these can be installed by the <code>libsdl2-dev</code> package. However, note that µGFX applications get compiled as 32-bit applications. Therefore, you have to install the 32-bit variation of that package if you are running a 64-Bit Linux. | ||
| + | |||
| + | For example, the following package can be installed on Ubunut 16 64-Bit: | ||
| + | <source lang=bash> | ||
| + | apt install libsdl2-dev:i386 | ||
| + | </source> | ||
| + | |||
| + | === Makefile === | ||
| + | A ready-to-use Makefile to compile a native µGFX Linux application can be found under ''/boards/base/Linux/example/''. | ||
== Framebuffer == | == Framebuffer == | ||
| Line 14: | Line 25: | ||
=== Makefile === | === Makefile === | ||
| − | A ready-to-use Makefile to compile a native | + | A ready-to-use Makefile to compile a native µGFX Linux application can be found under ''/boards/base/Linux-Framebuffer/example/''. |
== X == | == X == | ||
Using the X driver is not recommended. It's deprecated and an old relic that is kept in the µGFX library as a reference for examples and for systems that are incapable of running SDL. It is '''STRONGLY''' recommended to use the SDL driver instead (see above). | Using the X driver is not recommended. It's deprecated and an old relic that is kept in the µGFX library as a reference for examples and for systems that are incapable of running SDL. It is '''STRONGLY''' recommended to use the SDL driver instead (see above). | ||
The performance of the resulting program is very bad because the X driver just uses <code>setPixel()</code> and doesn't take any advantage of area blitting or double buffering. | The performance of the resulting program is very bad because the X driver just uses <code>setPixel()</code> and doesn't take any advantage of area blitting or double buffering. | ||
Revision as of 11:49, 15 August 2016
µGFX runs natively on any Linux system. The SDL and X drivers can be used to compile a native Linux desktop application. This is especially useful during the development process as the entire µGFX application can be developed and tested without flashing the target microcontroller every time. The Framebuffer driver is useful to use µGFX on embedded Linux systems that don't run X or a full Desktop environment.
SDL
Using the SDL driver is the recommended way of running µGFX inside a Linux system with a desktop environment.
Dependencies
SDL2 is required to use the µGFX SDL driver. As we are compiling an SDL application ourselves, the development version of the SDL2 library used. On most common Linux distributions these can be installed by the libsdl2-dev package. However, note that µGFX applications get compiled as 32-bit applications. Therefore, you have to install the 32-bit variation of that package if you are running a 64-Bit Linux.
For example, the following package can be installed on Ubunut 16 64-Bit:
apt install libsdl2-dev:i386Makefile
A ready-to-use Makefile to compile a native µGFX Linux application can be found under /boards/base/Linux/example/.
Framebuffer
The framebuffer driver can be used to run µGFX on embedded Linux systems that don't run X or a desktop environment.
include $(GFXLIB)/boards/base/Linux-Framebuffer/board.mk
Dependencies
There are no dependencies to use the Linux framebuffer driver. However, the Linux kernel must have been compiled with framebuffer support enabled.
Makefile
A ready-to-use Makefile to compile a native µGFX Linux application can be found under /boards/base/Linux-Framebuffer/example/.
X
Using the X driver is not recommended. It's deprecated and an old relic that is kept in the µGFX library as a reference for examples and for systems that are incapable of running SDL. It is STRONGLY recommended to use the SDL driver instead (see above).
The performance of the resulting program is very bad because the X driver just uses setPixel() and doesn't take any advantage of area blitting or double buffering.
