Revision 0:739a04e1daf4, committed 2019-09-11

Comitter:

AustinKim

Date:

Wed Sep 11 07:34:38 2019 +0000

Commit message:

Init Project for PSM

Changed in this revision

diff -r 000000000000 -r 739a04e1daf4 .gitignore
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/.gitignore	Wed Sep 11 07:34:38 2019 +0000
@@ -0,0 +1,4 @@
+.build
+.mbed
+projectfiles
+*.py*

diff -r 000000000000 -r 739a04e1daf4 CONTRIBUTING.md
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/CONTRIBUTING.md	Wed Sep 11 07:34:38 2019 +0000
@@ -0,0 +1,5 @@
+# Contributing to Mbed OS
+
+Mbed OS is an open-source, device software platform for the Internet of Things. Contributions are an important part of the platform, and our goal is to make it as simple as possible to become a contributor.
+
+To encourage productive collaboration, as well as robust, consistent and maintainable code, we have a set of guidelines for [contributing to Mbed OS](https://os.mbed.com/docs/mbed-os/latest/contributing/index.html).

diff -r 000000000000 -r 739a04e1daf4 README.md
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.md	Wed Sep 11 07:34:38 2019 +0000
@@ -0,0 +1,152 @@
+# Getting started example for Mbed OS
+
+This guide reviews the steps required to get Blinky with the addition of dynamic OS statistics working on an Mbed OS platform. (Note: To see a rendered example you can import into the Arm Online Compiler, please see our [quick start](https://os.mbed.com/docs/mbed-os/latest/quick-start/online-with-the-online-compiler.html#importing-the-code).)
+
+Please install [Mbed CLI](https://github.com/ARMmbed/mbed-cli#installing-mbed-cli).
+
+## Import the example application
+
+From the command-line, import the example:
+
+```
+mbed import mbed-os-example-blinky
+cd mbed-os-example-blinky
+```
+
+### Now compile
+
+Invoke `mbed compile`, and specify the name of your platform and your favorite toolchain (`GCC_ARM`, `ARM`, `IAR`). For example, for the Arm Compiler:
+
+```
+mbed compile -m K64F -t ARM
+```
+
+Your PC may take a few minutes to compile your code. At the end, you see the following result:
+
+```
+[snip]
+
+Image: ./BUILD/K64F/GCC_ARM/mbed-os-example-blinky.bin
+```
+
+### Program your board
+
+1. Connect your Mbed device to the computer over USB.
+1. Copy the binary file to the Mbed device.
+1. Press the reset button to start the program.
+
+The LED on your platform turns on and off. The main thread will additionally take a snapshot of the device's runtime statistics and display it over serial to your PC. The snapshot includes:
+
+* System Information:
+    * Mbed OS Version: Will currently default to 999999
+    * Compiler ID
+        * ARM = 1
+        * GCC_ARM = 2
+        * IAR = 3
+    * [CPUID Register Information](#cpuid-register-information)
+    * [Compiler Version](#compiler-version)
+* CPU Statistics
+    * Percentage of runtime that the device has spent awake versus in sleep
+* Heap Statistics
+    * Current heap size
+    * Max heap size which refers to the largest the heap has grown to
+* Thread Statistics
+    * Provides information on all running threads in the OS including
+        * Thread ID
+        * Thread Name
+        * Thread State
+        * Thread Priority
+        * Thread Stack Size
+        * Thread Stack Space
+
+#### Compiler Version
+
+| Compiler | Version Layout |
+| -------- | -------------- |
+| ARM      | PVVbbbb (P = Major; VV = Minor; bbbb = build number) |
+| GCC      | VVRRPP  (VV = Version; RR = Revision; PP = Patch)    |
+| IAR      | VRRRPPP (V = Version; RRR = Revision; PPP = Patch)   |
+
+#### CPUID Register Information
+
+| Bit Field | Field Description | Values |
+| --------- | ----------------- | ------ |
+|[31:24]    | Implementer       | 0x41 = ARM |
+|[23:20]    | Variant           | Major revision 0x0  =  Revision 0 |
+|[19:16]    | Architecture      | 0xC  = Baseline Architecture |
+|           |                   | 0xF  = Constant (Mainline Architecture) |
+|[15:4]     | Part Number       | 0xC20 =  Cortex-M0 |
+|           |                   | 0xC60 = Cortex-M0+ |
+|           |                   | 0xC23 = Cortex-M3  |
+|           |                   | 0xC24 = Cortex-M4  |
+|           |                   | 0xC27 = Cortex-M7  |
+|           |                   | 0xD20 = Cortex-M23 |
+|           |                   | 0xD21 = Cortex-M33 |
+|[3:0]      | Revision          | Minor revision: 0x1 = Patch 1 |
+
+
+
+You can view individual examples and additional API information of the statistics collection tools at the bottom of the page in the [related links section](#related-links).
+
+
+### Output
+
+To view the serial output you can use any terminal client of your choosing such as [PuTTY](http://www.putty.org/) or [CoolTerm](http://freeware.the-meiers.org/). Unless otherwise specified, printf defaults to a baud rate of 9600 on Mbed OS.
+
+You can find more information on the Mbed OS configuration tools and serial communication in Mbed OS in the related [related links section](#related-links).
+
+The output should contain the following block transmitted at the blinking LED frequency (actual values may vary depending on your target, build profile, and toolchain):
+
+```
+=============================== SYSTEM INFO  ================================
+Mbed OS Version: 999999
+CPU ID: 0x410fc241
+Compiler ID: 2
+Compiler Version: 60300
+RAM0: Start 0x20000000 Size: 0x30000
+RAM1: Start 0x1fff0000 Size: 0x10000
+ROM0: Start 0x0 Size: 0x100000
+================= CPU STATS =================
+Idle: 98% Usage: 2%
+================ HEAP STATS =================
+Current heap: 1096
+Max heap size: 1096
+================ THREAD STATS ===============
+ID: 0x20001eac
+Name: main_thread
+State: 2
+Priority: 24
+Stack Size: 4096
+Stack Space: 3296
+
+ID: 0x20000f5c
+Name: idle_thread
+State: 1
+Priority: 1
+Stack Size: 512
+Stack Space: 352
+
+ID: 0x20000f18
+Name: timer_thread
+State: 3
+Priority: 40
+Stack Size: 768
+Stack Space: 664
+
+```
+
+## Troubleshooting
+
+If you have problems, you can review the [documentation](https://os.mbed.com/docs/latest/tutorials/debugging.html) for suggestions on what could be wrong and how to fix it.
+
+## Related Links
+
+* [Mbed OS Stats API](https://os.mbed.com/docs/latest/apis/mbed-statistics.html)
+* [Mbed OS Configuration](https://os.mbed.com/docs/latest/reference/configuration.html)
+* [Mbed OS Serial Communication](https://os.mbed.com/docs/latest/tutorials/serial-communication.html)
+
+### License and contributions
+
+The software is provided under Apache-2.0 license. Contributions to this project are accepted under the same license. Please see contributing.md for more info.
+
+This project contains code from other projects. The original license text is included in those source files. They must comply with our license guide.

diff -r 000000000000 -r 739a04e1daf4 main.cpp
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/main.cpp	Wed Sep 11 07:34:38 2019 +0000
@@ -0,0 +1,401 @@
+/* WIZnet IoT Shield Cat.M1 Sample code for Arm MBED
+ * Copyright (c) 2019 WIZnet Co., Ltd.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+ 
+ /* 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+#include "mbed.h"
+
+#include <string>
+
+#define RET_OK                      1
+#define RET_NOK                     -1
+#define DEBUG_ENABLE                1
+#define DEBUG_DISABLE               0
+#define ON                          1
+#define OFF                         0
+
+#define MAX_BUF_SIZE                1024
+
+#define WM01_APN_PROTOCOL_IPv4      1
+#define WM01_APN_PROTOCOL_IPv6      2
+#define WM01_DEFAULT_TIMEOUT        1000
+#define WM01_CONNECT_TIMEOUT        15000
+#define WM01_SEND_TIMEOUT           500
+#define WM01_RECV_TIMEOUT           500
+#define WM01_BOOTING_TIME           15000
+
+#define WM01_APN_PROTOCOL           WM01_APN_PROTOCOL_IPv6
+#define WM01_DEFAULT_BAUD_RATE      115200
+#define WM01_PARSER_DELIMITER       "\r\n"
+
+#define CATM1_APN_SKT               "lte-internet.sktelecom.com"
+
+#define CATM1_DEVICE_NAME_WM01      "WM01"
+#define DEVNAME                     CATM1_DEVICE_NAME_WM01
+
+#define devlog(f_, ...)             if(CATM1_DEVICE_DEBUG == DEBUG_ENABLE) { pc.printf("\r\n[%s] ", DEVNAME);  pc.printf((f_), ##__VA_ARGS__); }
+#define myprintf(f_, ...)           {pc.printf("\r\n[MAIN] ");  pc.printf((f_), ##__VA_ARGS__);}
+
+/* Pin configuraiton */
+// Cat.M1
+#define MBED_CONF_IOTSHIELD_CATM1_TX        D8
+#define MBED_CONF_IOTSHIELD_CATM1_RX        D2
+#define MBED_CONF_IOTSHIELD_CATM1_RESET     D7
+#define MBED_CONF_IOTSHIELD_CATM1_PWRKEY    D9
+
+// Sensors
+#define MBED_CONF_IOTSHIELD_SENSOR_CDS      A0
+#define MBED_CONF_IOTSHIELD_SENSOR_TEMP     A1
+
+/* Debug message settings */
+#define WM01_PARSER_DEBUG                   DEBUG_DISABLE
+#define CATM1_DEVICE_DEBUG                  DEBUG_ENABLE 
+
+char periodic_tau[] = "10100001";   // (60s * 1) + (3s ~ 4s) = 63s ~ 64s
+char active_time[] = "00000001";    // (2s * 1) + (24s ~ 27s) = 26s ~ 29s
+
+// Functions: Print information
+void printInfo(void);
+
+// Functions: Module Status
+void waitCatM1Ready(void);
+int8_t setEchoStatus_WM01(bool onoff);
+int8_t getUsimStatus_WM01(void);
+int8_t getNetworkStatus_WM01(void);
+
+// Functions: PSM (Power Saving Mode)
+int8_t setPsmActivate_WM01(char *Requested_Periodic_TAU, char *Requested_Active_Time);
+int8_t setPsmDeactivate_WM01(void);
+
+// Functions: Network time
+int8_t getNetworkTimeLocal_WM01(char *time);
+void setFlagGettime(void);
+void clearFlagGettime(void);
+
+Serial pc(USBTX, USBRX);    // USB debug
+
+UARTSerial *_serial;        // Cat.M1 module    
+ATCmdParser *_parser;
+
+DigitalOut _RESET_WM01(MBED_CONF_IOTSHIELD_CATM1_RESET);
+DigitalOut _PWRKEY_WM01(MBED_CONF_IOTSHIELD_CATM1_PWRKEY);
+
+Ticker flip;
+
+bool flag_gettime = false;
+
+void serialPcInit(void)
+{
+    pc.baud(115200);
+    pc.format(8, Serial::None, 1);
+}
+
+void serialDeviceInit(PinName tx, PinName rx, int baudrate) 
+{        
+    _serial = new UARTSerial(tx, rx, baudrate);    
+}
+
+void serialAtParserInit(const char *delimiter, bool debug_en)
+{
+    _parser = new ATCmdParser(_serial);    
+    _parser->debug_on(debug_en);
+    _parser->set_delimiter(delimiter);    
+    _parser->set_timeout(WM01_DEFAULT_TIMEOUT);
+}
+
+void catm1DeviceInit(void)
+{
+    serialDeviceInit(   MBED_CONF_IOTSHIELD_CATM1_TX, 
+                        MBED_CONF_IOTSHIELD_CATM1_RX, 
+                        WM01_DEFAULT_BAUD_RATE);
+                        
+    serialAtParserInit( WM01_PARSER_DELIMITER, 
+                        WM01_PARSER_DEBUG);
+}
+
+void catm1DeviceReset_WM01(void)
+{
+    _RESET_WM01 = 1;
+    _PWRKEY_WM01 = 1;
+    wait_ms(300);
+    
+    _RESET_WM01 = 0;
+    _PWRKEY_WM01 = 0;
+    wait_ms(400);
+    
+    _RESET_WM01 = 1;    
+    wait_ms(1000);
+}
+
+// ----------------------------------------------------------------
+// Main routine
+// ----------------------------------------------------------------
+
+int main()
+{     
+    bool psm_en = false;
+    char time[30] = {0, };
+    float elapsed_time_sec = 0; 
+
+    Timer t;
+
+    serialPcInit();    
+    catm1DeviceInit();
+    
+    myprintf("Waiting for Cat.M1 Module Ready...\r\n");
+    
+    catm1DeviceReset_WM01();
+    
+    waitCatM1Ready();
+    
+    wait_ms(5000);
+            
+    myprintf("System Init Complete\r\n");
+        
+    printInfo();
+    
+    setEchoStatus_WM01(OFF);
+   
+    getUsimStatus_WM01();
+    
+    getNetworkStatus_WM01();
+
+#if 0
+// PSM disable   
+    setPsmDeactivate_WM01();
+#endif    
+
+    if(psm_en != true) 
+    {
+        if(setPsmActivate_WM01(periodic_tau, active_time) == RET_OK)
+        {
+            myprintf("Cat.M1 PSM enable, Device reboot\r\n");    
+
+            // Cat.M1 reboot
+            catm1DeviceReset_WM01();
+
+            waitCatM1Ready();
+        } 
+        else 
+        {
+            myprintf("Cat.M1 PSM enable failed\r\n");
+        }            
+    }
+
+    // Timer event callback       
+    flip.attach(callback(&setFlagGettime), 1.0);
+
+    while(1)
+    {
+        if(flag_gettime) 
+        {
+            if(getNetworkTimeLocal_WM01(time) == RET_OK) 
+            {
+                if(elapsed_time_sec > 0) 
+                {
+                    t.stop();
+
+                    myprintf("Cat.M1 Active, Sleep time: %.2fsec", elapsed_time_sec);                    
+
+                    elapsed_time_sec = 0;   
+                }    
+
+                myprintf("%s", time);
+            } 
+            else 
+            {
+                if(elapsed_time_sec == 0) 
+                {            
+                    t.reset();        
+                    t.start();         
+
+                    myprintf("%s", "PSM Power Down Start");               
+                }
+
+                elapsed_time_sec = t.read();
+
+                myprintf("Cat.M1 PSM, %.2f", elapsed_time_sec);               
+            }
+
+            clearFlagGettime();
+        }
+    }
+}
+
+// ----------------------------------------------------------------
+// Functions: Print information
+// ----------------------------------------------------------------
+
+void printInfo(void)
+{
+    myprintf("WIZnet IoT Shield for Arm MBED");
+    myprintf("LTE Cat.M1 Version");
+    myprintf("=================================================");
+    myprintf(">> Target Board: WIoT-WM01 (Woorinet WM-N400MSE)");
+    myprintf(">> Sample Code: PSM Test");
+    myprintf("=================================================\r\n");
+}
+
+// ----------------------------------------------------------------
+// Functions: Cat.M1 Status
+// ----------------------------------------------------------------
+
+void waitCatM1Ready(void)
+{
+    while(1) 
+    {
+        if(_parser->send("AT") && _parser->recv("OK"))
+        {
+            myprintf("WM01 is Available\r\n");
+            
+            return;
+        }
+    }
+}
+
+int8_t setEchoStatus_WM01(bool onoff)
+{
+    int8_t ret = RET_NOK;
+    char _buf[10];
+    
+    sprintf((char *)_buf, "ATE%d", onoff);    
+    
+    if(_parser->send(_buf) && _parser->recv("OK")) 
+    {        
+        devlog("Turn Echo %s : success\r\n", onoff ? "ON" : "OFF");
+
+        ret = RET_OK;
+    } 
+    else 
+    { 
+        devlog("Turn Echo %s : failed\r\n", onoff ? "ON" : "OFF");
+    }    
+
+    return ret;
+}
+ 
+int8_t getUsimStatus_WM01(void)
+{
+    int8_t ret = RET_NOK;
+    
+    if(_parser->send("AT$$STAT?") && _parser->recv("$$STAT:READY") && _parser->recv("OK")) 
+    {
+        devlog("USIM Status : READY\r\n");
+
+        ret = RET_OK;
+    } 
+    else 
+    { 
+        devlog("Retrieving USIM Status failed\r\n");        
+    }
+    
+    return ret;
+}
+
+int8_t getNetworkStatus_WM01(void)
+{
+    int8_t ret = RET_NOK;
+    int val, stat;
+    
+    if(_parser->send("AT+CEREG?") && _parser->recv("+CEREG: %d,%d", &val, &stat) && _parser->recv("OK")) 
+    {
+        if((val == 0) && (stat == 1))
+        {
+            devlog("Network Status : attached\r\n");
+
+            ret = RET_OK;
+        }
+        else
+        {
+            devlog("Network Status : %d, %d\r\n", val, stat);
+        }
+    }
+    else
+    {
+        devlog("Network Status : Error\r\n");
+    }
+
+    return ret;
+}
+
+// ----------------------------------------------------------------
+// Functions: Cat.M1 PSM activate / deactivate
+// ----------------------------------------------------------------
+
+int8_t setPsmActivate_WM01(char *Requested_Periodic_TAU, char *Requested_Active_Time)
+{
+    int8_t ret = RET_NOK;
+
+    if(_parser->send("AT+CPSMS=1,,,\"%s\",\"%s\"", Requested_Periodic_TAU, Requested_Active_Time) && _parser->recv("OK")) 
+    {
+        devlog("PSM activate : success\r\n");
+
+        ret = RET_OK;
+    }
+    else
+    {
+        devlog("PSM activate : failed\r\n");
+    }
+
+    return ret;
+}
+
+int8_t setPsmDeactivate_WM01(void)
+{
+    int8_t ret = RET_NOK;
+    
+    if(_parser->send("AT+CPSMS=0") && _parser->recv("OK"))
+    {
+        devlog("PSM deactivate : success\r\n");
+    }
+    else
+    {
+        devlog("PSM deactivate : failed\r\n");
+    }
+    
+    return ret;
+}
+
+// ----------------------------------------------------------------
+// Functions: Cat.M1 Network time
+// ----------------------------------------------------------------
+
+int8_t getNetworkTimeLocal_WM01(char *time)
+{
+    int8_t ret = RET_NOK;
+    
+    if(_parser->send("AT$$MSTIME?") && _parser->recv("$$MSTIME:%s\n", time) && _parser->recv("OK"))  
+    {
+        //devlog("Get current local time success\r\n");      
+
+        ret = RET_OK;
+    }
+
+    return ret;
+}
+
+void setFlagGettime(void)
+{
+    flag_gettime = true;
+}
+
+void clearFlagGettime(void)
+{
+    flag_gettime = false;
+}
\ No newline at end of file

diff -r 000000000000 -r 739a04e1daf4 mbed-os.lib
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mbed-os.lib	Wed Sep 11 07:34:38 2019 +0000
@@ -0,0 +1,1 @@
+https://github.com/ARMmbed/mbed-os/#5941d1718339116cd12914238ec331c84da3d08f

diff -r 000000000000 -r 739a04e1daf4 mbed_app.json
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mbed_app.json	Wed Sep 11 07:34:38 2019 +0000
@@ -0,0 +1,11 @@
+{
+    "target_overrides": {
+        "*": {
+            "platform.stack-stats-enabled": true,
+            "platform.heap-stats-enabled": true,
+            "platform.cpu-stats-enabled": true,
+            "platform.thread-stats-enabled": true,
+            "platform.sys-stats-enabled": true
+        }
+    }
+}

diff -r 000000000000 -r 739a04e1daf4 stats_report.h
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/stats_report.h	Wed Sep 11 07:34:38 2019 +0000
@@ -0,0 +1,133 @@
+/* mbed Microcontroller Library
+ * Copyright (c) 2018 ARM Limited
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef STATS_REPORT_H
+#define STATS_REPORT_H
+
+#include <inttypes.h>
+#include "mbed.h"
+
+/**
+ *  System Reporting library. Provides runtime information on device:
+ *      - CPU sleep, idle, and wake times
+ *      - Heap and stack usage
+ *      - Thread information
+ *      - Static system information
+ */
+class SystemReport {
+    mbed_stats_heap_t   heap_stats;
+    mbed_stats_cpu_t    cpu_stats;
+    mbed_stats_sys_t    sys_stats;
+
+    mbed_stats_thread_t *thread_stats;
+    uint8_t   thread_count;
+    uint8_t   max_thread_count;
+    uint32_t  sample_time_ms;
+
+public:
+    /**
+     *  SystemReport - Sample rate in ms is required to handle the CPU percent awake logic
+     */
+    SystemReport(uint32_t sample_rate) : max_thread_count(8), sample_time_ms(sample_rate)
+    {
+        thread_stats = new mbed_stats_thread_t[max_thread_count];
+
+        // Collect the static system information
+        mbed_stats_sys_get(&sys_stats);
+
+        printf("=============================== SYSTEM INFO  ================================\r\n");
+        printf("Mbed OS Version: %" PRIu32 " \r\n", sys_stats.os_version);
+        printf("CPU ID: 0x%" PRIx32 " \r\n", sys_stats.cpu_id);
+        printf("Compiler ID: %d \r\n", sys_stats.compiler_id);
+        printf("Compiler Version: %" PRIu32 " \r\n", sys_stats.compiler_version);
+
+        for (int i = 0; i < MBED_MAX_MEM_REGIONS; i++) {
+            if (sys_stats.ram_size[i] != 0) {
+                printf("RAM%d: Start 0x%" PRIx32 " Size: 0x%" PRIx32 " \r\n", i, sys_stats.ram_start[i], sys_stats.ram_size[i]);
+            }
+        }
+        for (int i = 0; i < MBED_MAX_MEM_REGIONS; i++) {
+            if (sys_stats.rom_size[i] != 0) {
+                printf("ROM%d: Start 0x%" PRIx32 " Size: 0x%" PRIx32 " \r\n", i, sys_stats.rom_start[i], sys_stats.rom_size[i]);
+            }
+        }
+    }
+
+    ~SystemReport(void)
+    {
+        free(thread_stats);
+    }
+
+    /**
+     *  Report on each Mbed OS Platform stats API
+     */
+    void report_state(void)
+    {
+        report_cpu_stats();
+        report_heap_stats();
+        report_thread_stats();
+
+        // Clear next line to separate subsequent report logs
+        printf("\r\n");
+    }
+
+    /**
+     *  Report CPU idle and awake time in terms of percentage
+     */
+    void report_cpu_stats(void)
+    {
+        static uint64_t prev_idle_time = 0;
+
+        printf("================= CPU STATS =================\r\n");
+
+        // Collect and print cpu stats
+        mbed_stats_cpu_get(&cpu_stats);
+
+        uint64_t diff = (cpu_stats.idle_time - prev_idle_time);
+        uint8_t idle = (diff * 100) / (sample_time_ms * 1000);  // usec;
+        uint8_t usage = 100 - ((diff * 100) / (sample_time_ms * 1000));  // usec;;
+        prev_idle_time = cpu_stats.idle_time;
+
+        printf("Idle: %d%% Usage: %d%% \r\n", idle, usage);
+    }
+
+    /**
+     *  Report current heap stats. Current heap refers to the current amount of
+     *  allocated heap. Max heap refers to the highest amount of heap allocated
+     *  since reset.
+     */
+    void report_heap_stats(void)
+    {
+        printf("================ HEAP STATS =================\r\n");
+
+        // Collect and print heap stats
+        mbed_stats_heap_get(&heap_stats);
+
+        printf("Current heap: %" PRIu32 "\r\n", heap_stats.current_size);
+        printf("Max heap size: %" PRIu32 "\r\n", heap_stats.max_size);
+    }
+
+    /**
+     *  Report active thread stats
+     */
+    void report_thread_stats(void)
+    {
+        printf("================ THREAD STATS ===============\r\n");
+
+        // Collect and print running thread stats
+        int count = mbed_stats_thread_get_each(thread_stats, max_thread_count);
+
+        for (int i = 0; i < count; i++) {
+            printf("ID: 0x%" PRIx32 " \r\n",        thread_stats[i].id);
+            printf("Name: %s \r\n",               thread_stats[i].name);
+            printf("State: %" PRIu32 " \r\n",       thread_stats[i].state);
+            printf("Priority: %" PRIu32 " \r\n",    thread_stats[i].priority);
+            printf("Stack Size: %" PRIu32 " \r\n",  thread_stats[i].stack_size);
+            printf("Stack Space: %" PRIu32 " \r\n", thread_stats[i].stack_space);
+        }
+    }
+};
+
+#endif // STATS_REPORT_H

diff -r 000000000000 -r 739a04e1daf4 tests/README.md
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tests/README.md	Wed Sep 11 07:34:38 2019 +0000
@@ -0,0 +1,12 @@
+# Testing examples
+
+Examples are tested using tool [htrun](https://github.com/ARMmbed/mbed-os-tools/tree/master/packages/mbed-host-tests) and templated print log. 
+
+To run the test, use following command after you build the example:
+```
+mbedhtrun -d D: -p COM4 -m K64F -f .\BUILD\K64F\GCC_ARM\blinky.bin --compare-log tests\blinky.log
+```
+
+
+More details about `htrun` are [here](https://github.com/ARMmbed/mbed-os-tools/tree/master/packages/mbed-host-tests#testing-mbed-os-examples).
+

diff -r 000000000000 -r 739a04e1daf4 tests/blinky.log
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tests/blinky.log	Wed Sep 11 07:34:38 2019 +0000
@@ -0,0 +1,29 @@
+=============================== SYSTEM INFO  ================================
+Mbed OS Version:
+CPU ID: 0x[0-9a-fA-F]+
+Compiler ID: \d+
+Compiler Version:
+================= CPU STATS =================
+Idle: \d+% Usage: \d+%
+================ HEAP STATS =================
+Current heap: \d+
+Max heap size: \d+
+================ THREAD STATS ===============
+ID: 0x[0-9a-fA-F]+
+Name: main
+State: \d+
+Priority: \d+
+Stack Size: \d+
+Stack Space: \d+
+ID: 0x[0-9a-fA-F]+
+Name: rtx_idle
+State: \d+
+Priority: \d+
+Stack Size: \d+
+Stack Space: \d+
+ID: 0x[0-9a-fA-F]+
+Name: rtx_timer
+State: \d+
+Priority: \d+
+Stack Size: \d+
+Stack Space: \d+