diff --git a/boards/stm32f4discovery/dist/board.resc b/boards/stm32f4discovery/dist/board.resc
new file mode 100644
index 0000000000..9acbdc27ba
--- /dev/null
+++ b/boards/stm32f4discovery/dist/board.resc
@@ -0,0 +1,19 @@
+:name: STM32F4 Discovery
+:description: This script runs the stm32f4_discovery on RIOT.
+
+using sysbus
+$name?="STM32F4_Discovery"
+mach create $name
+machine LoadPlatformDescription @platforms/boards/stm32f4_discovery-kit.repl
+
+cpu PerformanceInMips 125
+
+showAnalyzer sysbus.uart2
+
+
+macro reset
+"""
+    sysbus LoadELF $image_file
+"""
+
+runMacro $reset
diff --git a/boards/stm32f4discovery/doc.txt b/boards/stm32f4discovery/doc.txt
index 156c3feb0c..6d86ff7a54 100644
--- a/boards/stm32f4discovery/doc.txt
+++ b/boards/stm32f4discovery/doc.txt
@@ -166,6 +166,15 @@ The board is now flashed with your RIOT binary
    - **PA2** is connected with **RX** on the UART converter
 2. done
 
+# Emulator
+
+To emulate this board you need an updated version of
+[renode](https://github.com/renode/renode) installed, at least version 1.11.
+
+```
+BOARD=stm32f4discovery make all emulate
+```
+
 ## Known Issues / Problems
 
 ### I2C