io7m | single-page | multi-page
3.8. vm-add-framebuffer-device
Previous
3. Command-Line Interface
Up
3.10. vm-add-passthru-device
Next
3.9

# vm-add-lpc-device

- 3.9. vm-add-lpc-device
  - 3.9.1. Name
  - 3.9.2. Description
  - 3.9.3. Example

3.9.1

## Name

1
vm-add-lpc-device - Add an LPC device to a virtual machine
3.9.2

## Description

1
The vm-add-lpc-device command adds an LPC device to a virtual machine. The bhyve documentation describes such devices as "LPC PCI-ISA bridges with COM1 and COM2 16550 serial ports and a boot ROM". In practice, LPC devices are used to provide console access to virtual machines, and UEFI firmware to virtual machines that are booting from UEFI.
2

### 3.9.2.2 Parameters

Parameter | Type | Required | Description
--- | --- | --- | ---
--add-backend | TTY Backend | true | A specification of the TTY device backend to add
--comment | String | false | A comment describing the new device
--configuration | Path | false | The path to the configuration file (environment variable: $WAXMILL_CONFIGURATION_FILE)
--device-slot | Device Slot | true | The slot to which the device will be attached.
--machine | UUID | true | The ID of the virtual machine
--verbose | Log Level | false | Set the minimum logging verbosity level.

3

### 3.9.2.3 Device Slot Syntax

    <deviceSlot> = <bus> ":" <slot> ":" <function>

    Where:
      <bus>      = [0 .. 255]
      <slot>     = [0 .. 31]
      <function> = [0 .. 7]

    Examples:
      0:0:0
      255:31:7

4

### 3.9.2.4 TTY Backend Syntax

    "stdio" ";" <port>
    | "file" ";" <port> ";" <path>
    | "nmdm" ";" <port>

    Where:
      <port> = "com1" | "com2" | "bootrom"

    Examples:
      stdio;com1
      file;bootrom;/tmp/xyz
      nmdm;com2

3.9.3

## Example

1

### 3.9.3.1 Example

    $ waxmill vm-add-lpc-device \
      --machine de17174a-1b3c-4ebc-80af-cb239aa18cbd \
      --device-slot 0:4:0 \
      --add-backend stdio;com1

    $ waxmill vm-add-lpc-device \
      --machine de17174a-1b3c-4ebc-80af-cb239aa18cbd \
      --device-slot 0:4:0 \
      --add-backend file;bootrom;/usr/local/share/uefi-firmware/BHYVE_UEFI.fd

    $ waxmill vm-add-lpc-device \
      --machine de17174a-1b3c-4ebc-80af-cb239aa18cbd \
      --device-slot 0:4:0 \
      --add-backend nmdm;com1

3.8. vm-add-framebuffer-device
Previous
3. Command-Line Interface
Up
3.10. vm-add-passthru-device
Next
io7m | single-page | multi-page