From a099c6328ebe3c40b9a002cf1d3784e86dce4472 Mon Sep 17 00:00:00 2001
From: raiden00pl <raiden00@railab.me>
Date: Sun, 27 Oct 2024 09:37:40 +0100
Subject: [PATCH] Documentation: update notes about nrf52840 and Renode

update notes about nrf52840 and Renode
---
 Documentation/guides/renode.rst | 44 +++++++++++++++++++++++++++++++--
 1 file changed, 42 insertions(+), 2 deletions(-)

diff --git a/Documentation/guides/renode.rst b/Documentation/guides/renode.rst
index e0fa78825a..f996dd6432 100644
--- a/Documentation/guides/renode.rst
+++ b/Documentation/guides/renode.rst
@@ -55,8 +55,48 @@ Doesn't work. No BASEPRI implementation for ``Cotex-M0`` in NuttX.
 nrf52840-dk
 ===========
 
-Nordic UART peripheral is not supported by Renode, UARTE support
-is required (EasyDMA).
+``CONFIG_ARMV7M_USEBASEPRI=y`` must be set.
+
+At default Renode uses UART with EasyDMA enabled (UARTE) which is not supported
+by Nuttx yet. We can get around this by creating our own machine description
+based on Renode default implementation::
+
+  using "platforms/cpus/nrf52840.repl"
+
+  uart0:
+    easyDMA: false
+
+Renode script::
+
+  using sysbus
+
+  mach create
+  machine LoadPlatformDescription @nrf52840_custom.repl
+
+  $bin?=@nuttx
+
+  showAnalyzer uart0
+
+  macro reset
+  """
+    sysbus LoadELF $bin
+  """
+
+  runMacro $reset
+
+Tested with ``nrf52840-dk/nsh``.
+
+Known issues:
+
+* ``QSPI`` not implemented in Renode,
+
+* ``PWM`` doesn't work, missing ``NRF52_PWM_EVENTS_SEQSTARTED0_OFFSET``
+  implementation in Renode,
+
+* ``ADC`` doesn't work, missing ``NRF52_SAADC_EVENTS_CALDONE_OFFSET``
+  implementation in Renode,
+
+* ``SoftDevice`` doesn't work, crash in ``mpsl_init()``
 
 stm32f746g-disco
 ================