Nperkins at 19:21, 30 November 2022

2022-11-30T19:21:51Z

Btisler: Renamed page to match 0E5 SDK projects

2020-09-25T16:27:18Z

Renamed page to match 0E5 SDK projects

New page

{{todo|SEOKWREV (12.31.13-14:56->JG+);(1.2.14-11:20->MD+);(1.2.14-15:35->MG+);(04.07.14-10:00->BS+);(04.10.14-11:20->BS+)|Jgreene|project=oe 4,oe 5,jg,md,SEOKWREV,mg,bs}}

{{#seo:
|title=serial test
|titlemode=append
|keywords=Serial Test,Serial Port,Asynchronous
|description=This is a guide to the <code>serial</code> C example project included in the EMAC OE SDK.
}}
This is a guide to the <code>serial</code> C example project included in the EMAC OE SDK.

This application sets up and tests asynchronous IO on a serial port using '''poll()''' and '''fasync()'''.

The <code>serial</code> project builds one executable: <code>serial_test</code>.

== 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 <code>Makefile</code> can be used with the <code>make</code> command from the commandline to build and upload the example. For information on this method, please see [[Using EMAC OE SDK Example Projects]].

====EMAC SDK 5.X====

For information on opening the project from within QtCreator, please see [[Getting_Started_With_Qt_Creator#Adding_Source_Files | QtCreator: Adding Source Files]]. Then, follow [[Getting Started With Qt Creator]] for information on how to build, upload and execute the example.

Alternatively, the <code>CMakefile.txt</code> can be used with the <code>cmake</code> command from the commandline to build and upload the example. For information on this method, please see [[Getting_Started_with_the_EMAC_OE_SDK#Target_Machine_Compiling | Getting Started with the EMAC OE SDK]].

==Usage and Behavior==

<code>serial_test</code> performs an asynchronous IO test on the specified serial device using either '''poll''' or '''FASYNC''' mode. It performs the test, reports, tests, report, etc. It will keep running until it is stopped manually via '''CTRL-C'''.

===Hardware Requirements===

It should run just fine on any device with a serial port.

===Using <code>serial_test</code>===

<code>./serial_test DEVICE -[p] [-f]</code>

;DEVICE: The serial device to use
;-p: Use '''poll''' mode for asynchronous IO
;-f: Use '''FASYNC''' mode for asynchronous IO

===Usage Example: Test asynchronous IO using the '''poll''' mode===

Perform the test on device <code>/dev/ttyS1</code>

<syntaxhighlight lang="text">
root@som9g20:/tmp# ./serial_test /dev/ttyS1 -p
Testing on /dev/ttyS1 using poll()
Received: : 21
Received: : 11
Received: : 6
Received: : 2
Received: : 1
Received: : 1
.
.
.
Received: : 1
Received: : 1
Received: : 1
^C
</syntaxhighlight>

Hit CTRL-C to stop testing. In this example, no errors were reported.

===Usage Example. Test asynchronous IO using the '''FASYNC''' mode===

Perform the test on device <code>/dev/ttyS1</code>

<syntaxhighlight lang="text">
root@som9g20:/tmp# ./serial_test /dev/ttyS1 -f
Testing on /dev/ttyS1 using FASYNC
Received SIGIO signal.
: : 21
Received SIGIO signal.
: : 11
Received SIGIO signal.
: : 6
Received SIGIO signal.
: : 2
Received SIGIO signal.
: : 1
Received SIGIO signal.
: : 1
Received SIGIO signal.
: : 1
.
.
.
Received SIGIO signal.
: : 1
Received SIGIO signal.
: : 1
Received SIGIO signal.
: : 1
^C
</syntaxhighlight>

Hit CTRL-C to stop testing. In this example, no errors were reported.

==Summary==

The <code>serial</code> C example project application performs an asynchronous IO test on the specified serial device using either '''poll''' or '''FASYNC''' mode.

← Older revision		Revision as of 19:21, 30 November 2022
Line 25:		Line 25:
	Alternatively, the <code>CMakefile.txt</code> can be used with the <code>cmake</code> command from the commandline to build and upload the example. For information on this method, please see [[Getting_Started_with_the_EMAC_OE_SDK#Target_Machine_Compiling \| Getting Started with the EMAC OE SDK]].		Alternatively, the <code>CMakefile.txt</code> can be used with the <code>cmake</code> command from the commandline to build and upload the example. For information on this method, please see [[Getting_Started_with_the_EMAC_OE_SDK#Target_Machine_Compiling \| Getting Started with the EMAC OE SDK]].

		+	Code can be found at http://git.emacinc.com/OE/example-projects
	==Usage and Behavior==		==Usage and Behavior==

Example serial - Revision history

Nperkins at 19:21, 30 November 2022

Btisler: Renamed page to match 0E5 SDK projects