From patchwork Wed Sep 27 06:13:34 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bhupinder Thakur X-Patchwork-Id: 114344 Delivered-To: patch@linaro.org Received: by 10.140.106.117 with SMTP id d108csp4665536qgf; Tue, 26 Sep 2017 23:17:12 -0700 (PDT) X-Received: by 10.107.78.25 with SMTP id c25mr414865iob.25.1506493032061; Tue, 26 Sep 2017 23:17:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1506493032; cv=none; d=google.com; s=arc-20160816; b=WocZcybrrrWsx06PQtolecah4/MQ2aJ/8AEQl5HV4tPzxqEDH7n61RHso4oDa4bkSU uXy9woez9g1V72kGU7gvs9LIdL6hFUyRcZB2apVOqfG1ylOBKd9n6mGoqInimAYyGlJD zwl/RVNF559TEzjZiPfoqmRqqfPO1ApZjbz1mJXLPV4Y59ojcTtRZD5mJy7GtrQLs4TD Aic+6hVWd0B07vUkAv7eonoyWDxvdBu+2nVFimLnh9KBpH0ZwYb1WmJdys6qPMkSU2p0 7ODefWs7pk0OYHw49jBw0oEWE9iB6hsFprTpdUGr1qxXA5zQpoI+1Y6QIw18SeuWn6Hx vsmQ== 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=LDkp4vb2s3MmBG1ZCxeOsr+xia053wtYTgkt6nh0LO4=; b=AU3xiTncbThL7/saUO9P29mFIZhWMtOIDzOQcfHKjagNDuL0uAv5lkLQPe/Fb47tfx tA1IgDID/KsCL2wJuRRWmrPv4fkhc3DJEsJQiuxNiHy29gtnNpf33rJR4GRFXEVdRBpN tDZjeouOfO3vS2eUv+D505ICJqi/mZzDqb0V/5CC66NsTZdg4aHd/F5oLbAMxALDqGo8 CyWt5Cjxvl6rm1vwoVc8IvSQfL0FXr5iltTuMh1gWbIqHfFF0/wyrOYhGGwx37K/EzHp DsjMx9+4XAMhA3LHGQ5BgFMPOScTdziwQMUHcrhLG6i39AE4hKpizKhrZUImGWLrYFD6 KrMA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=b63wBXcL; 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 q197si9161449iod.180.2017.09.26.23.17.11 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 26 Sep 2017 23:17:12 -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 header.s=google header.b=b63wBXcL; 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 1dx5cB-0003Yx-KD; Wed, 27 Sep 2017 06:14:35 +0000 Received: from mail6.bemta6.messagelabs.com ([193.109.254.103]) by lists.xenproject.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dx5cA-0003VX-80 for xen-devel@lists.xenproject.org; Wed, 27 Sep 2017 06:14:34 +0000 Received: from [85.158.143.35] by server-7.bemta-6.messagelabs.com id 00/FB-03610-9C14BC95; Wed, 27 Sep 2017 06:14:33 +0000 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFtrFIsWRWlGSWpSXmKPExsVyMfTAVt1jjqc jDXr2mlh83zKZyYHR4/CHKywBjFGsmXlJ+RUJrBlzLp9lLujQrJg9R6WBcYNSFyMXh5DADEaJ n4d72EEcFoF5zBJTbrSwgjgSAv2sErNe/wLKcAA5eRJT+iy7GDmBzDSJj6vuskLYFRInT55iB LGFBLQkjp6azQphr2CSOPNCHaSVTcBEYlaHBEhYREBJ4t6qyUwgNrPAcyaJaZd0QGxhgSiJx6 +vMIPYLAKqEhvP/AYbySvgI9HeexhqlZzEzXOdYDWcQPHT/bfZIFZ5S1xa2c86gVFwASPDKkb 14tSistQiXRO9pKLM9IyS3MTMHF1DAzO93NTi4sT01JzEpGK95PzcTYzAUGMAgh2M3Zf9DzFK cjApifLW/D8VKcSXlJ9SmZFYnBFfVJqTWnyIUYaDQ0mC94bD6UghwaLU9NSKtMwcYNDDpCU4e JREeK+BpHmLCxJzizPTIVKnGO05Lty59IeJ40vvDSB5YM8tINlx8+4fJiGWvPy8VClx3osgbQ IgbRmleXBDYVF6iVFWSpiXEehMIZ6C1KLczBJU+VeM4hyMSsK8miBTeDLzSuB2vwI6iwnorN6 pJ0DOKklESEk1MK61CnvrfL3L/ecb/kuB4asEUyuyXnpukNu55OvCK+sb5txr36i/Wnzlsnc3 Hoev0PaPf9Il92iyWZLAskK5gs/fnb8qa+ibhc3dvdjm0n1N/5Lz0z/d3KH5ecOdbYcfRK2Pc 5HOFZ53ek2RV+nGnrw3DxVntOQzbP56xUdwlrr5ziuT/fRvbu5TYinOSDTUYi4qTgQA82/EGc 0CAAA= X-Env-Sender: bhupinder.thakur@linaro.org X-Msg-Ref: server-4.tower-21.messagelabs.com!1506492869!78594003!1 X-Originating-IP: [209.85.192.181] X-SpamReason: No, hits=0.0 required=7.0 tests= X-StarScan-Received: X-StarScan-Version: 9.4.45; banners=-,-,- X-VirusChecked: Checked Received: (qmail 36760 invoked from network); 27 Sep 2017 06:14:30 -0000 Received: from mail-pf0-f181.google.com (HELO mail-pf0-f181.google.com) (209.85.192.181) by server-4.tower-21.messagelabs.com with AES128-GCM-SHA256 encrypted SMTP; 27 Sep 2017 06:14:30 -0000 Received: by mail-pf0-f181.google.com with SMTP id z84so6755928pfi.2 for ; Tue, 26 Sep 2017 23:14:30 -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=0dDjqhXxWsv/zS1ps0b/tJGOGIRU9n88m8CQHyVX6Ts=; b=b63wBXcLpyLF283BzQ8bTuT1Zau9zM/KEa3KFA8bhbV8Bp0KwSHfNdrFb1pzExVjuP A/nsKinCXDKBAd1boFQ9Ke45IEI2a1DFp8f+K2pu+zzmv1lRG6fErdCDa+I0BooSUFFd PvbzDYUIPBdvsmovZZX6UdL3cjUIrdKCBqXcg= 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=0dDjqhXxWsv/zS1ps0b/tJGOGIRU9n88m8CQHyVX6Ts=; b=Hv5bCkoV5PQrinbk0gEOPo0jPPMC0uNY8f+uCBsPPqQVGHLk5kMFSEBHDz6g04TERM jfUBt9yJ4L9YTkb6/ljBsQ05QixTTXYhsDvUxZnYASnLta2pH2tQ+e0ldFEF/ST/qWPT L5gx1+l6o8HmU+8nnJSjUHYB/28X6wC9yzAUymdmiMFKP0DZQHbV7UU1XwdGM/ZPzLKY c8i71EBUHMQOCj/bKSOGXfriXBXRgNX/srupiZIds40AacfbrlIDKU07W73Glb4sECl+ M3yuZ22ED9dYb4Kb50lsZltLjyGofhdgW8Mt3fGpQiKhk9VsMnZdLDAi/3ECYs699JVP skuA== X-Gm-Message-State: AHPjjUgp+5c/3c+1Gp9T6sU+R24z/e/WIbOQ8pOEk5rdhgopT+VycjZP FQurkkmykvq6AUfk60Rw6hcUgJazCQA= X-Google-Smtp-Source: AOwi7QCnOzl8/bussn0xb+Iv6hjNugL+Ll7wFfJPasBxRRApi6eOq3glx1MexyJcSWwmnjjxtDauGg== X-Received: by 10.99.113.94 with SMTP id b30mr348275pgn.312.1506492868833; Tue, 26 Sep 2017 23:14:28 -0700 (PDT) Received: from blr-ubuntu-linaro.wlan.qualcomm.com (h3.248.139.40.ip.windstream.net. [40.139.248.3]) by smtp.gmail.com with ESMTPSA id s187sm18013485pgb.82.2017.09.26.23.14.23 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 26 Sep 2017 23:14:28 -0700 (PDT) From: Bhupinder Thakur To: xen-devel@lists.xenproject.org Date: Wed, 27 Sep 2017 11:43:34 +0530 Message-Id: <1506492816-25954-26-git-send-email-bhupinder.thakur@linaro.org> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1506492816-25954-1-git-send-email-bhupinder.thakur@linaro.org> References: <1506492816-25954-1-git-send-email-bhupinder.thakur@linaro.org> Cc: Stefano Stabellini , Wei Liu , George Dunlap , Andrew Cooper , Ian Jackson , Tim Deegan , Julien Grall , Jan Beulich Subject: [Xen-devel] [PATCH 25/27 v11] 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 vuart. Signed-off-by: Bhupinder Thakur Reviewed-by: Stefano Stabellini Acked-by: Wei Liu --- CC: Ian Jackson CC: Wei Liu CC: Andrew Cooper CC: George Dunlap CC: Jan Beulich CC: Konrad Rzeszutek Wilk CC: Stefano Stabellini CC: Tim Deegan CC: Julien Grall Changes since v6: - Added a new section for vuart usage. - I have retained the reviewed-by/acked-by tags as this is a limited change. Kindly review. Changes since v4: - Minor change to rename "pl011" to "sbsa_uart". Since it is a minor change I have retained the reviewed-by and acked-by tags. docs/man/xl.cfg.pod.5.in | 12 ++++++++++++ docs/misc/console.txt | 44 +++++++++++++++++++++++++++++++++----------- 2 files changed, 45 insertions(+), 11 deletions(-) diff --git a/docs/man/xl.cfg.pod.5.in b/docs/man/xl.cfg.pod.5.in index 247ae99..f1d2a7a 100644 --- a/docs/man/xl.cfg.pod.5.in +++ b/docs/man/xl.cfg.pod.5.in @@ -1105,6 +1105,9 @@ Allow a guest to access specific physical IRQs. It is recommended to only use this option for trusted VMs under administrator's control. +If vuart console is enabled then irq 32 is reserved for it. See +L to know how to enable vuart console. + =item B Limit the guest to using at most N event channels (PV interrupts). @@ -2220,6 +2223,15 @@ the domain was created. This requires hardware compatibility with the requested version, either natively or via hardware backwards compatibility support. +=item B + +To enable vuart console, user must specify the following option in the +VM config file: + +vuart = "sbsa_uart" + +Currently, only the "sbsa_uart" model is supported for ARM. + =back =head3 x86 diff --git a/docs/misc/console.txt b/docs/misc/console.txt index 16da805..4e180f8 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 SBSA UART on ARM systems. +To enable vuart the following line has to be added to the guest configuration +file: + +vuart = "sbsa_uart" + +In Linux you can select the virtual SBSA 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.