Merge pull request #690 from jamesbeyond/fastmodels

Add documents for Fast Model

Author: Amanda Butler

docs/images/fastmodel_cm3.png

@@ -0,0 +1,68 @@
+## Fast Models
+
+Arm Fast Models are software models of Arm cores, subsystems, peripherals and so on. You can run Mbed OS on the software model instead of the hardware.
+
+This document explains how to build, run and debug Arm Mbed OS applications with Arm Fast Models. Due to licensing, Mbed OS do not provide any Fast Models. If you do not have a Fast Models license yet, you can visit [Arm Fast Models](https://developer.arm.com/products/system-design/fast-models) to obtain an evaluation license.
+
+Fixed Virtual Platforms (FVPs) are prebuilt system-level models after Arm’s reference platforms by Fast Models.
+
+For more details on Fast Models and FVPs, please reference further documentation about [Arm Fast Models](https://developer.arm.com/products/system-design/fast-models) or [FVPs](https://developer.arm.com/products/system-design/fixed-virtual-platforms).
+
+### Supported Fast Models FVPs
+
+Mbed OS has enabled working with following FVPs Cortex-M family with the MPS2 platforms:
+
+Fast Models platforms | Target name in Mbed OS
+---|---
+FVP_MPS2_Cortex-M0 | FVP_MPS2_M0
+FVP_MPS2_Cortex-M0plus | FVP_MPS2_M0P
+FVP_MPS2_Cortex-M3 | FVP_MPS2_M3
+FVP_MPS2_Cortex-M4 | FVP_MPS2_M4
+FVP_MPS2_Cortex-M7 | FVP_MPS2_M7
+
+### Mbed OS examples on Fast Models
+
+Fast Models can run most of the Mbed OS examples. (Please see [known issues 2 and 3](#known-issues)] for more information.)
+
+Examples you can successfully run include [`mbed-os-example-thread-statistics`](https://github.com/ARMmbed/mbed-os-example-thread-statistics), [`mbed-os-example-tls`](https://github.com/ARMmbed/mbed-os-example-tls), [`mbed-os-example-devicekey`](https://github.com/ARMmbed/mbed-os-example-devicekey) and [`mbed-os-example-nvstore`](https://github.com/ARMmbed/mbed-os-example-nvstore).
+
+The following examples use [`mbed-os-example-blinky`](https://github.com/ARMmbed/mbed-os-example-blinky).
+
+To run Mbed OS examples with Fast Models, you need to install the Fast Models product and set up the license.
+
+#### Import the example with Arm Mbed CLI 
+
+Import the blinky example:
+
+```
+$ mbed import mbed-os-example-blinky
+$ cd mbed-os-example-blinky
+```
+
+#### Build the example with Mbed CLI
+
+Fast Models targets are enabled to be built with all three major toolchains: ARM, GCC_ARM and IAR. To build the blinky example for the FVP_MPS2_Cortex-M3 target with the GCC complier, run:
+
+```
+$ mbed compile -t GCC_ARM -m FVP_MPS2_M3
+```
+
+#### Run Mbed OS examples with Fast Models
+
+Load the compiled example image to the FVP_MPS2_Cortex-M3 target. To do so, pass the `-a` option to the Fast Models target. For example:
+
+```
+$ FVP_MPS2_Cortex-M3 -a BUILD/FVP_MPS2_M3/GCC_ARM/mbed-os-example-blinky.elf
+```
+
+The FVPs start running, andthe LEDs on the FVP blink, like:
+
+<span class="images">![](https://s3-us-west-2.amazonaws.com/mbed-os-docs-images/fastmodel_cm3.png)<span>a screen-shot for FVPs running</span></span>
+
+<span class="notes">**Note:** FVP's `-a` option only takes .elf format images. To use the `--data` option with binary format images, please reference the [FVP Users' Guide](http://arminfo.emea.arm.com/help/index.jsp?topic=/com.arm.doc.100966_1103_00_en/index.html).</span>
+
+### Notes
+
+1. Timing accuracy of Fast Models can't be guaranteed.
+1. There is no support for external peripherals, such as ESP8266 expansion boards.
+1. Ethernet support for Fast Models is in progress.