61 lines
1.5 KiB
Markdown
61 lines
1.5 KiB
Markdown
---
|
|
layout: page
|
|
title: PCx86 <serial> Element
|
|
permalink: /docs/pcx86/serial/
|
|
redirect_from:
|
|
- /docs/pcjs/serial/
|
|
---
|
|
|
|
PCx86 SerialPort Component
|
|
---
|
|
|
|
Format
|
|
---
|
|
```xml
|
|
<serial>...</serial>
|
|
```
|
|
|
|
Purpose
|
|
---
|
|
Creates an instance of the SerialPort component, which simulates an IBM PC Asynchronous Adapter (RS-232).
|
|
|
|
Attributes
|
|
---
|
|
* *adapter* (required)
|
|
|
|
A number (1 or 2) indicating whether this is a "Primary" or "Secondary" adapter.
|
|
The former uses port 0x3F8 and IRQ 4, the latter uses port 0x2F8 and IRQ 3.
|
|
|
|
* *binding* (optional)
|
|
|
|
The name of an existing control binding (typically a <textarea>) to optionally redirect port I/O to.
|
|
For example, if you've defined a Control Panel with a <textarea> control bound to "print", specifying a
|
|
binding of "print" for the Serial Port component will bind its port to the same control.
|
|
|
|
Also supports the attributes of *[Component](/docs/pcx86/component/)*.
|
|
|
|
Bindings
|
|
---
|
|
* *buffer*
|
|
|
|
For use with a control of type "textarea", to send/receive data to/from the port. If you would rather
|
|
bind the port to an existing control, then use *binding* attribute instead (see above).
|
|
|
|
Example
|
|
---
|
|
```xml
|
|
<serial id="com1" adapter="1" binding="print"/>
|
|
```
|
|
|
|
Output
|
|
---
|
|
```html
|
|
<div id="..." class="pc-serial pc-component">
|
|
<div class="pc-container">
|
|
<div class="pcx86-serial" data-value="id:'...',name:'...',adapter:'...',binding:'...'">
|
|
</div>
|
|
</div>
|
|
</div>
|
|
```
|
|
|
|
[Return to [PCx86 Documentation](..)]
|