Difference between revisions of "Example egpc"

From wiki.emacinc.com
Jump to: navigation, search
 
(21 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{todo|InProgress(11.13.13-14:31->JG+)|Jgreene|project=oe 4,oe 5,jg,md,InProgress}}
+
{{todo|SEOKWREV - revise for 5.00 (12.27.13-14:22->JG+);(12.30.13-17:20->MD+);(01.02.14-11:20->KY+);(03.27.14-16:45->BS+);(04.10.14-12:20->BS+)|Jgreene|project=oe 4,oe 5,jg,md,bs,SEOKWREV}}
 +
 
 +
 
 +
{{#seo:
 +
|title=Example egpc
 +
|titlemode=append
 +
|keywords=Port Configuration,Port Data,Port Index,GPIO
 +
|description=This is a guide to the egpc C example project included in the EMAC OE SDK.
 +
}}
 
This is a guide to the <code>egpc</code> C example project included in the EMAC OE SDK.
 
This is a guide to the <code>egpc</code> C example project included in the EMAC OE SDK.
  
<code>egpc</code> is an application for reading/writing/configuring gpio character devices. Specifically, we read/write/configure the 3 ports (ports A, B and C) on the GPIO header.
+
<code>egpc</code> is an application for reading/writing/configuring gpio character devices. Specifically, it will read/write/configure the 3 ports (ports '''A''', '''B''' and '''C''') on the GPIO header.
  
 
The <code>egpc</code> project builds one executable: <code>egpc</code>.
 
The <code>egpc</code> project builds one executable: <code>egpc</code>.
Line 8: Line 16:
 
== Opening, Building and Uploading the Project Files ==
 
== Opening, Building and Uploading the Project Files ==
  
<big>1. Open the C/C++ editing perspective.</big>
+
For information on opening the project from within Eclipse, please see [[Importing the EMAC OE SDK Projects with Eclipse]]. Then, follow [[Using the EMAC OE SDK Projects with Eclipse]] for information on how to build, upload and execute the example.
 
 
stub
 
 
 
<big>2. Open the project files.</big>
 
 
 
stub
 
 
 
<big>3. Build the project.</big>
 
 
 
stub
 
  
<big>4. Upload the executables to the target system.</big>
+
Alternatively, the <code>Makefile</code> can be used with the <code>make</code> command from the commandline to build and upload the example.  For more information on this method, please see [[Using EMAC OE SDK Example Projects]].
 
 
stub
 
  
 
==Usage and Behavior==
 
==Usage and Behavior==
Line 30: Line 26:
 
===Hardware Requirements===
 
===Hardware Requirements===
  
The <code>egpc</code> C example project will run on any EMAC carrier board.  
+
The <code>egpc</code> C example project will run on any EMAC carrier board which has one or more GPIO.  
 
 
'''VERIFY THIS'''
 
  
 
===Using <code>egpc</code>===
 
===Using <code>egpc</code>===
  
  ./egpc device d/c/i (mask)
+
  ./egpc ''device'' ''[d/c/i]'' ''arg''
  
'''device''' is /dev/porta, /dev/portb or /dev/portc<br />
+
''device'' is <code>/dev/porta</code>, <code>/dev/portb</code> or <code>/dev/portc</code><br />
'''d/c/i''' specifies the port command : d(data), c(configure) or i(index)<br />
+
''d/c/i'' specifies the port command : <code>d</code> (data), <code>c</code> (configure) or <code>i</code> (index)<br />
'''mask''' is a bitmask in hex format in range [0x0,0xff].  
+
''arg'' is either a port index or a bitmask. The bitmask is in hex format, range <code>[0x00,0xff]</code>.
  
 
===Usage Example. Port Configuration===
 
===Usage Example. Port Configuration===
If a mask is specified it configures the pins for input/output.<br />
+
 
If no mask is specified it returns the current configuration.<br />   
+
./egpc ''device'' c ''[mask]''
'''mask''' is an input/output bitmask. 1=output and 0=input.<br />                     
+
 
For example, this sets every other pin on PortA to be an output.  
+
If a mask is specified, it configures the pins for input/output.<br />
 +
If no mask is specified, it returns the current configuration.<br />   
 +
''mask'' is an input/output bitmask. <code>1</code>=output and <code>0</code>=input.<br />                     
 +
For example, this sets every other pin on '''Port A''' to be an output.  
 
                                          
 
                                          
  ./egpc /dev/porta c 0xaa  
+
  ./egpc /dev/porta c 0xaa
                   
+
 
...and this reads the current pin configuration state of PortA.
+
...and this reads the current pin configuration state of '''Port A'''.
  
 
  ./egpc /dev/porta c     
 
  ./egpc /dev/porta c     
 
  0xaa
 
  0xaa
  
===Usage Example. Port Data===
+
===Usage Example: Port Data===
 +
 
 +
./egpc device d ''[mask]''
  
'''d''' (mask)<br />           
 
 
If a mask is specified then it sets each bit's corresponding pin output latch to high/low accordingly.<br />
 
If a mask is specified then it sets each bit's corresponding pin output latch to high/low accordingly.<br />
 
If a mask is not specified then the current pin state is retrieved.<br />
 
If a mask is not specified then the current pin state is retrieved.<br />
For example, this writes all pin ouput latches on PortA to high.
 
  
  ./egpc /dev/porta d 0xff
+
For example, this writes pin output latches on '''Port C''' to alternating high and low.
 +
 
 +
  ./egpc /dev/portc d 0x55
 +
 
 +
This flips the pins, writing all the pins that were set low in the previous command to high, and vice-versa:
  
...and this reads the current pin data state of PortA
+
./egpc /dev/portc d 0xaa
  
./egps /dev/porta d
+
This reads the current pin data state of '''Port C'''.
       
 
  
===Usage Example. Writing to Port C===
+
./egps /dev/portc d
  
We write a data bitmask to Port C. The values are rendered in our LED strip. (note that only PortC is displayed in the LED strip. Ports A or B would require kind of device to read them; a multimeter or oscilloscope or something like that.)
+
The pin values for '''Port C''' are displayed on the board's strip of 8 LEDs. Observe that the LEDs change state when a new value is written to '''Port C'''. This only works for '''Port C''', however. '''Ports A''' and '''B''' must be read with an oscilloscope, multimeter, logic analyzer or similar device.
  
  ./egpc /dev/portc d 0x55
+
===Usage Example. Port Index===
 +
 
 +
./egpc device i (index)
 +
 
 +
If an index is specified then it sets the port's index<br />
 +
If an index is not specified then the port's current index is retrieved.<br />
 +
 
 +
For example, this sets the index of '''Port A''' to 1
 +
 
 +
  ./egpc /dev/porta i 1
  
LEDs 1-8 are lit: 10101010
+
...and this reads the current index of '''Port A'''
  
'''MIKE I was thinking that maybe we could have some kind of general purpose "know your board" images (I have created a few) or wiki pages. They would point out things like the GPIO header and the LED strip.'''
+
./egpc /dev/porta i
  
./egpc /dev/portc d 0xaa
+
==Summary==
  
LEDs 1-8 are lit: 01010101
+
<code>egpc</code> is an application which demonstrates reading, writing and configuring the GPIO ports.

Latest revision as of 12:19, 10 April 2014

TODO: {{#todo:SEOKWREV - revise for 5.00 (12.27.13-14:22->JG+);(12.30.13-17:20->MD+);(01.02.14-11:20->KY+);(03.27.14-16:45->BS+);(04.10.14-12:20->BS+)|Jgreene|oe 4,oe 5,jg,md,bs,SEOKWREV}}


This is a guide to the egpc C example project included in the EMAC OE SDK.

egpc is an application for reading/writing/configuring gpio character devices. Specifically, it will read/write/configure the 3 ports (ports A, B and C) on the GPIO header.

The egpc project builds one executable: egpc.

Opening, Building and Uploading the Project Files

For information on opening the project from within Eclipse, please see Importing the EMAC OE SDK Projects with Eclipse. Then, follow Using the EMAC OE SDK Projects with Eclipse for information on how to build, upload and execute the example.

Alternatively, the Makefile can be used with the make command from the commandline to build and upload the example. For more information on this method, please see Using EMAC OE SDK Example Projects.

Usage and Behavior

egpc reads/writes/configures the GPIO ports.

Hardware Requirements

The egpc C example project will run on any EMAC carrier board which has one or more GPIO.

Using egpc

./egpc device [d/c/i] arg

device is /dev/porta, /dev/portb or /dev/portc
d/c/i specifies the port command : d (data), c (configure) or i (index)
arg is either a port index or a bitmask. The bitmask is in hex format, range [0x00,0xff].

Usage Example. Port Configuration

./egpc device c [mask]

If a mask is specified, it configures the pins for input/output.
If no mask is specified, it returns the current configuration.
mask is an input/output bitmask. 1=output and 0=input.
For example, this sets every other pin on Port A to be an output.

./egpc /dev/porta c 0xaa

...and this reads the current pin configuration state of Port A.

./egpc /dev/porta c     
0xaa

Usage Example: Port Data

./egpc device d [mask]

If a mask is specified then it sets each bit's corresponding pin output latch to high/low accordingly.
If a mask is not specified then the current pin state is retrieved.

For example, this writes pin output latches on Port C to alternating high and low.

./egpc /dev/portc d 0x55

This flips the pins, writing all the pins that were set low in the previous command to high, and vice-versa:

./egpc /dev/portc d 0xaa

This reads the current pin data state of Port C.

./egps /dev/portc d

The pin values for Port C are displayed on the board's strip of 8 LEDs. Observe that the LEDs change state when a new value is written to Port C. This only works for Port C, however. Ports A and B must be read with an oscilloscope, multimeter, logic analyzer or similar device.

Usage Example. Port Index

./egpc device i (index)

If an index is specified then it sets the port's index
If an index is not specified then the port's current index is retrieved.

For example, this sets the index of Port A to 1

./egpc /dev/porta i 1

...and this reads the current index of Port A

./egpc /dev/porta i

Summary

egpc is an application which demonstrates reading, writing and configuring the GPIO ports.