update with Fast Models Ethernet functions

Author: Qinghao Shi

docs/tools/fastmodels/fastmodels.md

@@ -22,11 +22,23 @@ 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).
+Fast Models can run most of the Mbed OS examples.
+
+Examples you can successfully run include:
+* [`mbed-os-example-blinky`](https://github.com/ARMmbed/mbed-os-example-blinky)
+* [`mbed-os-example-tls`](https://github.com/ARMmbed/mbed-os-example-tls)
+* [`mbed-os-example-devicekey`](https://github.com/ARMmbed/mbed-os-example-devicekey)
+* [`mbed-os-example-nvstore`](https://github.com/ARMmbed/mbed-os-example-nvstore)
+* [`mbed-os-example-thread-statistics`](https://github.com/ARMmbed/mbed-os-example-thread-statistics)
+* [`mbed-os-example-sys-info`](https://github.com/ARMmbed/mbed-os-example-sys-info)
+* [`mbed-os-example-cpu-usage`](https://github.com/ARMmbed/mbed-os-example-cpu-usage)
+* [`mbed-os-example-cpu-stats`](https://github.com/ARMmbed/mbed-os-example-cpu-stats)
+* [`mbed-os-example-error-handling`](https://github.com/ARMmbed/mbed-os-example-error-handling)
+* [`mbed-os-example-filesystem`](https://github.com/ARMmbed/mbed-os-example-filesystem)
+* [`mbed-os-example-blockdevice`](https://github.com/ARMmbed/mbed-os-example-blockdevice)
+* [`mbed-os-example-sockets`](https://github.com/ARMmbed/mbed-os-example-sockets)
+
+The following examples use `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. The [Arm DS-5 Development Studio](https://developer.arm.com/products/software-development-tools/ds-5-development-studio) also provides Fast Models targets. To load a compiled Mbed OS image onto a Fast Models platform, such as the FVP_MPS2_Cortex-M0, you need to add your installation's `bin` folder to your system `PATH`. For example: `C:\Program Files\DS-5 v5.29.1\bin`.
 
@@ -55,14 +67,48 @@ Load the compiled example image to the FVP_MPS2_Cortex-M3 target. To do so, pass
 $ 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:
+The FVPs start running, and the 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 Reference Guide](https://developer.arm.com/docs/100966/latest).</span>
 
-<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>
+#### Run Mbed OS sockets examples with Fast Models Ethernet
+
+Fast Models ethernet is a specical compoment which not been enabled by default. Two special options are required when using the ethernet compoment or any networking functions.
+
+<span class="notes">**Note:** Current version of Fast Model ethernet implementations requires Fast Models 11.3 or later or DS-5 5.29.0 or later. Also the simulated IP routing only works on TCP/IP protocol, but neither ICMP nor IGMP  protocol. which means ping would not work. For more details about how the Fast Models ethernet MAC working, please reference the [Fast Models Reference Manual](https://developer.arm.com/products/system-design/fast-models/docs/100964/latest/introduction/network-set-up/user-mode-networking).</span>
+
+Here, `mbed-os-example-sockets` example is used to demonstrated ethernet function. The example can be build as usual:
+```
+$ mbed import mbed-os-example-sockets
+$ cd mbed-os-example-sockets
+$ mbed compile -t GCC_ARM -m FVP_MPS2_M3
+```
+While launching the mbed OS socket example with Fast Models Ethernet function, arguments  `-C fvp_mps2.smsc_91c111.enabled=1` and `-C fvp_mps2.hostbridge.userNetworking=1` need to be passed in the command line:
+```
+$ FVP_MPS2_Cortex-M3 -C fvp_mps2.smsc_91c111.enabled=1 -C fvp_mps2.hostbridge.userNetworking=1 -a BUILD/FVP_MPS2_M3/GCC_ARM/mbed-os-example-sockets.elf
+```
+
+The FVPs start running, and the console output like::
+
+```
+Mbed OS Socket example
+Mbed OS version: 99.99.99
+
+IP address: 172.20.51.1
+Netmask: 255.255.255.0
+Gateway: 172.20.51.254
+sent 58 [GET / HTTP/1.1]
+recv 181 [HTTP/1.1 200 OK]
+External IP address: 217.140.106.54
+Done
+```
 
-<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.