From 188b772dd48e3869a635140c7aec369222c39b4d Mon Sep 17 00:00:00 2001 From: Jonathan Zhang Date: Tue, 4 Jun 2019 03:50:56 -0700 Subject: [PATCH] Add draft case study for OCP TiogaPass Following discussion in OCP OSF, Wiwynn makes a special OCP TiogaPass SKU that enables software development community to work on OSF solutions. Such SKU can be ordered with unit of one server, and it can be used with or without a rack. This commit adds a draft case study. To start order process, Wiwynn needs a URL, as a landing page for software developers to know how to use the SKU. This draft case study only contains a landing page, with skeleton of information to be provided. We will refine this landing page and detail pages linked by it over time. They need to be good enough for consumption when Wiwynn sells first order to the community, which is expected in July, 2019. This landing page will be reviewed by Linuxboot community and Wiwynn. Signed-off-by: Jonathan Zhang --- README.md | 1 + case_studies/README.md | 7 ++++ case_studies/TiogaPass/README.md | 65 ++++++++++++++++++++++++++++++++ 3 files changed, 73 insertions(+) create mode 100644 case_studies/README.md create mode 100644 case_studies/TiogaPass/README.md diff --git a/README.md b/README.md index 9bbc089..1178827 100644 --- a/README.md +++ b/README.md @@ -32,4 +32,5 @@ LinuxBoot book which contains the documentation in markdown format 12. Arm + u-boot 13. DUT, a simple Device Under Test framework [DUT, Device Under Test framework] (13.dut/README.md) 14. CPU, an ssh style command which lets you see your files from anywhere. [CPU, wherever you go, there your files are] (14.cpu/README.md) +15. [Case Studies](case_studies/README.md) 15. Conclusion diff --git a/case_studies/README.md b/case_studies/README.md new file mode 100644 index 0000000..87a8c14 --- /dev/null +++ b/case_studies/README.md @@ -0,0 +1,7 @@ +# Case Studies + +This capter contains case studies for various solutions. + +## Table of Contents + +1. [OCP TiogaPass](TiogaPass/README.md) diff --git a/case_studies/TiogaPass/README.md b/case_studies/TiogaPass/README.md new file mode 100644 index 0000000..d8e72c6 --- /dev/null +++ b/case_studies/TiogaPass/README.md @@ -0,0 +1,65 @@ +# OCP TiogaPass Case Study + +Points of contact: [Jonathan Zhang](https://github.com/jonzhang-fb), [Andrea Barberio](https://github.com/insomniacslk), [David Hendricks](https://github.com/dhendrix), Adi + +This case study describes information for firmware development community to use [OCP](https://www.opencompute.org/) platform TiogaPass, made by [Wiwynn Corporation](http://www.wiwynn.com/english). + +It contains following sections: +* [Quick Start](#Quick-Start) +* [Details](#Details) + * [How to build](#How-to-build) + * [How to operate](#How-to-operate) + * [Platform info](#Platform-info) +* [Support](#Support) + * [Hardware support](#Hardware-support) + * [Community support](#Community-support) + * [Professional support](#Professional-support) + +## Quick Start + +* [Order the hardware](http://www.wiwynn.com/english) if you have not done so. +* Download or build the firmware binary. The binary can be downloaded from **TBD location**. +* Flash the firmware. + * Copy the downloaded firmware to OpenBMC. + * From OpenBMC +``` + fw-util mb --update bios --force ./ +``` +* Boot and enjoy. + * From OpenBMC +``` + power-util mb reset + sol-util mb +``` + +## Details +### How to build +Follow **TBD section** for details on how to get the source code, and how to build. + +Boot flow of the current firmware solution is: Power on --> minimized UEFI --> Linuxboot --> target OS. + +In near feature, the boot flow will be: power on --> Coreboot --> Linuxboot --> target OS. + +### How to operate +Follow **TBD section** for details on: +* How to flash. The image can be flashed either out-of-band, or from Linuxboot u-root shell, or from targetOS shell. +* How to run Linuxboot u-root shell commands. + +### Platform info +The SKU contains TiogaPass board, a debug card, a VGA card, a power adapter. The details can be obtained from [Here](http://www.wiwynn.com/english). + +Platform design details (including the design spec and schematics) can be found from [Here](https://www.opencompute.org/products/108/wiwynn-tioga-pass-standard-sv7220g3-s-2u-ocp-server-up-to-768gb-8gb16gb32gb-ddr4-up-to-2666mts-12-dimm-slots). + +## Support +### Hardware support +Hardware support can be obtained from Wiwynn Corporation(http://www.wiwynn.com/english) + +### Community support +[OCP Open System Firmware](https://www.opencompute.org/projects/open-system-firmware) is where industry collaborates on how to move forward with OSF. The OCP OSF project has regular recorded meetings and a mailing list. + +[Linuxboot open source community](https://www.linuxboot.org/) is the community you can ask any technical questions. Linuxboot community has a slack channel, a IRC channel, a mailing list and regular meetings. + +### Professional support +Following companies provides professional support services: + +** TBD **