[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openocd-development
Subject:    [PATCH]: 406f489efb doc: xtensa architecture clarifications/fixes
From:       gerrit () openocd ! org
Date:       2023-10-20 21:31:48
Message-ID: 20231020213148.4DD0DFE () openocd ! org
[Download RAW message or body]

This is an automated email from Gerrit.

"Ian Thompson <ianst@cadence.com>" just uploaded a new patch set to Gerrit, which you \
can find at https://review.openocd.org/c/openocd/+/7972

-- gerrit

commit 406f489efbf4b504bd62585e44ff23bd6e06d5c4
Author: ianst <ianst@cadence.com>
Date:   Fri Oct 20 13:00:41 2023 -0700

    doc: xtensa architecture clarifications/fixes
    
    - Fix Xtensa .cfg file references for NXP EVK
    - Add clarification note for "xtensa xtmem" command
    - Resolve TEX build warnings
    
    Signed-off-by: ianst <ianst@cadence.com>
    Change-Id: I0f2b56d0d084d86f557fadf3ac35fd04bf99650c

diff --git a/doc/openocd.texi b/doc/openocd.texi
index a2965189fb..d15f35739b 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -11352,16 +11352,18 @@ NOTE: @file{xtensa-core-XXX.cfg} must match the target \
Xtensa hardware  connected to OpenOCD.
 
 Some example Xtensa configurations are bundled with OpenOCD for reference:
-@itemize @bullet
+@enumerate
 @item Cadence Palladium VDebug emulation target. The user can combine their
 @file{xtensa-core-XXX.cfg} with the provided
 @file{board/xtensa-palladium-vdebug.cfg} to debug an emulated Xtensa RTL design.
-@item NXP MIMXRT685-EVK evaluation kit. The relevant configuration files are
-@file{board/xtensa-rt685-jlink.cfg} and @file{board/xtensa-core-nxp_rt600.cfg}.
-Additional information is provided by
-@uref{https://www.nxp.com/design/development-boards/i-mx-evaluation-and-development-boards/i-mx-rt600-evaluation-kit:MIMXRT685-EVK,
                
-NXP}.
+@item NXP MIMXRT685-EVK evaluation kit. The relevant configuration files are:
+@itemize @bullet
+@item @file{board/xtensa-rt685-ext.cfg}
+@item @file{target/xtensa-core-nxp_rt600.cfg}
 @end itemize
+Additional information is available by searching for "i.MX RT600 Evaluation Kit"
+on @url{https://www.nxp.com}.
+@end enumerate
 
 @subsection Xtensa Configuration Commands
 
@@ -11386,6 +11388,11 @@ others may be common to both but have different valid \
ranges.  Configure Xtensa target memory. Memory type determines access rights,
 where RAMs are read/write while ROMs are read-only. @var{baseaddr} and
 @var{bytes} are both integers, typically hexadecimal and decimal, respectively.
+
+NOTE: Some Xtensa memory types, such as system RAM/ROM or MMIO/device regions,
+can be added or modified after the Xtensa core has been generated. Additional
+@code{xtensa xtmem} definitions should be manually added to xtensa-core-XXX.cfg
+to keep OpenOCD's target address map consistent with the Xtensa configuration.
 @end deffn
 
 @deffn {Config Command} {xtensa xtmem} (@option{icache}|@option{dcache}) linebytes \
cachebytes ways [writeback]

-- 


[prev in list] [next in list] [prev in thread] [next in thread]