Merge pull request #44726 from antmicro:renode_doc

PiperOrigin-RevId: 347941083
Change-Id: Ibfcbdcf8f8b84f69fc8a5cbfdbecb16a89481657

tensorflow/lite/micro/docs/renode.md

@@ -56,6 +56,7 @@ make -f tensorflow/lite/micro/tools/make/Makefile TARGET=bluepill test
 
  * This makes use of the robot framework from Renode.
  * Note that the tests can currently not be run in parallel.
+ * It takes about 25 second to complete all tests, including around 3 seconds for suite startup/teardown and average 0.38 second per test.
 
 ## Under the hood of the Testing Infrastructure
 
@@ -74,9 +75,32 @@ failing.
 
 # Running a non-test Binary with Renode
 
-It may be useful to run binaries on Renode that are not tests, independent of
-the robot framework. We will be adding some documentation for that in this
-section.
+Renode can also be used to run and debug binaries interactively. 
+For example, to debug `kernel_addr_test` on Bluepill platform, run Renode:
+
+```
+tensorflow/lite/micro/tools/make/downloads/renode/renode
+```
+and issue following commands:
+```
+# Create platform
+include @tensorflow/lite/micro/testing/bluepill_nontest.resc
+# Load ELF file
+sysbus LoadELF @tensorflow/lite/micro/tools/make/gen/bluepill_cortex-m3/bin/kernel_add_test
+# Start simulation
+start
+```
+You can also connect GDB to the simulation.
+To do that, start the GDB server in Renode before issuing the `start` command:
+```
+machine StartGdbServer 3333
+```
+Than you can connect from GDB with:
+```
+target remote localhost:3333
+```
+
+For further reference please see the [Renode documentation](https://renode.readthedocs.io/en/latest/).
 
 # Useful External Links for Renode and Robot Documentation
 
@@ -102,4 +126,3 @@ section.
 
        * [Remove File](http://robotframework.org/robotframework/latest/libraries/OperatingSystem.html#Remove%20File)
        * [List Files In Directory](https://robotframework.org/robotframework/latest/libraries/OperatingSystem.html#List%20Files%20In%20Directory)
-

tensorflow/lite/micro/testing/bluepill_nontest.resc

@@ -0,0 +1,8 @@
+mach create
+# Load platform specification
+machine LoadPlatformDescription @platforms/cpus/stm32f103.repl    
+# Create additional semihosting interface peripheral
+machine LoadPlatformDescriptionFromString "uartSemihosting: UART.SemihostingUart @ cpu"
+# Open separate window for semihosting UART output
+showAnalyzer sysbus.cpu.uartSemihosting
+