Difference between revisions of "Example atod"

From wiki.emacinc.com
Jump to: navigation, search
 
(45 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
{{todo|InProgress(11.13.13-12:59->JG+)|Jgreene|project=oe 4,oe 5,ky,md,InProgress}}
+
{{todo|SEOKWREV (12.11.13-15:24->JG+);(01.03.14-16:00->MD+);(01.03.14-18:50->KY+);(03.27.14-16:30->BS+);(04.10.14-12:05->BS+)|Jgreene|project=oe 4,oe 5,jg,md,SEOKWREV,mw,bs}}
−
<big>This procedure provides an overview of how to compile and run the ''atod_test'' C example project. It assumes familiarity with the C programming language and is intended to be used by experienced programmers who are looking to learn the EMAC SDK.</big>
 
  
−
====1. Open the ''C/C++'' editing perspective====
+
{{#seo:
 +
|title=Example atod
 +
|titlemode=append
 +
|keywords=AtoD,mcp3208,Device Channels
 +
|description=This is a guide to the atod_test C example project included in the EMAC OE SDK.
 +
}}
  
−
From the Eclipse menubar select ''Window->Open Perspective->Other...''
+
This is a guide to the <code>atod_test</code> C example project included in the EMAC OE SDK.
  
−
Select ''C/C++'' and click ''OK''.
+
This application reads all channels of an ''indexed atod device'' and reports the values read from those channels to the console. Examples of this type of device are the processor AtoDs on the SoM-9260/9G20 and the IPAC-9302; and the mcp3208 external AtoD devices on the SoM-150ES carrier (see [[#Hardware Requirements|hardware requirements]], below).
  
−
[[File:Open_perspective.jpg|left|Figure 1: Select C/C++ Perspective.]]
+
The <code>atod_test</code> project builds one executable: <code>indexed_atod_test</code>.
  
−
<br clear=all>
+
== Opening, Building and Uploading the Project Files ==
  
−
====2. Open the ''atod_test'' project====
 
  
−
From the Eclipse menubar select ''File->New->Makefile Project With Existing Code...''
+
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.
  
−
Click the ''Browse'' button and navigate to the directory of the ''atod_test'' example project.
 
  
−
The ''atod_test'' example project source can be found in the projects/ subdirectory of the EMAC OE SDK root directory. The full path is:<br />
+
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]].
−
    <code bash> /path/to/sdk/EMAC-OE-arm-linux-gnueabi-SDK_4.0/projects/atod_test/ </code>
 
  
−
After you have successfully specified the path to the ''atod_test'' project directory, click ''Finish''.<br />
+
==Usage and Behavior==
  
−
[[File:Example_atod_Import_existing_code.jpg|450px|left|Figure 2: Specify the location of the atod_test project.]]
+
===Hardware Requirements===
  
−
<br clear=all>
+
The <code>atod_test</code> project requires a device with indexed atod functionality, ie: A SoM-9260, a SoM-9G20 or an IPAC-9302.<br />
 +
You can also use a SoM-150ES carrier (using the mcp3208 external AtoD device through /dev/mcp3208-gpio). This interface uses the EMAC ioex class to provide a GPIO-like device where each channel can be read directly (see also the [http://wikidev.emacinc.com/wiki/Example_egpc egpc example project]).
  
 +
<gallery mode="packed">
 +
File:Som 9260.jpg|SoM-9260
 +
File:Som 9G20.jpg|SoM-9G20
 +
File:IPAC-9302.jpg|IPAC-9302
 +
File:SoM-150ES.jpg|SoM-150ES
 +
</gallery>
  
−
====3. Build, upload and run====
+
===Using <code>atod_test</code>===
  
 +
indexed_atod_test DEVICE CHANNELS
  
−
==What it does==
+
Where DEVICE is the path to the device to read and CHANNELS is the number of channels to read.
  
−
''atod_test'' reads all channels of an indexed atod device and outputs the results to the terminal.
+
===Usage Example===
  
−
Usage: indexed_atod_test DEVICE CHANNELS<br />
+
<syntaxhighlight lang="text">
−
i.e. : ./indexed_atod_test /dev/indexed_atod 4
+
root@som9g20:/tmp# ./indexed_atod_test /dev/indexed_atod 4
 +
[0] = 19
 +
[1] = 76
 +
[2] = 18
 +
[3] = 22
 +
</syntaxhighlight>
  
−
''From the comments in <code>index_atod_test.c</code>''
+
==Summary==
  
−
    Example application for reading all channels of an indexed atod device
+
The <code>atod_test</code> C example project demonstrates reading the channels of an indexed atod device.
−
    on EMAC OE Linux. Examples of this type of device are the processor
 
−
    AtoDs on the SoM-9260/9G20 and the IPAC-9302 and the mcp3208 external
 
−
    AtoD devices on the SoM-150ES carrier (through the /dev/mcp3208-gpio
 
−
    device. This interface uses the EMAC ioex class to provide a GPIO-like
 
−
    device where each channel can be read directly.(see also the egpc project).
 

Latest revision as of 11:04, 10 April 2014

TODO: {{#todo:SEOKWREV (12.11.13-15:24->JG+);(01.03.14-16:00->MD+);(01.03.14-18:50->KY+);(03.27.14-16:30->BS+);(04.10.14-12:05->BS+)|Jgreene|oe 4,oe 5,jg,md,SEOKWREV,mw,bs}}

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

This application reads all channels of an indexed atod device and reports the values read from those channels to the console. Examples of this type of device are the processor AtoDs on the SoM-9260/9G20 and the IPAC-9302; and the mcp3208 external AtoD devices on the SoM-150ES carrier (see hardware requirements, below).

The atod_test project builds one executable: indexed_atod_test.

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

Hardware Requirements

The atod_test project requires a device with indexed atod functionality, ie: A SoM-9260, a SoM-9G20 or an IPAC-9302.
You can also use a SoM-150ES carrier (using the mcp3208 external AtoD device through /dev/mcp3208-gpio). This interface uses the EMAC ioex class to provide a GPIO-like device where each channel can be read directly (see also the egpc example project).

  • SoM-9260

  • SoM-9G20

  • IPAC-9302

  • SoM-150ES

Using atod_test

indexed_atod_test DEVICE CHANNELS

Where DEVICE is the path to the device to read and CHANNELS is the number of channels to read.

Usage Example

root@som9g20:/tmp# ./indexed_atod_test /dev/indexed_atod 4
[0] = 19
[1] = 76
[2] = 18
[3] = 22

Summary

The atod_test C example project demonstrates reading the channels of an indexed atod device.

Retrieved from "https://wiki.emacinc.com/index.php?title=Example_atod&oldid=3553"