Example io demo UPDATE 2019 - Revision history

CBost at 21:28, 19 July 2019

2019-07-19T21:28:18Z

2019-07-19T20:42:10Z

2019-07-19T20:40:28Z

2019-07-08T18:16:52Z

‎Examples

2019-07-08T18:16:00Z

2019-07-08T18:13:41Z

2019-07-08T18:12:11Z

2019-07-08T16:50:40Z

2019-07-08T16:49:04Z

2019-07-08T16:47:40Z

@@ Line 51: / Line 51: @@
 '''gpiomon'''    - wait for events on GPIO lines, specify which events to watch,how many events to process before exiting or if the events should be reported to the console"
 == GPIO manipulation in C ==
 A more common manipulation of GPIOs is through a C program. The following example will demonstrated GPIO manipulation using the Libgpiod libary.

← Older revision		Revision as of 20:42, 19 July 2019
Line 9:		Line 9:
	This demo covers basic GPIO usage for the IPAC single board computer, and 150 and 200 series carrier boards. This demo first cover GPIO manipulation through the Linux terminal and then demonstrates gpio usage in a C program using an io example program.		This demo covers basic GPIO usage for the IPAC single board computer, and 150 and 200 series carrier boards. This demo first cover GPIO manipulation through the Linux terminal and then demonstrates gpio usage in a C program using an io example program.

−	GPIO control is accomplished through use of the libgpiod driver, as ~~such~~ only the libgpiod library will be covered in this tutorial. For manipulation of non-GPIO peripherals use sysfs.	+	GPIO control is accomplished through use of the libgpiod driver, as a result only the libgpiod library will be covered in this tutorial. For manipulation of non-GPIO peripherals use sysfs.

@@ Line 9: / Line 9: @@
 This demo covers basic GPIO usage for the IPAC single board computer, and 150 and 200 series carrier boards. This demo first cover GPIO manipulation through the Linux terminal and then demonstrates gpio usage in a C program using an io example program.
 ===Hardware Requirements===
 To use the '''io demo''' program you will need the following target hardware.
@@ Line 33: / Line 35: @@
 == GPIO manipulation  through Linux Terminal ==
-GPIOs can be manipulated directly through the target devices serial terminal. The Libgpiod libary is used for this purpose. Linux terminal commands are defined in the libgpiod github readme (https://github.com/brgl/libgpiod) and are listed here for convenience:
+GPIOs can be manipulated directly through the target devices serial terminal. The Libgpiod libary is used for this purpose. Linux terminal commands are defined in the libgpiod github readme (https://git.kernel.org/pub/scm/libs/libgpiod/libgpiod.git/tree) and are listed here for convenience:
 "There are currently six command-line tools available: <br />

← Older revision		Revision as of 18:16, 8 July 2019
Line 246:		Line 246:


−	All examples use the Libgpiod libary ('''#include <gpiod.h>'''), with example 4 using custom built functions provided in EMAC_Libgpiod.h. <br />	+	All examples use the Libgpiod libary ('''#include <gpiod.h>'''), with example 4 using custom built functions provided in '''EMAC_Libgpiod.h'''. <br />

	'''EXAMPLE_1''' demonstrates basic IO configuration using Libgpiod's contextless functions <br />		'''EXAMPLE_1''' demonstrates basic IO configuration using Libgpiod's contextless functions <br />

@@ Line 222: / Line 222: @@
 </ol>
-=== Examples ===
+== Examples ==
 As previously stated the main.c program must be configured to run for your target device. In the main.c file select your target device by un-commenting the '''#define''' preprocessor directive corresponding to the device you're using. All other devices should be commented out.

@@ Line 236: / Line 236: @@
 Similarly, 1 of 4 example programs can be selected to run, un-comment 1 of the "example" '''#define''' preprocessor directives and leave the rest commented out. Changes these options will require rebuilding of the program (Simply press the green play button again, this should automatically rebuild and launch the project on the target device.)
+<syntaxhighlight lang="c">
 //In main.c

@@ Line 210: / Line 210: @@
 *Click '''OK'''.
-*Now, on the left side of Qt Creator, you will see the project icon, which looks like a monitor. Click this and select '''Release''' or '''Debug''' under build.
+<li>Now, on the left side of Qt Creator, you will see the project icon, which looks like a monitor. Click this and select '''Release''' or '''Debug''' under build.</li>
 {{note|If multiple build options were selected three sub-menus will appear ('''Kit, Build''' and '''Run'''). Click this and make sure '''Arm Qt5''' is selected under '''Kit''', '''Release''' is selected under '''Build''', and the project is set to be run on the remote device under '''Run'''.
@@ Line 219: / Line 219: @@
 <br clear=all>
-Now, simply press the green play button. The program should run on the target device and yield an output.
+<li>Now, simply press the green play button. The program should run on the target device and yield an output.</li>
 </ol>

@@ Line 148: / Line 148: @@
 '''End of Options, Continuing:'''<br />
 <ol start = 6>
-<ls>Open main.c under '''LibGPIOd_example->Sources''' and copy and paste the provided [http://git.emacinc.com/OE/qt-creator-example-projects/raw/master/libgpiod_io_example/main.c main.c].</li>
+<li>Open main.c under '''LibGPIOd_example->Sources''' and copy and paste the provided [http://git.emacinc.com/OE/qt-creator-example-projects/raw/master/libgpiod_io_example/main.c main.c].</li>
 *Note, the program must be configured to run for your target device. In the main.c file select your target device by un-commenting the #define preprocessor directive corresponding to the device '''you're using'''. All other devices should be commented out. For this example we're using a 150ES carrier board so we'll select the '''CARRIER_BOARD_150'''.

@@ Line 148: / Line 148: @@
 '''End of Options, Continuing:'''<br />
 <ol start = 6>
-<ls>Open main.c under '''LibGPIOd_example->Sources''' and copy and paste the provided [http://git.emacinc.com/OE/qt-creator-example-projects/raw/master/libgpiod_io_example/main.c main.c].</ls>
+<ls>Open main.c under '''LibGPIOd_example->Sources''' and copy and paste the provided [http://git.emacinc.com/OE/qt-creator-example-projects/raw/master/libgpiod_io_example/main.c main.c].</li>
 *Note, the program must be configured to run for your target device. In the main.c file select your target device by un-commenting the #define preprocessor directive corresponding to the device '''you're using'''. All other devices should be commented out. For this example we're using a 150ES carrier board so we'll select the '''CARRIER_BOARD_150'''.
@@ Line 171: / Line 171: @@
 *select '''File->Save All''', All necessary files have now been added to the project
-* Configure build options
+<li>Configure build options</li>
 *Go to '''Tools->Options...''' to open the options window
 *Select Devices in the left hand column to open the Devices tab