From 48c197aaa6b2b87f7f313e7817a604a625026eb4 Mon Sep 17 00:00:00 2001 From: Vincenzo Lavorini Date: Mon, 20 Mar 2023 11:53:57 +0100 Subject: [PATCH] doc: virt-install in presence of USB dongle (#26642) Co-authored-by: Franck Nijhof --- .../installation/operating_system.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/source/_includes/installation/operating_system.md b/source/_includes/installation/operating_system.md index 1738696508e..4bfacd56be6 100644 --- a/source/_includes/installation/operating_system.md +++ b/source/_includes/installation/operating_system.md @@ -281,6 +281,29 @@ _All these can be extended if your usage calls for more resources._ ```bash virt-install --name hass --description "Home Assistant OS" --os-variant=generic --ram=2048 --vcpus=2 --disk ,bus=sata --graphics none --boot uefi ``` +
+ If you have a USB dongle to attach, you need to add the option `--hostdev busID.deviceId`. You can discover these IDs via the `lsusb` command. + As example, if `lsusb` output is: + + ```bash + Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub + Bus 003 Device 004: ID 30c9:0052 Luxvisions Innotech Limited Integrated RGB Camera + Bus 003 Device 003: ID 1a86:55d4 QinHeng Electronics SONOFF Zigbee 3.0 USB Dongle Plus V2 + Bus 003 Device 002: ID 06cb:00fc Synaptics, Inc. + Bus 003 Device 005: ID 8087:0033 Intel Corp. + Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub + Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub + Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub + ``` + + You can recognize the Sonoff dongle at `Bus 003 Device 003`. So the command to install the VM will become: + + ```bash + virt-install --name hass --description "Home Assistant OS" --os-variant=generic --ram=2048 --vcpus=2 --disk ,bus=sata --graphics none --boot uefi --hostdev 003.003 + ``` + Note that this configuration (bus 003, device 003) is just an example, your dongle could be on another bus and/or with another device ID. + Please check the correct IDs of your USB dongle with `lsusb`. +
{% if page.installation_type == 'windows' or page.installation_type == 'linux' %}