pcjs/pubs/docs/pcx86/serial/README.md

65 lines
1.5 KiB
Markdown

---
layout: page
title: PCx86 <serial> Element
permalink: /docs/pcx86/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 &lt;textarea&gt;) to optionally redirect port I/O to.
For example, if you've defined a Control Panel with a &lt;textarea&gt; 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](../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](..)]