Asynchronous Serial Communications Programmer's Reference Manual (32022-90052)

4
Contents
Other Types of Intrinsics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Using Intrinsics in your Program . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Condition Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Status Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Abort Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Optional Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Obtaining Information Using Intrinsics . . . . . . . . . . . . . . . . . . . . . . 53
Status Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Functional Returns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
3. Common Device Control Functions
Opening Asynchronous Devicefiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
File Open Intrinsics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Reading From Asynchronous Devices. . . . . . . . . . . . . . . . . . . . . . . . . . 60
Input Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Character Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Block Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Field Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Data Editing Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Standard Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Transparent Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Binary Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Triggering Reads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Terminating Reads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
End of File Indicators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Using FREAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Timing a Read. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Setting a Read Time Limit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Using READ or READX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Writing to Asynchronous Devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Using FWRITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Sending Escape Sequences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Using PRINT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Altering Terminal Deficefiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Specifying an AEOR Character . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Altering Device Control Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Setting Transparent Editing Mode . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Setting Binary Editing Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Closing Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
4. Using FDEVICECONTROL
Syntax Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Setting Transparent Editing Mode . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Specifying an End-of-Record Character . . . . . . . . . . . . . . . . . . . . . . 98
Controlling Backspace Processing. . . . . . . . . . . . . . . . . . . . . . . . . . 100
Controlling Device XON/XOFF Processing. . . . . . . . . . . . . . . . . . . 104
Controlling Host and Device XON/XOFF Processing. . . . . . . . . . . 106