Merge pull request #837 from ARMmbed/kegilbert-patch-1

Move stats API docs to config format

Author: Amanda Butler

docs/api/platform/MbedStats.md

@@ -1,27 +1,77 @@
 ## Mbed statistics
 
-Mbed OS provides a set of functions that you can use to capture the memory and thread statistics at runtime. `mbed_stats.h` declares these functions. To enable all Mbed OS statistics, you must build code with the `MBED_ALL_STATS_ENABLED` macro.
+Mbed OS provides a set of functions that you can use to capture the memory and thread statistics at runtime. `mbed_stats.h` declares these functions. To enable all Mbed OS platform statistics, you must enable the following Mbed OS configuration option:
+
+```json
+{
+    "target_overrides": {
+        "*": {
+            "platform.all-stats-enabled": true
+        }
+    }
+}
+```
+
+<span class="tips">**Tip:** See the documentation of the [Arm Mbed configuration system](../reference/configuration.html) for more details about `mbed_app.json`. </span>
 
 ### Memory statistics
 
-You can use memory statistics functions to capture heap usage, cumulative stack usage or stack usage per thread at runtime. To enable memory usage monitoring, you must build Mbed OS with the following macros:
+You can use memory statistics functions to capture heap use, cumulative stack use or stack use for each thread at runtime. To enable memory use monitoring, you must enable the following Mbed OS configuration options:
 
-- `MBED_HEAP_STATS_ENABLED`.
-- `MBED_STACK_STATS_ENABLED`.
+```json
+{
+    "target_overrides": {
+        "*": {
+            "platform.heap-stats-enabled": true,
+            "platform.stack-stats-enabled": true
+        }
+    }
+}
+```
 
 <span class="notes">**Note:** Each `malloc` or `calloc` memory allocation call adds an overhead of 8 bytes when heap memory statistics are enabled.</span>
 
 ### Thread statistics
 
-You can use the thread statistics function `mbed_stats_thread_get_each` to capture the thread ID, state, priority, name and stack information for all active threads at runtime. To enable thread monitoring, you must build Mbed OS with the `MBED_THREAD_STATS_ENABLED` macro.
+You can use the thread statistics function `mbed_stats_thread_get_each` to capture the thread ID, state, priority, name and stack information for all active threads at runtime. To enable thread monitoring, you must enable the following Mbed OS configuration options:
+
+```json
+{
+    "target_overrides": {
+        "*": {
+            "platform.thread-stats-enabled": true
+        }
+    }
+}
+```
 
 ### System information
 
-You can use the `mbed_stats_sys_get` function to get the CPU ID, compiler information and RAM and ROM memories on the target device. You must build Mbed OS with the `MBED_SYS_STATS_ENABLED` macro to enable fetching of system information.
+You can use the `mbed_stats_sys_get` function to get the CPU ID, compiler information and RAM and ROM memories on the target device. To enable system information fetching, you must enable the following Mbed OS configuration option:
+
+```json
+{
+    "target_overrides": {
+        "*": {
+            "platform.sys-stats-enabled": true
+        }
+    }
+}
+```
 
 ### CPU statistics
 
-You can use the `mbed_stats_cpu_get` function to get the uptime, idle time and sleep time information. Timing information available is cumulative since the system is on. You must build Mbed OS with the `MBED_CPU_STATS_ENABLED` macro to enable fetching of CPU information. Please note CPU statistics depend on the availability of the low power timer in the hardware.
+You can use the `mbed_stats_cpu_get` function to get the uptime, idle time and sleep time information. Timing information available is cumulative because the system is on. Please note CPU statistics depend on the availability of the low power timer in the hardware. To enable fetching of CPU information, you must enable the following Mbed OS configuration option:
+
+```json
+{
+    "target_overrides": {
+        "*": {
+            "platform.cpu-stats-enabled": true
+        }
+    }
+}
+```
 
 ### Mbed statistics function reference