From patchwork Tue Jun 6 10:05:12 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bhupinder Thakur X-Patchwork-Id: 103156 Delivered-To: patch@linaro.org Received: by 10.182.29.35 with SMTP id g3csp1186543obh; Tue, 6 Jun 2017 03:07:15 -0700 (PDT) X-Received: by 10.107.142.201 with SMTP id q192mr22919916iod.99.1496743634843; Tue, 06 Jun 2017 03:07:14 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1496743634; cv=none; d=google.com; s=arc-20160816; b=yAh7MQo5g03ffFz6OtlYr5/ugzI767rwSkr112+G/1XLILJ5dZpjmNlkpOnOvf/mmL hv6nbbNRaHn0tK3t6ZqPl9M7ehswd5DvOZ+w3pJLMrv3TqHo0+eHCkDeeG/hZ9/IqI2b brcVPBJS5zYKDTuRL5/LaFohraJMzGoZIEz2IikYYxacH1jjREJt0GJbVA8DRUhYHY4N 6qlt8gYBturHm1KpfZZ/T8XnGQJocMJBfP1GokFcZ/z4q3K+Uj36OPOTOO/MhJw9A14F UjtmOdC5Ep6LnvmyQi1GBlIkbPO0Cs1PJR/1EUQ+1UZ6KFjjfNWG8+paqhWg1WgJnPeq lXKw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version :list-subscribe:list-help:list-post:list-unsubscribe:list-id :precedence:subject:cc:message-id:date:to:from:dkim-signature :arc-authentication-results; bh=Y3XpY6PH3N4tUtQqw55t6KmFkFTyw/0/VozPAp0/Xws=; b=Ww0m9Q5GqvbWnxiu8VjVwANJzcpb9CofW2fWNeSZCgJZAp4QoUbmS/OVcfPyou93nb /E0qVfDX7k1T3+6qDlFgSKOFxf1yq2ve1uRIxhW4W9m0n9Wx/4GnyE+VU2dXUVRNhpXu eXhOq40ZMD972ldAH56lQKHEWQJE+suh1DoKIPFsWZWHghccbW+AzzAqALBoMMMDG3kM bY0QnUwSzlb1Zx1Wp1EBGfIZZmlc3ZSC5+ZjIoZZgXwrMLAoLs+F+YTe5PR3quL9RNWW 6QdOPh0UK8ea2fxrTPpGeFvr8tAoOVSZa8iCD6Tgm/yX8NwvvvsIFIvhqm+4y26aQSpL V6PA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org; spf=neutral (google.com: 192.237.175.120 is neither permitted nor denied by best guess record for domain of xen-devel-bounces@lists.xen.org) smtp.mailfrom=xen-devel-bounces@lists.xen.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from lists.xenproject.org (lists.xenproject.org. [192.237.175.120]) by mx.google.com with ESMTPS id l24si6126762ioi.104.2017.06.06.03.07.14 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 06 Jun 2017 03:07:14 -0700 (PDT) Received-SPF: neutral (google.com: 192.237.175.120 is neither permitted nor denied by best guess record for domain of xen-devel-bounces@lists.xen.org) client-ip=192.237.175.120; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org; spf=neutral (google.com: 192.237.175.120 is neither permitted nor denied by best guess record for domain of xen-devel-bounces@lists.xen.org) smtp.mailfrom=xen-devel-bounces@lists.xen.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dIBMY-0004ZW-VN; Tue, 06 Jun 2017 10:05:22 +0000 Received: from mail6.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dIBMX-0004Ym-9s for xen-devel@lists.xenproject.org; Tue, 06 Jun 2017 10:05:21 +0000 Received: from [85.158.143.35] by server-9.bemta-6.messagelabs.com id 60/14-03557-06E76395; Tue, 06 Jun 2017 10:05:20 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmphkeJIrShJLcpLzFFi42Lxqg3W1E2oM4s 02Gdt8X3LZCYHRo/DH66wBDBGsWbmJeVXJLBmrL7ayVLQp1Tx7PVH1gbGDTJdjFwcQgLTGCUm vjzOCOKwCLQzS2w8/5uli5GTQ0LgHYvEtstJEHaaxKT5HYwQdpXEu7nbwWwhAS2Jo6dms0LY+ 5gkbm0372Lk4GATMJGY1SEBEhYRUJK4t2oyE8h8ZoH5jBJNk3rZQGqEBSIlTu4vBqlhEVAF2r SbDcTmFfCWuH9nGyvEKjmJm+c6mScw8i1gZFjFqF6cWlSWWqRrqJdUlJmeUZKbmJmja2hgppe bWlycmJ6ak5hUrJecn7uJERgiDECwg3Hnc6dDjJIcTEqivLUJZpFCfEn5KZUZicUZ8UWlOanF hxhlODiUJHgFaoFygkWp6akVaZk5wGCFSUtw8CiJ8CpXAqV5iwsSc4sz0yFSpxh1OSYd2P6FS YglLz8vVUqclwNkhgBIUUZpHtwIWORcYpSVEuZlBDpKiKcgtSg3swRV/hWjOAejkjDvtxqgKT yZeSVwm14BHcEEdATfJROQI0oSEVJSDYwKK/4cvPldszXJ5CLzxWWtO3+z/Zt3Vlcyez5PzpL Cz+63ersNji+PdxY36w9bf07yQPsSXsW7e0/XBZ5+N+9+cTb7BFfe1xWvfx9LK3d6tG9JLKP2 1LRToc8flDyqP6x5bDmbPv8EC9E5fp/Dbd7W/5VYbPpKKU9+bpSCsrZ0oVyN6aeVe6cqsRRnJ BpqMRcVJwIATWkMI5cCAAA= X-Env-Sender: bhupinder.thakur@linaro.org X-Msg-Ref: server-15.tower-21.messagelabs.com!1496743518!72346702!1 X-Originating-IP: [74.125.83.41] X-SpamReason: No, hits=0.0 required=7.0 tests= X-StarScan-Received: X-StarScan-Version: 9.4.19; banners=-,-,- X-VirusChecked: Checked Received: (qmail 39028 invoked from network); 6 Jun 2017 10:05:19 -0000 Received: from mail-pg0-f41.google.com (HELO mail-pg0-f41.google.com) (74.125.83.41) by server-15.tower-21.messagelabs.com with AES128-GCM-SHA256 encrypted SMTP; 6 Jun 2017 10:05:19 -0000 Received: by mail-pg0-f41.google.com with SMTP id k71so333301pgd.2 for ; Tue, 06 Jun 2017 03:05:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=sMHcvckkS+a4uzS1gGMFqyP2E1ambzHLeBNOk9zEar4=; b=SepvDEXkcNR9TxHl6/cu2RW9vYDUAEubFDnElu1eRSYQRSqDh5qDy2VkpKRC0j8TBD eZq0GvlnYN9OZAf0FgAE/KKWTX3fkTc8XfKeIiqOloU6lzT60eMSw4CQ1muWcfGzqJnw cOFbHJTRZ5/tQzF6rKya29roVjBlOXyIFVQss= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=sMHcvckkS+a4uzS1gGMFqyP2E1ambzHLeBNOk9zEar4=; b=Pte2UN4gWl+uZmBSv5Liv9tvPw7agXDq4tNw7B6oQNg71LMq3hi7WA6sz4FIf6nk8A 6xVSHkjAeaQytWMwIqN5wJpTPJ/IfQbypI5LaHXCngWdXIAFz4T/OrXmPYt5RasrcDxi 5d0yfJXY5HRnuzmW6xcEOYM9MjVhwka4/XtDVzZ/fzDDT7sncjNFsmL80clpNeg0tipT s4YFzGBlTiL/2eyvrvv5xmJn95CqQ++joeliyAOYQuJSn24S6JpdOTmkgA+zUX6/wI4R et78amLppd9DZmKh9GUYmT846ndAapWBZw/Al9eXHPBY8ECGA2KkmyTzTvnMZ9MOGmCn cmnw== X-Gm-Message-State: AODbwcAiwMIaJrGMD9mwQ88VqOgV1PrfC9H+4DwhMzh0eUP7qbJ63dnc d0E3xX1BY6WmXDFsIoRGLg== X-Received: by 10.84.217.11 with SMTP id o11mr20130057pli.299.1496743518266; Tue, 06 Jun 2017 03:05:18 -0700 (PDT) Received: from blr-ubuntu-linaro.wlan.qualcomm.com (blr-bdr-fw-01_globalnat_allzones-outside.qualcomm.com. [103.229.18.19]) by smtp.gmail.com with ESMTPSA id r11sm37416569pgn.35.2017.06.06.03.05.15 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 06 Jun 2017 03:05:17 -0700 (PDT) From: Bhupinder Thakur To: xen-devel@lists.xenproject.org Date: Tue, 6 Jun 2017 15:35:12 +0530 Message-Id: <1496743512-16142-1-git-send-email-bhupinder.thakur@linaro.org> X-Mailer: git-send-email 2.7.4 Cc: Wei Liu , Julien Grall , Stefano Stabellini , Ian Jackson Subject: [Xen-devel] [PATCH 14/14 v4] xen/arm: vpl011: Update documentation for vuart console support X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: xen-devel-bounces@lists.xen.org Sender: "Xen-devel" 1. Update documentation for a new vuart option added. 2. Update documentation about SPI irq reserved for vpl011. Signed-off-by: Bhupinder Thakur Reviewed-by: Stefano Stabellini Acked-by: Wei Liu --- docs/man/xl.cfg.pod.5.in | 9 +++++++++ docs/misc/console.txt | 44 +++++++++++++++++++++++++++++++++----------- 2 files changed, 42 insertions(+), 11 deletions(-) diff --git a/docs/man/xl.cfg.pod.5.in b/docs/man/xl.cfg.pod.5.in index 13167ff..3397cda 100644 --- a/docs/man/xl.cfg.pod.5.in +++ b/docs/man/xl.cfg.pod.5.in @@ -1085,6 +1085,15 @@ Allow a guest to access specific physical IRQs. It is recommended to use this option only for trusted VMs under administrator control. +If the virtual uart is enabled then irq 32 is reserved for it. By +default, it is disabled. If the user specifies the following option in +the VM config file then the vuart gets enabled. Today, only the +"pl011" model is supported. + +vuart = "pl011" + +Currently vuart console is available only for ARM64. + =item B Limit the guest to using at most N event channels (PV interrupts). diff --git a/docs/misc/console.txt b/docs/misc/console.txt index 16da805..48fe914 100644 --- a/docs/misc/console.txt +++ b/docs/misc/console.txt @@ -19,7 +19,20 @@ The first PV console path in xenstore remains: /local/domain/$DOMID/console -the other PV consoles follow the conventional xenstore device path and +The virtual UART console path in xenstore is defined as: + +/local/domain/$DOMID/vuart/0 + +The vuart console provides access to a virtual pl011 UART on ARM64 systems. +To enable vuart the following line has to be added to the guest configuration +file: + +vuart = "pl011" + +In Linux you can select the virtual pl011 UART by using the "ttyAMA0" +console instead of "hvc0". + +The other PV consoles follow the conventional xenstore device path and live in: /local/domain/$DOMID/device/console/$DEVID. @@ -61,6 +74,14 @@ output = pty The backend will write the pty device name to the "tty" node in the console frontend. +For the PV console the tty node is added at + +/local/domain/$DOMID/console/tty + +For the virtual UART console the tty node is added at + +/local/domain/$DOMID/vuart/0/tty + If the toolstack wants a listening Unix domain socket to be created at path , a connection accepted and data proxied to the console, it will write: @@ -79,8 +100,8 @@ For example: ioemu The supported values are only xenconsoled or ioemu; xenconsoled has -several limitations: it can only be used for the first PV console and it -can only connect to a pty. +several limitations: it can only be used for the first PV or virtual UART +console and it can only connect to a pty. Emulated serials are provided by qemu-dm only to hvm guests; the number of emulated serials depends on how many "-serial" command line options @@ -90,14 +111,15 @@ xenstore in the following path: /local/domain/$DOMID/serial/$SERIAL_NUM/tty -xenconsole is the tool to connect to a PV console or an emulated serial -that has a pty as output. Xenconsole takes a domid as parameter plus an -optional console type (pv for PV consoles or serial for emulated -serials) and console number. Depending on the type and console -number, xenconsole will look for the tty node in different xenstore -paths, as described above. If the user doesn't specify the console type -xenconsole will try to guess: if the guest is a pv guest it defaults to -PV console, if the guest is an hvm guest it defaults to emulated serial. +xenconsole is the tool to connect to a PV or virtual UART console or an +emulated serial that has a pty as output. Xenconsole takes a domid as +parameter plus an optional console type (pv for PV consoles, vuart for +virtual UART or serial for emulated serials) and console number. +Depending on the type and console number, xenconsole will look for the tty +node in different xenstore paths, as described above. If the user doesn't +specify the console type xenconsole will try to guess: if the guest is a pv +guest it defaults to PV console, if the guest is an hvm guest it defaults to +emulated serial. By default xl creates a pv console for hvm guests, plus an emulated serial if the user specified 'serial = "pty"' in the VM config file.