Merge pull request #23 from jonzhang-fb/master

Add draft case study for OCP TiogaPass

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

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)

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 ./<firmware image name>
+```
+* 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 **