Difference between revisions of "Board File"

From uGFX Wiki
Jump to: navigation, search
(Created page with "A board file is a file which a module needs in order to communicate with the hardware.")
 
(Templates)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
A board file is a file which a module needs in order to communicate with the hardware.
+
Certain [[Architecture#Module|modules]] have to communicate to hardware in order to fulfil their tasks. Those modules come with an additional driver layer. Each driver then needs a board file to talk to the actual hardware.<br/>
 +
The board file needs to be provided by the user as it's implementation depends not only on the used underlying system (HAL), but also the actual hardware configuration (wiring).
 +
 
 +
== Templates ==
 +
Each driver provides a template of it's board file. Copying this file to your project directory and implementing the routines is all there is to do. Note that you have to remove the <code>_template</code> part from the file name.
 +
 
 +
== Supported Boards ==
 +
Some boards have predefined hardware on them. Where they are a common board we provide a makefile (''/boards/base/xxx/board.mk'') which you can include into your own project makefile. This will then automatically include all the standard hardware drivers and board files.
 +
Additional pre-defined board files can also be found in ''/boards/addons''.
 +
 
 +
== Modules ==
 +
The following modules require a board file:
 +
* [[GDISP]]
 +
* [[GINPUT]]
 +
* [[GAUDIO]]
 +
 
 +
 
 +
[[Category:General]]

Latest revision as of 19:27, 19 December 2016

Certain modules have to communicate to hardware in order to fulfil their tasks. Those modules come with an additional driver layer. Each driver then needs a board file to talk to the actual hardware.
The board file needs to be provided by the user as it's implementation depends not only on the used underlying system (HAL), but also the actual hardware configuration (wiring).

Templates

Each driver provides a template of it's board file. Copying this file to your project directory and implementing the routines is all there is to do. Note that you have to remove the _template part from the file name.

Supported Boards

Some boards have predefined hardware on them. Where they are a common board we provide a makefile (/boards/base/xxx/board.mk) which you can include into your own project makefile. This will then automatically include all the standard hardware drivers and board files. Additional pre-defined board files can also be found in /boards/addons.

Modules

The following modules require a board file: