diff --git a/ports/mimxrt/boards/MIMXRT1010_EVK/board.json b/ports/mimxrt/boards/MIMXRT1010_EVK/board.json
index 048430bead..4bf9ce0524 100644
--- a/ports/mimxrt/boards/MIMXRT1010_EVK/board.json
+++ b/ports/mimxrt/boards/MIMXRT1010_EVK/board.json
@@ -1,9 +1,16 @@
 {
     "deploy": [
-        "../deploy.md"
+        "../deploy_mimxrt.md"
     ],
     "docs": "",
-    "features": [],
+    "features": [
+        "MicroUSB",
+        "Microphone",
+        "AudioCodec",
+        "SPDIF",
+        "OpenSDA",
+        "JLink"
+    ],
     "images": [
         "i.MXRT1010-TOP.jpg"
     ],
diff --git a/ports/mimxrt/boards/MIMXRT1020_EVK/board.json b/ports/mimxrt/boards/MIMXRT1020_EVK/board.json
index 4dd3fed269..cc74c25fed 100644
--- a/ports/mimxrt/boards/MIMXRT1020_EVK/board.json
+++ b/ports/mimxrt/boards/MIMXRT1020_EVK/board.json
@@ -1,9 +1,19 @@
 {
     "deploy": [
-        "../deploy.md"
+        "../deploy_mimxrt.md"
     ],
     "docs": "",
-    "features": [],
+    "features": [
+        "Ethernet",
+        "SDRAM",
+        "MicroSD",
+        "MicroUSB",
+        "Microphone",
+        "AudioCodec",
+        "CAN",
+        "OpenSDA",
+        "JLink"
+    ],
     "images": [
         "MIMXRT-1020-EVKBD.jpg"
     ],
diff --git a/ports/mimxrt/boards/MIMXRT1050_EVK/board.json b/ports/mimxrt/boards/MIMXRT1050_EVK/board.json
index 9c0e22b373..d99ad9fcfd 100644
--- a/ports/mimxrt/boards/MIMXRT1050_EVK/board.json
+++ b/ports/mimxrt/boards/MIMXRT1050_EVK/board.json
@@ -1,9 +1,20 @@
 {
     "deploy": [
-        "../deploy.md"
+        "../deploy_mimxrt.md"
     ],
     "docs": "",
-    "features": [],
+    "features": [
+        "Ethernet",
+        "SDRAM",
+        "MicroSD",
+        "MicroUSB",
+        "Microphone",
+        "AudioCodec",
+        "SPDIF",
+        "CAN",
+        "OpenSDA",
+        "JLink"
+    ],
     "images": [
         "IMX_RT1050-EVKB_TOP-LR.jpg"
     ],
diff --git a/ports/mimxrt/boards/MIMXRT1060_EVK/board.json b/ports/mimxrt/boards/MIMXRT1060_EVK/board.json
index 14e8942de2..67a3818ee2 100644
--- a/ports/mimxrt/boards/MIMXRT1060_EVK/board.json
+++ b/ports/mimxrt/boards/MIMXRT1060_EVK/board.json
@@ -1,9 +1,21 @@
 {
     "deploy": [
-        "../deploy.md"
+        "../deploy_mimxrt.md"
     ],
     "docs": "",
-    "features": [],
+    "features": [
+        "Ethernet",
+        "SDRAM",
+        "MicroSD",
+        "MicroUSB",
+        "Microphone",
+        "AudioCodec",
+        "SPDIF",
+        "CAN",
+        "Camera",
+        "OpenSDA",
+        "JLink"
+    ],
     "images": [
         "X-MIMXRT1060-EVK-BOARD-BOTTOM.jpg"
     ],
diff --git a/ports/mimxrt/boards/MIMXRT1060_EVK/board.md b/ports/mimxrt/boards/MIMXRT1060_EVK/board.md
new file mode 100644
index 0000000000..5bca8d57f2
--- /dev/null
+++ b/ports/mimxrt/boards/MIMXRT1060_EVK/board.md
@@ -0,0 +1 @@
+The port for this board is experimental. It is made based on the documentation, but was not yet tested.
\ No newline at end of file
diff --git a/ports/mimxrt/boards/MIMXRT1064_EVK/board.json b/ports/mimxrt/boards/MIMXRT1064_EVK/board.json
index ff7f3f722e..ef12336c44 100644
--- a/ports/mimxrt/boards/MIMXRT1064_EVK/board.json
+++ b/ports/mimxrt/boards/MIMXRT1064_EVK/board.json
@@ -1,9 +1,21 @@
 {
     "deploy": [
-        "../deploy.md"
+        "../deploy_mimxrt.md"
     ],
     "docs": "",
-    "features": [],
+    "features": [
+        "Ethernet",
+        "SDRAM",
+        "MicroSD",
+        "MicroUSB",
+        "Microphone",
+        "AudioAmp",
+        "SPDIF",
+        "CAN",
+        "Camera",
+        "OpenSDA",
+        "JLink"
+    ],
     "images": [
         "MIMXRT1064EVK-TOP.jpg"
     ],
diff --git a/ports/mimxrt/boards/MIMXRT1064_EVK/board.md b/ports/mimxrt/boards/MIMXRT1064_EVK/board.md
new file mode 100644
index 0000000000..5bca8d57f2
--- /dev/null
+++ b/ports/mimxrt/boards/MIMXRT1064_EVK/board.md
@@ -0,0 +1 @@
+The port for this board is experimental. It is made based on the documentation, but was not yet tested.
\ No newline at end of file
diff --git a/ports/mimxrt/boards/TEENSY40/board.json b/ports/mimxrt/boards/TEENSY40/board.json
index dfc0ca96b3..daa6dbf99e 100644
--- a/ports/mimxrt/boards/TEENSY40/board.json
+++ b/ports/mimxrt/boards/TEENSY40/board.json
@@ -1,9 +1,11 @@
 {
     "deploy": [
-        "../deploy.md"
+        "../deploy_teensy.md"
     ],
     "docs": "",
-    "features": [],
+    "features": [
+        "Breadboard Friendly"
+    ],
     "images": [
         "teensy40_front.jpg"
     ],
diff --git a/ports/mimxrt/boards/TEENSY41/board.json b/ports/mimxrt/boards/TEENSY41/board.json
index cbb397c727..1f8fe37a99 100644
--- a/ports/mimxrt/boards/TEENSY41/board.json
+++ b/ports/mimxrt/boards/TEENSY41/board.json
@@ -1,9 +1,13 @@
 {
     "deploy": [
-        "../deploy.md"
+        "../deploy_teensy.md"
     ],
     "docs": "",
-    "features": [],
+    "features": [
+        "MicroSD",
+        "Ethernet",
+        "Breadboard Friendly"
+    ],
     "images": [
         "teensy41_4.jpg"
     ],
diff --git a/ports/mimxrt/boards/deploy.md b/ports/mimxrt/boards/deploy.md
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/ports/mimxrt/boards/deploy_mimxrt.md b/ports/mimxrt/boards/deploy_mimxrt.md
new file mode 100644
index 0000000000..35752a8362
--- /dev/null
+++ b/ports/mimxrt/boards/deploy_mimxrt.md
@@ -0,0 +1,11 @@
+Firmware can be loaded to the MIMXRT development boards in various ways. The most convenient
+one is using the built-in support MCU. When a PC is connected to the debug USB port, a drive
+icon will appear. Firmware can be uploaded to the board by copying it to this drive. The copy
+and flashing will take a few moments. At the end of the upload, the drive icon will disappear
+and reappear again. Then the reset button has to be pushed, which starts the MicroPython firmware.
+
+Depending on the power jumper settings, both the debug USB and OTG USB port have to be powered
+during firmware upload.
+
+You may as well load the firmware using the JLink port or openSDA interface with the appropriate tools.
+For more options, consult the user guide of the board.
diff --git a/ports/mimxrt/boards/deploy_teensy.md b/ports/mimxrt/boards/deploy_teensy.md
new file mode 100644
index 0000000000..f481544900
--- /dev/null
+++ b/ports/mimxrt/boards/deploy_teensy.md
@@ -0,0 +1,14 @@
+For deploying the firmware use the Teensy Loader tool provided by PJRC on their web site.
+PJRC provides both a graphical and command line version for Windows, OS X and Linux.
+With the command line version, run the command:
+
+```bash
+teensy_loader_cli --mcu=imxrt1062 -v -w TEENSY40-<date_version_tag>.hex
+```
+or for Teensy 4.1:
+
+```bash
+teensy_loader_cli --mcu=imxrt1062 -v -w TEENSY41-<date_version_tag>.hex
+```
+
+When loading the firmware the PJRC boot loader will erase the content of the board file system.