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: 9720009 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 4589B60236 for ; Wed, 10 May 2017 14:40:12 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 35BDA2862A for ; Wed, 10 May 2017 14:40:12 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 27B2428631; Wed, 10 May 2017 14:40:12 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.1 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_MED,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 3A17628604 for ; Wed, 10 May 2017 14:40:10 +0000 (UTC) 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" X-Virus-Scanned: ClamAV using ClamSMTP 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