Teensy - Revision history

Tectu: /* How to use ugfx-arduino in your own projects */

2016-01-11T19:13:28Z

‎How to use ugfx-arduino in your own projects

Tectu: /* How to use ugfx-arduino in your own projects */

2016-01-11T19:13:09Z

‎How to use ugfx-arduino in your own projects

Tectu: /* Resulting arduino library directory structure after installation */

2016-01-11T19:09:55Z

‎Resulting arduino library directory structure after installation

Tectu: /* How to use ugfx-arduino in your own projects */

2016-01-11T19:05:00Z

‎How to use ugfx-arduino in your own projects

Tectu: /* How to use ugfx-arduino in your own projects */

2016-01-11T19:04:50Z

‎How to use ugfx-arduino in your own projects

Tectu: /* Install uGFX in arduino's library directory */

2016-01-11T19:03:31Z

‎Install uGFX in arduino's library directory

Christoph at 12:02, 11 January 2016

2016-01-11T12:02:49Z

Tectu: Created page with "Coming soon..."

2016-01-10T18:13:32Z

Created page with "Coming soon..."

New page

Coming soon...

← Older revision		Revision as of 19:13, 11 January 2016
Line 88:		Line 88:
	This file provides pin number definitions for the display driver. The content of this file depends on the display driver.		This file provides pin number definitions for the display driver. The content of this file depends on the display driver.

−	If you want to create your own configuration for a project called ''myproject'', you have to create a new arduino library called ''myproject-ugfx-config'' in the arduino library directory. It must at least provide one header called <code>myproject-ugfx-config.h</code> which includes <code>ugfx-arduino.h</code> and a display driver header, and it must provide <code>gfxconf.h</code> in the same directory. Then include <code>myproject-ugfx-config.h</code> in your main arduino sketch.	+	If you want to create your own configuration for a project called <code>myproject</code>, you have to create a new arduino library called <code>myproject-ugfx-config</code> in the arduino library directory. It must at least provide one header called <code>myproject-ugfx-config.h</code> which includes <code>ugfx-arduino.h</code> and a display driver header, and it must provide <code>gfxconf.h</code> in the same directory. Then include <code>myproject-ugfx-config.h</code> in your main arduino sketch.

@@ Line 42: / Line 42: @@
 == How to use ugfx-arduino in your own projects ==
-For each project you create, you should also have a project-specific config library. An example for such a library is included in ugfx-arduino: example-ssd1351-ugfx-config. It configures ugfx through gfxconf.h, adds a display driver header, and provides configuration information for that driver. The example consists of three files.
+For each project you create, you should also have a project-specific config library. An example for such a library is included in ugfx-arduino: <code>example-ssd1351-ugfx-config</code>. It configures uGFX through <code>gfxconf.h</code>, adds a display driver header, and provides configuration information for that driver. The example consists of three files.
 <code>example-ssd1351-ugfx-config.h</code>:
@@ Line 78: / Line 78: @@
 #endif /* _GFXCONF_H */
 </syntaxhighlight>
-Just a normal ugfx configuration. Note that the selected operating system flag is GFX_USE_OS_ARDUINO.
+Just a normal ugfx configuration. Note that the selected operating system flag is <code>GFX_USE_OS_ARDUINO</code>.
 <code>ssd1351_pins.cpp</code>:
@@ Line 88: / Line 88: @@
 This file provides pin number definitions for the display driver. The content of this file depends on the display driver.
-If you want to create your own configuration for a project called ''myproject'', you have to create a new arduino library called ''myproject-ugfx-config'' in the arduino library directory. It must at least provide one header called myproject-ugfx-config.h which includes ugfx-arduino.h and a display driver header, and it must provide gfxconf.h in the same directory. The include myproject-ugfx-config.h in your main arduino sketch.
+If you want to create your own configuration for a project called ''myproject'', you have to create a new arduino library called ''myproject-ugfx-config'' in the arduino library directory. It must at least provide one header called <code>myproject-ugfx-config.h</code> which includes <code>ugfx-arduino.h</code> and a display driver header, and it must provide <code>gfxconf.h</code> in the same directory. Then include <code>myproject-ugfx-config.h</code> in your main arduino sketch.

@@ Line 39: / Line 39: @@
 </pre>
-If your directory structure looks like this, you can start (or restart) arduino and look for File->Examples->ugfx-arduino->example-ssd1351-ugfx-config. If it is there, arduino has found the library and the example contained therein. It should now compile fine.
+If your directory structure looks like this, you can start (or restart) arduino and look for <code>File -> Examples -> ugfx-arduino -> example-ssd1351-ugfx-config</code>. If it is there, arduino has found the library and the example contained therein. It should now compile fine.
 == How to use ugfx-arduino in your own projects ==

@@ Line 56: / Line 56: @@
 This file just includes other headers for ugfx and a display driver.
-<code>gfxconf.h</code:
+<code>gfxconf.h</code>:
 <syntaxhighlight lang=c>
 #ifndef _GFXCONF_H

@@ Line 44: / Line 44: @@
 For each project you create, you should also have a project-specific config library. An example for such a library is included in ugfx-arduino: example-ssd1351-ugfx-config. It configures ugfx through gfxconf.h, adds a display driver header, and provides configuration information for that driver. The example consists of three files.
-example-ssd1351-ugfx-config.h:
+<code>example-ssd1351-ugfx-config.h</code>:
-<pre>
+<syntaxhighlight lang=c>
 #ifndef TEENSY31_SSD1351_UGFX_CONFIG_H
 #define TEENSY31_SSD1351_UGFX_CONFIG_H
@@ Line 53: / Line 53: @@
 #endif // TEENSY31_SSD1351_UGFX_CONFIG_H
-</pre>
+</syntaxhighlight>
 This file just includes other headers for ugfx and a display driver.
-gfxconf.h:
+<code>gfxconf.h</code:
-<pre>
+<syntaxhighlight lang=c>
 #ifndef _GFXCONF_H
 #define _GFXCONF_H
@@ Line 77: / Line 77: @@
 #endif /* _GFXCONF_H */
-</pre>
+</syntaxhighlight>
 Just a normal ugfx configuration. Note that the selected operating system flag is GFX_USE_OS_ARDUINO.
-ssd1351_pins.cpp:
+<code>ssd1351_pins.cpp</code>:
-<pre>
+<syntaxhighlight lang=c>
 #include "ugfx-arduino-gdisp-ssd1351.h"
 extern const ssd1351_pins_t ssd1351_pins = {15, 14, 16};
-</pre>
+</syntaxhighlight>
 This file provides pin number definitions for the display driver. The content of this file depends on the display driver.
 If you want to create your own configuration for a project called ''myproject'', you have to create a new arduino library called ''myproject-ugfx-config'' in the arduino library directory. It must at least provide one header called myproject-ugfx-config.h which includes ugfx-arduino.h and a display driver header, and it must provide gfxconf.h in the same directory. The include myproject-ugfx-config.h in your main arduino sketch.

@@ Line 12: / Line 12: @@
 == Install uGFX in arduino's library directory ==
-Download uGFX (tested with repo state as of 2015-11-24 or later) and put it into arduino's library directory. You should end up with ''arduino libraries directory''/ugfx/src and other files and folders.
+Download uGFX (tested with [[Getting_Started#Repository|repository]] state as of 2015-11-24 or later) and put it into arduino's library directory. You should end up with ''arduino libraries directory''/ugfx/src and other files and folders.
 uGFX can not be used as a stand-alone library, but must be wrapped with an arduino library that provides a suitable interface for the build process: one header and one source file, within the library's base directory. This is done by ugfx-arduino which is installed in the next step.

← Older revision		Revision as of 12:02, 11 January 2016
Line 1:		Line 1:
−	~~Coming soon~~...	+	This page walks you through the process of setting up your Arduino environment to compile code that uses uGFX. It is assumed that you are familiar with the overall structure of the relevant arduino directories (sketches and libraries). There are four main steps to this:
		+
		+	# install arduino and teensyduino
		+	# install uGFX in arduino's library directory
		+	# install the base uGFX-arduino libraries and drivers
		+	# write a project-specific config library (this has to be done for every project that uses uGFX in arduino)
		+
		+	== Install arduino and teensyduino ==
		+	# Download and install arduino (https://www.arduino.cc/en/Main/Software). The instructions on this page have been tested with arduino 1.6.6
		+	# Doanload and install teensyduino (https://www.pjrc.com/teensy/td_download.html). The instructions on this page have been tested with teensyduino 1.26.
		+
		+	== Install uGFX in arduino's library directory ==
		+
		+	Download uGFX (tested with repo state as of 2015-11-24 or later) and put it into arduino's library directory. You should end up with ''arduino libraries directory''/ugfx/src and other files and folders.
		+
		+	uGFX can not be used as a stand-alone library, but must be wrapped with an arduino library that provides a suitable interface for the build process: one header and one source file, within the library's base directory. This is done by ugfx-arduino which is installed in the next step.
		+
		+	== Install the base uGFX-arduino libraries and drivers ==
		+
		+	Download ugfx-arduino (https://github.com/crteensy/ugfx-arduino) and follow the steps included therein for installing the other sub-libraries:
		+	# put the main ugfx-arduino library into arduino's library directory. This arduino library wraps uGFX in such a way that arduino can compile it.
		+	# copy the libraries from ugfx-arduino/libraries into arduino's library directory as well. These are an example driver for the SSD1351 (ugfy-arduino-gdisp-ssd1351) and an example project-specific configuration library (example-ssd1351-ugfx-config).
		+
		+	== Resulting arduino library directory structure after installation ==
		+
		+	After carrying out the steps outlined above, your arduino library directory should look like this:
		+	<pre>
		+	libraries/
		+	\|- ugfx/
		+	\|- ...
		+	\|- src/
		+	\|- ...
		+	\|- ugfx-arduino/
		+	\|- ...
		+	\|- ugfx-arduino-gdisp-ssd1351/
		+	\|- ...
		+	\|- example-ssd1351-ugfx-config/
		+	\|- ...
		+	</pre>
		+
		+	If your directory structure looks like this, you can start (or restart) arduino and look for File->Examples->ugfx-arduino->example-ssd1351-ugfx-config. If it is there, arduino has found the library and the example contained therein. It should now compile fine.
		+
		+	== How to use ugfx-arduino in your own projects ==
		+	For each project you create, you should also have a project-specific config library. An example for such a library is included in ugfx-arduino: example-ssd1351-ugfx-config. It configures ugfx through gfxconf.h, adds a display driver header, and provides configuration information for that driver. The example consists of three files.
		+
		+	example-ssd1351-ugfx-config.h:
		+	<pre>
		+	#ifndef TEENSY31_SSD1351_UGFX_CONFIG_H
		+	#define TEENSY31_SSD1351_UGFX_CONFIG_H
		+
		+	#include <ugfx-arduino.h> // main library
		+	#include <ugfx-arduino-gdisp-ssd1351.h> // display driver library
		+
		+	#endif // TEENSY31_SSD1351_UGFX_CONFIG_H
		+	</pre>
		+	This file just includes other headers for ugfx and a display driver.
		+
		+	gfxconf.h:
		+	<pre>
		+	#ifndef _GFXCONF_H
		+	#define _GFXCONF_H
		+
		+	/* The operating system to use. One of these must be defined - preferably in your Makefile */
		+	//#define GFX_USE_OS_CHIBIOS FALSE
		+	//#define GFX_USE_OS_WIN32 FALSE
		+	//#define GFX_USE_OS_LINUX FALSE
		+	//#define GFX_USE_OS_OSX FALSE
		+	#define GFX_USE_OS_ARDUINO TRUE
		+	//#define GFX_USE_OS_RAW32 TRUE
		+
		+	/* GFX sub-systems to turn on */
		+	#define GFX_USE_GDISP TRUE
		+
		+	/* Features for the GDISP sub-system. */
		+	#define GDISP_NEED_VALIDATION TRUE
		+	#define GDISP_NEED_CLIP TRUE
		+
		+	#endif /* _GFXCONF_H */
		+	</pre>
		+	Just a normal ugfx configuration. Note that the selected operating system flag is GFX_USE_OS_ARDUINO.
		+
		+	ssd1351_pins.cpp:
		+	<pre>
		+	#include "ugfx-arduino-gdisp-ssd1351.h"
		+
		+	extern const ssd1351_pins_t ssd1351_pins = {15, 14, 16};
		+	</pre>
		+	This file provides pin number definitions for the display driver. The content of this file depends on the display driver.
		+
		+	If you want to create your own configuration for a project called ''myproject'', you have to create a new arduino library called ''myproject-ugfx-config'' in the arduino library directory. It must at least provide one header called myproject-ugfx-config.h which includes ugfx-arduino.h and a display driver header, and it must provide gfxconf.h in the same directory. The include myproject-ugfx-config.h in your main arduino sketch.