From patchwork Wed May 10 14:35:18 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bhupinder Thakur X-Patchwork-Id: 99007 Delivered-To: patch@linaro.org Received: by 10.182.142.97 with SMTP id rv1csp234371obb; Wed, 10 May 2017 07:39:52 -0700 (PDT) X-Received: by 10.107.40.81 with SMTP id o78mr3371009ioo.192.1494427192805; Wed, 10 May 2017 07:39:52 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1494427192; cv=none; d=google.com; s=arc-20160816; b=n+BWMYGYKYjJEVUryYrUJX8C+NZWKBi6rwCYUf7fuRY+Va+q4yIidkl7x5k2XJHSHC lV1O30ozNdA0EcQTUq0JkOSblv/2AK4CNutYIHf3XAbGXmJFGxVYHkxoUxm0yurAT43W AfZQpqywR9PeO/kISXICvrD8t8JZijwoivHz3i3vYk/UnqVwafLRTGG9btYWVvp3NXm3 FSIqlCOy83lNyM3yfH7RqqNPo9NL8SUisd1X0r9X9Tj9/10i1uOw5WahmZXfkQO5IvxO Eqmo8U8H2bPce58UA77l+3WHW+HR4RTHROk0epNGfI4FtUfpux6eawqjaC8Lf3LawZae RLKA== 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:references:in-reply-to:message-id:date:to :from:dkim-signature:arc-authentication-results; bh=N7dIzOM2IF5KtDb8WsElmkmrnF5ttNi4K0J/M1jxoxo=; b=ZHHp44mSF4waBQJ880ORanmdUt1zbE16KieCfufuaTsDDxgF7oPxOpak/3N7zLkb/n /LgZ+DcJIdegsN0rgv/KbNYgWYaly8GMYYY+JMWy0fzwa9/aCvV5cmm6SHyOv+YHPxsN S8FarJUZJHAGwKJYbP22Rmnqe+uSaXVLVx3BX+bqsM/IThgWc+27IWKkqOA+LxwQH9+1 AwHSnnyRWIgLH4Q18CrqdBBJ+ds8hQFSs3/sXzoFIkteIwAw3MWeGMtSDCXZs8Q5ANq3 3fSImS6Qy6tc5hdBofe8tpYIZZlVdQxNz3YxumnryJkFcuvNIgDs0VAck7LtnReFkeza zj3w== 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 v73si3411682ith.26.2017.05.10.07.39.52 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 10 May 2017 07:39:52 -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 1d8Ski-00050P-So; Wed, 10 May 2017 14:38:08 +0000 Received: from mail6.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1d8Skh-0004zQ-KV for xen-devel@lists.xenproject.org; Wed, 10 May 2017 14:38:07 +0000 Received: from [85.158.143.35] by server-10.bemta-6.messagelabs.com id 79/D2-03613-FC523195; Wed, 10 May 2017 14:38:07 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFlrGIsWRWlGSWpSXmKPExsVyMfTAet1zqsK RBhM3Slp83zKZyYHR4/CHKywBjFGsmXlJ+RUJrBkf979jLNgnXXFn40WWBsbPYl2MXBxCArMY Je5OfsAE4rAIzGOW+Hj7IRuIIyHQzyrx5PM/li5GTiAnTuLfxlVsEHa5xNO2A4wgtpCAlsTRU 7NZIUY1M0nMmv8PyOHgYBMwkZjVIQFSIyKgJHFv1WQmEJtZwFviw5F/7CC2sECkxIX+F2BzWA RUJVacuQc2nxeo5sTBg1C75CRunutkBrE5BXwkFr16yQKx11vi0ec/LBMYBRYwMqxi1ChOLSp LLdI1MtJLKspMzyjJTczM0TU0MNPLTS0uTkxPzUlMKtZLzs/dxAgMLQYg2MG4Zn7gIUZJDiYl UV7dXUKRQnxJ+SmVGYnFGfFFpTmpxYcYZTg4lCR4o1SEI4UEi1LTUyvSMnOAQQ6TluDgURLhb QZJ8xYXJOYWZ6ZDpE4xGnO8uPz+PRPHk5U/3jMJseTl56VKifNKg5QKgJRmlObBDYJF3yVGWS lhXkag04R4ClKLcjNLUOVfMYpzMCoJ80aCTOHJzCuB2/cK6BQmoFMCGQRATilJREhJNTBKOIR rHxGYy5tZlyCpeO/px9c7tkld18o+deqXhGbpYqEirhzT5NJJ7IG6Zr/mH89x1OFL+hO+bkat k9yj+o+1sn/6nh91mmIc0lq27alefqTV4cDrJw/90unsUZS88ye3UCWI922Rw1tzpcILei3uH 06bB1bq97cz896odDhR92ub3KykaiWW4oxEQy3mouJEABMfQMW5AgAA X-Env-Sender: bhupinder.thakur@linaro.org X-Msg-Ref: server-9.tower-21.messagelabs.com!1494427085!67543265!1 X-Originating-IP: [209.85.192.175] X-SpamReason: No, hits=0.0 required=7.0 tests= X-StarScan-Received: X-StarScan-Version: 9.4.12; banners=-,-,- X-VirusChecked: Checked Received: (qmail 40372 invoked from network); 10 May 2017 14:38:06 -0000 Received: from mail-pf0-f175.google.com (HELO mail-pf0-f175.google.com) (209.85.192.175) by server-9.tower-21.messagelabs.com with AES128-GCM-SHA256 encrypted SMTP; 10 May 2017 14:38:06 -0000 Received: by mail-pf0-f175.google.com with SMTP id e193so16903942pfh.0 for ; Wed, 10 May 2017 07:38:06 -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:in-reply-to:references; bh=jaekUM7vzx5L1funR/k5gcuXHCOpV5cjoYkfhVDjKJ8=; b=FAuInPvAuUELDaQJLvLv1yyuD2Hf374O8y9ZmrzaYnhc7XHyZ9KZvOMSjVQqcM616Q v+w948S2iFRChE2JmCCpW0m9BkZ16nGEfaEjuPJPgWuX9d927C53z3ZrsQcuctIEavvK wKCp+GK8A1KFk9EtZCNuNhR9uuwcfZfSnKmJY= 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:in-reply-to :references; bh=jaekUM7vzx5L1funR/k5gcuXHCOpV5cjoYkfhVDjKJ8=; b=o1g6aGD36ozqh46QoFhy0XWYd8Mw6axjrxeBjULR6ptQ/hiSaRrTShtWkkJ8f9xrWm zz63P7Dv6WV73PI0p+a+yYCk4n02dafkltF3NJjl70wgD2Pgr5ZP0A6Tv9YTSVrlXM19 waifpCYwfWpbhxy9Z2ogAgdKwbRXfU3ojvXce6qLU1eFWRSgaaP/9DD7WqAL6HSr3JDe 9G/yyLCnhZrHvNQY2HgHUfmJMjNKwxRmbUAZIGW7PDbGyVYl+3RNLbfc658MdR6ZSj3S yDE3n2t2rm66KKXa6KOI1+SV1c7QGBHXBsWTzQq3V9W+TX0U1Sp4scx9Ru7FVFBRB/L/ NnTg== X-Gm-Message-State: AODbwcCPHFoqZElQiIuUg3JonTUBuzcEMCqnVYjIPByW4ptHMoz7qgG8 ht3TMEQRLNgpuCq9 X-Received: by 10.99.1.141 with SMTP id 135mr684312pgb.164.1494427084899; Wed, 10 May 2017 07:38:04 -0700 (PDT) Received: from blr-ubuntu-linaro.wlan.qualcomm.com ([61.0.91.57]) by smtp.gmail.com with ESMTPSA id r73sm6167781pfa.65.2017.05.10.07.38.01 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 10 May 2017 07:38:04 -0700 (PDT) From: Bhupinder Thakur To: xen-devel@lists.xenproject.org Date: Wed, 10 May 2017 20:05:18 +0530 Message-Id: <1494426918-32737-7-git-send-email-bhupinder.thakur@linaro.org> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1494426918-32737-1-git-send-email-bhupinder.thakur@linaro.org> References: <1494426918-32737-1-git-send-email-bhupinder.thakur@linaro.org> Cc: Wei Liu , Ian Jackson Subject: [Xen-devel] [PATCH 12/12 v3] 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 Acked-by: Wei Liu Reviewed-by: Stefano Stabellini --- Changes since v2: - Incorporated the review comments on the documentation. docs/man/xl.cfg.pod.5.in | 9 +++++++++ docs/misc/console.txt | 31 ++++++++++++++++++++++++++----- 2 files changed, 35 insertions(+), 5 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..9eccfa1 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,8 +111,8 @@ 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 +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 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