Merge pull request #5 from armink/master

Add netio readme.

README.md

@@ -12,7 +12,7 @@
 
 ## 3、使用说明
 
-每个小工具都提供了 Finsh/MSH 的使用命令，在其目录下都存有一份详细的使用文档。如需使用，请单独查看。下面是目前支持的小工具汇总：
+每个小工具可使用 menuconfig 独立控制启用/停用，并提供了 Finsh/MSH 的使用命令。在其目录下都存有一份详细的使用文档。如需使用，请单独查看。下面是目前支持的小工具汇总：
 
 |名称|分类|功能简介|使用文档|
 |:--|:--:|:--|:--|

netio/README.md

@@ -1 +1,35 @@
-Coming soon...
+# NetIO：网络吞吐量测试工具
+
+## 1、介绍
+
+[NetIO](http://www.nwlab.net/art/netio/netio.html) 用于在 OS/2 2.x 、 Windows 、 Linux 和 Unix 上进行网络性能测试的工具。它会通过 TCP/UDP 方式，使用不同大小的数据包进行网络净吞吐量测试。
+
+RT-Thread 目前支持的是 NetIO TCP 服务器。
+
+## 2、使用
+
+### 2.1 启动 NetIO 服务器
+
+需要在 RT-Thread 上使用 Finsh/MSH 命令来启动 NetIO 服务器，大致效果如下：
+
+```
+msh />netio_init
+NetIO server start successfully
+msh />
+```
+
+### 2.2 安装 NetIO-GUI 测试软件
+
+安装文件位于 `/tools/netio-gui_v1.0.4_portable.exe` ，这个是绿色软件，安装实际上是解压的过程，解压到新文件夹即可。
+
+### 2.3 进行 NetIO 测试
+
+打开刚安装的 `NetIO-GUI` 软件，按如下操作进行配置：
+
+- 打开 `NetIO-GUI.exe` ；
+- 选择 `Client-Mode` 模式，`TCP` 协议；
+- 填写 NetIO 服务器的 IP 地址。可以在 RT-Thread 的 MSH 下使用 ifconfig 命令查看；
+- 点击 `Start measure` 开始测试（测试前务必确保服务器可以被 PC ping 通）；
+- 等待测试结束。结束后，不同数据包对应的收发测试结果将会在结果区域显示出来。
+
+![netio_tested](../images/netio_tested.png)

netio/netio.c

@@ -418,12 +418,23 @@ netio_accept(void *arg, struct tcp_pcb *pcb, err_t err)
 
 void netio_init(void)
 {
+    static rt_bool_t init_ok = RT_FALSE;
     struct tcp_pcb *pcb;
 
-    pcb = tcp_new();
-    tcp_bind(pcb, IP_ADDR_ANY, 18767);
-    pcb = tcp_listen(pcb);
-    tcp_accept(pcb, netio_accept);
+    if (!init_ok)
+    {
+
+        pcb = tcp_new();
+        tcp_bind(pcb, IP_ADDR_ANY, 18767);
+        pcb = tcp_listen(pcb);
+        tcp_accept(pcb, netio_accept);
+        init_ok = RT_TRUE;
+        rt_kprintf("NetIO server start successfully\n");
+    }
+    else
+    {
+        rt_kprintf("netio: server already running\n");
+    }
 }
 
 #endif /* LWIP_TCP */