[Xen-devel] [PATCH v2] bsp/xen: Update README

Jeff Kubascik posted 1 patch 4 years, 4 months ago
Failed in applying to current master (apply log)
bsps/arm/xen/README | 130 ++++++++++++++++++++++----------------------
1 file changed, 64 insertions(+), 66 deletions(-)
[Xen-devel] [PATCH v2] bsp/xen: Update README
Posted by Jeff Kubascik 4 years, 4 months ago
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
-- 
2.17.1


_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel
Re: [Xen-devel] [PATCH v2] bsp/xen: Update README
Posted by Julien Grall 4 years, 4 months ago
Hi,

On 26/11/2019 20:27, Jeff Kubascik wrote:
> Add some background information on the BSP and instructions on how to
> run the ticker application.
> 
> Change-Id: I05050a335a938f00cc59bae69a014c5f04e05d23
> ---
>   bsps/arm/xen/README | 130 ++++++++++++++++++++++----------------------

Hmmm what repo is it?

Cheers,

>   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
> 

-- 
Julien Grall

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel
Re: [Xen-devel] [PATCH v2] bsp/xen: Update README
Posted by Jeff Kubascik 4 years, 4 months ago
On 11/26/2019 3:34 PM, Julien Grall wrote:
> Hi,
> 
> On 26/11/2019 20:27, Jeff Kubascik wrote:
>> Add some background information on the BSP and instructions on how to
>> run the ticker application.
>>
>> Change-Id: I05050a335a938f00cc59bae69a014c5f04e05d23
>> ---
>>   bsps/arm/xen/README | 130 ++++++++++++++++++++++----------------------
> 
> Hmmm what repo is it?

Whoops. This is the RTEMS port that I am working on. I must of did a git
send-email from the wrong directory. This will be making its way to rtems-devel
soon. Apologies!

> Cheers,
> 
>>   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
>>
> 
> --
> Julien Grall
> 

Sincerely,
Jeff Kubascik

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel