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