Serial Device - Revision history

Costel Mincea: Text replacement - "" to ""

2025-01-26T19:05:33Z

Text replacement - "<syntaxhighlight>" to "<syntaxhighlight lang="C" line>"

Janne Peräaho: /* Alternative Modes for Serial Input or Output */

2020-06-24T02:46:57Z

Alternative Modes for Serial Input or Output

← Older revision		Revision as of 02:46, 24 June 2020
Line 231:		Line 231:
	</syntaxhighlight>		</syntaxhighlight>

			Most applications will want to wait on multiple signals. A typical application will wait for menu messages from Intuition at the same time as replies from the serial device. The following fragment demonstrates waiting for one of three signals. The Wait() will wake up if the read request ever finishes, or if the user presses <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">Ctrl</kbd> + <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">C</kbd> or <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">Ctrl</kbd> + <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">F</kbd> from the Shell. This fragment may be inserted into the above complete example.
	Most applications will want to wait on multiple signals. A typical application will wait for menu messages from Intuition at the same time as replies from the serial device. The following fragment demonstrates waiting for one of three signals. The Wait() will wake up if the read request ever finishes, or if the user presses Ctrl-C or Ctrl-F from the Shell. This fragment may be inserted into the above complete example.

	<syntaxhighlight>		<syntaxhighlight>

Lyle Hazelwood: /* Multiple Serial Port Support */ Unit 0 numbering changed

2014-05-28T02:57:34Z

Multiple Serial Port Support: Unit 0 numbering changed

← Older revision		Revision as of 02:57, 28 May 2014
Line 649:		Line 649:
	== Multiple Serial Port Support ==		== Multiple Serial Port Support ==

	Applications that use the serial port should provide the user with a means to select the name and unit number of the driver. The defaults will be “serial.device” and unit number 0. Typically unit 0 ~~refers to the user-selected default. Unit 1~~ refers to the built-in serial port. Numbers above 1 are for extended units. The physically lowest connector on a board will always have the lowest unit number.		Applications that use the serial port should provide the user with a means to select the name and unit number of the driver. The defaults will be “serial.device” and unit number 0. Typically unit 0 refers to the built-in serial port. Numbers above 0 are for extended units. The physically lowest connector on a board will always have the lowest unit number.

	Careful attention to error handling is required to survive in a multiple port environment. Differing serial hardware will have different capabilities. The device will refuse to open non-existent unit numbers (symbolic name mapping of unit numbers is not provided at the device level). The SDCMD_SETPARAMS command will fail if the underlying hardware cannot support your parameters. Some devices may use quick I/O for read or write requests, others will not. Watch out for partially completed read requests; io_Actual may not match your requested read length.		Careful attention to error handling is required to survive in a multiple port environment. Differing serial hardware will have different capabilities. The device will refuse to open non-existent unit numbers (symbolic name mapping of unit numbers is not provided at the device level). The SDCMD_SETPARAMS command will fail if the underlying hardware cannot support your parameters. Some devices may use quick I/O for read or write requests, others will not. Watch out for partially completed read requests; io_Actual may not match your requested read length.

Paul Sadlik: /* Alternative Modes for Serial Input or Output */

2013-09-22T18:19:00Z

Alternative Modes for Serial Input or Output

← Older revision		Revision as of 18:19, 22 September 2013
Line 240:		Line 240:
	* NOTE: A signal may show up without an associated message!		* NOTE: A signal may show up without an associated message!
	*/		*/

	//signal = IExec->Wait(rxsig \| SIGBREAKF_CTRL_C);

	uint32 WaitMask;		uint32 WaitMask;
	uint32 Temp;		uint32 Temp;

	WaitMask = SIGBREAKF_CTRL_C\|		WaitMask = SIGBREAKF_CTRL_C\|
	SIGBREAKF_CTRL_F\|		SIGBREAKF_CTRL_F\|

Paul Sadlik: /* Alternative Modes for Serial Input or Output */

2013-09-22T18:15:28Z

Alternative Modes for Serial Input or Output

@@ Line 235: / Line 235: @@
 <syntaxhighlight>
 /* Precalculate a wait mask for the CTRL-C, CTRL-F and message
- * port signals.  When one or more signals are received,
+ * port signals.  When one or more signals are received,
- * Wait() will return.  Press CTRL-C to exit the example.
+ * Wait() will return.  Press CTRL-C to exit the example.
  * Press CTRL-F to wake up the example without doing anything.
  * NOTE: A signal may show up without an associated message!
- */
+*/
-           IDOS->Printf("%ld bytes received\n", SerialIO->IOSer.io_Actual);
+	IDOS->Printf("Just woke up (YAWN!)\n");
-IExec->WaitIO(SerialIO);   /* Wait for abort, then clean up */
+	if (IExec->CheckIO((struct IORequest *)SerialIO) ) /* If request is complete... */
 </syntaxhighlight>

Steven Solie: /* Error Codes from the Serial Device */

2013-04-29T18:16:15Z

Error Codes from the Serial Device

← Older revision		Revision as of 18:16, 29 April 2013
Line 616:		Line 616:

	The error is returned in the io_Error field of the IOExtSer structure.		The error is returned in the io_Error field of the IOExtSer structure.

⚫	Serial Device Error Codes

	{\| class="wikitable"		{\| class="wikitable"
		⚫	\|+ Serial Device Error Codes
	! Error		! Error
	! Value		! Value

Steven Solie: /* Querying the Serial Device */

2013-04-29T18:15:52Z

Querying the Serial Device

← Older revision		Revision as of 18:15, 29 April 2013
Line 558:		Line 558:
	The 16 status bits of the serial device are returned in io_Status; the number of unread characters is returned in io_Actual.		The 16 status bits of the serial device are returned in io_Status; the number of unread characters is returned in io_Actual.

⚫	~~'''~~Serial Device Status Bits~~'''~~
	{\| class="wikitable"		{\| class="wikitable"
		⚫	\|+ Serial Device Status Bits
	! Bit		! Bit
	! Active		! Active

Steven Solie: /* Serial Device */

2013-04-29T18:13:53Z

Serial Device

← Older revision		Revision as of 18:13, 29 April 2013
Line 4:		Line 4:
	The serial device provides a hardware-independent interface to the Amiga’s built-in RS-232C compatible serial port. Serial ports have a wide range of uses, including communication with modems, printers, MIDI devices, and other computers. The same device interface can be used for additional “byte stream oriented devices”—usually more serial ports. The serial device is based on the conventions of Exec device I/O, with extensions for parameter setting and control.		The serial device provides a hardware-independent interface to the Amiga’s built-in RS-232C compatible serial port. Serial ports have a wide range of uses, including communication with modems, printers, MIDI devices, and other computers. The same device interface can be used for additional “byte stream oriented devices”—usually more serial ports. The serial device is based on the conventions of Exec device I/O, with extensions for parameter setting and control.

⚫	~~'''~~Serial Device Characteristics~~'''~~
	{\| class="wikitable"		{\| class="wikitable"
		⚫	\|+ Serial Device Characteristics
	\| Modes		\| Modes
	\| Exclusive, Shared Access		\| Exclusive, Shared Access

Steven Solie at 19:23, 3 April 2013

2013-04-03T19:23:51Z

← Older revision		Revision as of 19:23, 3 April 2013
Line 1:		Line 1:
	[[Category:Devices\|Serial]]~~{{NeedUpdate}}~~		[[Category:Devices\|Serial]]
	== Serial Device ==		== Serial Device ==

Steven Solie: /* Advanced Example of Serial Device Usage */

2013-04-03T19:23:14Z

Advanced Example of Serial Device Usage

Show changes