From patchwork Tue Nov 26 20:27:29 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jeff Kubascik X-Patchwork-Id: 11263059 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 9792A930 for ; Tue, 26 Nov 2019 20:28:36 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 7A25720863 for ; Tue, 26 Nov 2019 20:28:36 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 7A25720863 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=dornerworks.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1iZhQx-0001hM-HU; Tue, 26 Nov 2019 20:27:39 +0000 Received: from all-amaz-eas1.inumbo.com ([34.197.232.57] helo=us1-amaz-eas2.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1iZhQw-0001hH-Oh for xen-devel@lists.xenproject.org; Tue, 26 Nov 2019 20:27:38 +0000 X-Inumbo-ID: 2f51b0ec-108b-11ea-a3a7-12813bfff9fa Received: from webmail.dornerworks.com (unknown [12.207.209.150]) by us1-amaz-eas2.inumbo.com (Halon) with ESMTP id 2f51b0ec-108b-11ea-a3a7-12813bfff9fa; Tue, 26 Nov 2019 20:27:37 +0000 (UTC) From: Jeff Kubascik To: Date: Tue, 26 Nov 2019 15:27:29 -0500 Message-ID: <20191126202729.122310-1-jeff.kubascik@dornerworks.com> X-Mailer: git-send-email 2.17.1 MIME-Version: 1.0 X-Originating-IP: [172.27.13.171] X-ClientProxiedBy: Mcbain.dw.local (172.27.1.45) To Mcbain.dw.local (172.27.1.45) X-spam-status: No, score=-2.9 required=3.5 tests=ALL_TRUSTED, BAYES_00, MAILSHELL_SCORE_10_69 X-Spam-Flag: NO Subject: [Xen-devel] [PATCH v2] bsp/xen: Update README X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Stewart Hildebrand , Volodymyr Babchuk , Stefano Stabellini , Julien Grall Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" Add some background information on the BSP and instructions on how to run the ticker application. Change-Id: I05050a335a938f00cc59bae69a014c5f04e05d23 --- bsps/arm/xen/README | 130 ++++++++++++++++++++++---------------------- 1 file changed, 64 insertions(+), 66 deletions(-) diff --git a/bsps/arm/xen/README b/bsps/arm/xen/README index 1b24d84c9a..2ae2f2170d 100644 --- a/bsps/arm/xen/README +++ b/bsps/arm/xen/README @@ -1,66 +1,64 @@ -# This is a sample hardware description file for a BSP. This comment -# block does not have to appear in a real one. The intention of this -# file is to provide a central place to look when searching for -# information about a board when starting a new BSP. For example, -# you may want to find an existing timer driver for the chip you are -# using on your board. It is easier to grep for the chip name in -# all of the HARDWARE files than to peruse the source tree. Hopefully, -# making the HARDDWARE files accurate will also alleviate the common -# problem of not knowing anything about a board based on its BSP -# name. -# -# NOTE: If you have a class of peripheral chip on board which -# is not in this list please add it to this file so -# others will also use the same name. -# -# Timer resolution is the way it is configured in this BSP. -# On a counting timer, this is the length of time which -# corresponds to 1 count. -# - -BSP NAME: fastsbc1 -BOARD: Fasssst Computers, Fast SBC-1 -BUS: SchoolBus -CPU FAMILY: i386 -CPU: Intel Hexium -COPROCESSORS: Witch Hex87 -MODE: 32 bit mode - -DEBUG MONITOR: HexBug - -PERIPHERALS -=========== -TIMERS: Intel i8254 - RESOLUTION: .0001 microseconds -SERIAL PORTS: Zilog Z8530 (with 2 ports) -REAL-TIME CLOCK: RTC-4 -DMA: Intel i8259 -VIDEO: none -SCSI: none -NETWORKING: none - -DRIVER INFORMATION -================== -CLOCK DRIVER: RTC-4 -IOSUPP DRIVER: Zilog Z8530 port A -SHMSUPP: polled and interrupts -TIMER DRIVER: Intel i8254 -TTY DRIVER: stub only - -STDIO -===== -PORT: Console port 0 -ELECTRICAL: RS-232 -BAUD: 9600 -BITS PER CHARACTER: 8 -PARITY: None -STOP BITS: 1 - -NOTES -===== - -(1) 900 Mhz and 950 Mhz versions. - -(2) 1 Gb or 2 Gb RAM. - -(3) PC compatible if HexBug not enabled. +BSP for Xen on ARM + +Overview +-------- + +This BSP enables RTEMS to run as a guest virtual machine in AArch32 mode on the +Xen hypervisor for ARMv8 platforms. + +Drivers: +- Clock: ARMv7-AR Generic Timer +- Console: Virtual PL011 device +- Interrupt: GICv2 + +BSP variants: +- xen_virtual: completely virtualized guest with no dependence on underlying + hardware + +The xen_virtual BSP variant relies on standard Xen features, so it should be +able to run on any ARMv8 platform. + +Xen allows for the passthrough of hardware peripherals to guest virtual +machines. BSPs could be added in the future targeting specific hardware +platforms and include the appropriate drivers. + +This BSP was tested with Xen running on the Xilinx Zynq UltraScale+ MPSoC using +the Virtuosity distribution maintained by DornerWorks. + +Execution +--------- + +This procedure describes how to run the ticker sample application that should +already be built with the BSP. + +The `ticker.exe` file can be found in the BSP build tree at: + + arm-rtems5/c/xen_virtual/testsuites/samples/ticker.exe + +The `ticker.exe` elf file must be translated to a binary format. + + arm-rtems5-objcopy -O binary ticker.exe ticker.bin + +Then place the `ticker.bin` file on the dom0 filesystem. + +From the dom0 console, create a configuration file `ticker.cfg` with the +following contents. + + name = "ticker" + kernel = "ticker.bin" + memory = 8 + vcpus = 1 + gic_version = "v2" + vuart = "sbsa_uart" + +Create the virtual machine and attach to the virtual vpl011 console. + + xl create ticker.cfg && xl console -t vuart ticker + +To return back to the dom0 console, press both `Ctrl` and `]` on your keyboard. + +Additional information +---------------------- + +The Virtuosity distribution can be found at + https://dornerworks.com/xen/virtuosity