aboutsummaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2023-09-29Merge pull request #918 from kr-sc/kr-sc/allow-to-query-status-dcsr-ebreakTim Newsome1-3/+3
openocd does not allow to query status of dcsr.ebreak{u,s,m}
2023-09-26openocd does not allow to query status of dcsr.ebreak{u,s,m}Kirill Radkin1-3/+3
Extend riscv set_ebreak* commands. Now it can be called without args to print current value. riscv_ebreak* flags are moved to riscv_info struct. Change-Id: Ib46e6b6dfc0117599c7f6715c7aaf113e63bd7dc Signed-off-by: Kirill Radkin <kirill.radkin@syntacore.com>
2023-09-12Merge commit 'ee31f1578a333a75737bc5b183cd4ae98cdaf798' into from_upstreamTim Newsome1-3/+11
Conflicts: Makefile.am jimtcl src/helper/Makefile.am src/rtos/rtos.c src/rtos/rtos.h src/rtos/rtos_standard_stackings.c Change-Id: I00c98d20089558744988184370a8cb7f95f03329
2023-09-11Merge pull request #911 from riscv/from_upstreamTim Newsome3-1/+136
From upstream
2023-09-07target/riscv: cleanup riscv_enumerate_triggers()Evgeniy Naydanov1-1/+3
1. Propagate error codes. 2. Disable leftover triggers in case `tinfo` is supported. Change-Id: Ie20edb4d8b9245e13ac8757bf6afe549ac99c4f1 Signed-off-by: Evgeniy Naydanov <evgeniy.naydanov@syntacore.com>
2023-08-29Merge commit 'dfbbfac4d72e247e8094a49c8573b2f49689b6d5' into from_upstreamTim Newsome3-1/+136
Change-Id: I6e7c0866291dd87946a4fd49d9bfe4cddefb3957
2023-07-31Merge pull request #884 from riscv/from_upstreamTim Newsome31-0/+3905
Merge up to a3ed12401 from upstream.
2023-07-26target/riscv: add dm layerMark Zhuang1-4/+17
prepare for support multiple DMs Change-Id: Ia313006376e4fa762449343e5522b59d3bfd068a Signed-off-by: Mark Zhuang <mark.zhuang@spacemit.com>
2023-07-14target/riscv: update some macroMark Zhuang1-5/+3
1. update RISCV_MAX_HARTS to 2^20 according to SPEC 2. remove RISCV_MAX_REGISTERS, it's not used anywhere anymore 3. add parentheses Change-Id: Iadf0fa1ba3bbe5b9420b8430883e140db87f4f9e Signed-off-by: Mark Zhuang <mark.zhuang@spacemit.com>
2023-07-12Merge commit 'a3ed12401b1f7d9578fb7da881d3504e07acfc27' into from_upstreamTim Newsome31-0/+3905
Conflicts: src/target/riscv/riscv-013.c src/target/riscv/riscv.c Change-Id: I65bdb4d28c91e9022ce811de976c9bf474a0b590
2023-07-03[target/riscv] support for smp group manipulationParshintsev Anatoly1-0/+12
this functionality allows to query if a target belongs to some smp group and to dynamically turn on/off smp-specific behavior Change-Id: I469453d95e7c1640a91bc60d80c854404e508535 Signed-off-by: Parshintsev Anatoly <anatoly.parshintsev@syntacore.com>
2023-05-04Merge commit '228fe7300c7df7aa05ba2c0bc19edde6d0156401' into from_upstreamTim Newsome1-23/+44
Conflicts: doc/openocd.texi src/jtag/aice/aice_pipe.c src/jtag/aice/aice_usb.c src/rtos/FreeRTOS.c src/rtos/hwthread.c src/rtos/rtos_standard_stackings.c src/target/riscv/riscv.c Change-Id: I0c6228c499d60274325be895fbcd8007ed1699bc
2023-04-05Merge pull request #816 from riscv/from_upstreamTim Newsome4-239/+1767
Merge up to commit '1293ddd65713d6551775b67169387622ada477c1' from upstream
2023-03-29doc/openocd.texi: fix expose_csrs exampleHang Xu1-3/+3
The first part of the command should be only "riscv expose_csrs", the $_TARGETNAME value is not necessarily "riscv", in fact it is generally riscv.cpux. Signed-off-by: Hang Xu <xuhang@eswincomputing.com>
2023-03-18svf: new command line options -noreset and -addcyclesKai Schmitz1-1/+6
-noreset: when using several SVF input files in a sequence it is not always desireable to have a JTAG reset between the execution of the files. The -noreset option skips this unwanted reset. -addcycles <x>: some tests rely on a certain number of extra clock cycles between the actual JTAG commands. The -addcycles option injects a number x cycles after each SDR instruction. Signed-off-by: Kai Schmitz <kai.schmitz@advantest.com> Change-Id: I31932d6041dbc803be00016cd0a4f23fb2e7dbe1 Reviewed-on: https://review.openocd.org/c/openocd/+/7433 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2023-03-18doc: add missing FreeRTOS symbolChao Du1-1/+1
A new FreeRTOS symbol xSchedulerRunning was added into the symbol list. But the doc was not updated accordingly. Signed-off-by: Chao Du <duchao@eswincomputing.com> Change-Id: If1b18591e2681477ad96f1dea566cc2547097767 Reviewed-on: https://review.openocd.org/c/openocd/+/7531 Tested-by: jenkins Reviewed-by: Tomas Vanek <vanekt@fbl.cz> Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2023-03-16Merge commit '1293ddd65713d6551775b67169387622ada477c1' into from_upstreamTim Newsome4-239/+1767
This includes https://sourceforge.net/p/openocd/mailman/message/37710818/, which should fix #814. Conflicts: .travis.yml contrib/loaders/flash/stm32/stm32f1x.S contrib/loaders/flash/stm32/stm32f2x.S doc/openocd.texi src/rtos/FreeRTOS.c src/server/gdb_server.c src/target/riscv/riscv-013.c src/target/riscv/riscv.c src/target/riscv/riscv.h src/target/riscv/riscv_semihosting.c tcl/target/esp_common.cfg tcl/target/gd32vf103.cfg tools/scripts/checkpatch.pl Change-Id: I1986c13298ca0dafbe3aecaf1b0b35626525e4eb
2023-03-08Calculate the FreeRTOS type sizes and offsets more adaptively. (#806)Chao Du1-0/+8
* Calculate the FreeRTOS type sizes and offsets more adaptively. The definition of TickType_t varies between different targets. And it is also related to configUSE_16_BIT_TICKS option. Thus introduce a new command to make sure we are using a correct ticktype size. Change-Id: I9e38b331a9f07b96eb9a2c259e32377fca0106ad Signed-off-by: Chao Du <duchao@eswincomputing.com> * redundant semicolon. Change-Id: Ia21f0537e476099d8fe519ef78b3328d14123a38 * Update after review. Change-Id: I1825185ec9b0557d7e01f34a8f366661b3734aa7 * update doc Change-Id: I24b21c88b02ca3d76f1362f2545e86c068fc0ec6 --------- Signed-off-by: Chao Du <duchao@eswincomputing.com>
2023-02-28Merge commit 'd1b882f2c014258be5397067e45848fa5465b78b' into from_upstreamTim Newsome1-64/+290
Conflicts: doc/openocd.texi src/target/riscv/riscv-013.c src/target/riscv/riscv.c Change-Id: I8cd557a10c3d5beeaed05ecc05d4c325a9ee7e70
2023-02-16Merge pull request #799 from riscv/icountTim Newsome1-2/+20
Add `riscv icount` command.
2023-02-15target/riscv: hide_csrs configuration option (#787)Anatoly Parshintsev1-0/+17
* target/riscv: hide_csrs configuration option This option allows users to mark certain CSRs as hidden so they could be expluded from *reg* output and target.xml Change-Id: Iddf8456cd3901f572f8590329ebba5229974d24a * Update doc/openocd.texi Co-authored-by: Jan Matyas <50193733+JanMatCodasip@users.noreply.github.com> Signed-off-by: Anatoly Parshintsev <114445139+aap-sc@users.noreply.github.com> * Update src/target/riscv/riscv.c Co-authored-by: Jan Matyas <50193733+JanMatCodasip@users.noreply.github.com> Signed-off-by: Anatoly Parshintsev <114445139+aap-sc@users.noreply.github.com> --------- Signed-off-by: Anatoly Parshintsev <114445139+aap-sc@users.noreply.github.com> Co-authored-by: Jan Matyas <50193733+JanMatCodasip@users.noreply.github.com>
2023-02-15Add command "exec_progbuf" (#795)Jan Matyas1-0/+33
* Add command "exec_progbuf" Command "exec_progbuf" allows to execute a user-specified sequence of instructions using the program buffer. Change-Id: If3b9614129d0b6fcbc33fade29d3d60b35e52f98 Signed-off-by: Jan Matyas <jan.matyas@codasip.com> * Updated the doc: - Minor reword and reorder of the sentences. - Added information about C-instructions in progbuf. - Fixed a typo (per the review). - Added examples. Change-Id: I88c9a3ff3c6b60614be7eafd3a6f21be722a77b7 Signed-off-by: Jan Matyas <jan.matyas@codasip.com> * Cosmetic changes Change-Id: I7135c9f435f640e189c7d7922a2702814dfd595f Signed-off-by: Jan Matyas <jan.matyas@codasip.com> --------- Signed-off-by: Jan Matyas <jan.matyas@codasip.com> Co-authored-by: Jan Matyas <jan.matyas@codasip.com>
2023-02-15Clarify that RISC-V triggers are optional.Tim Newsome1-2/+3
Change-Id: I3a1f5a30385969964351b6ccadf09a3796d34d6b Signed-off-by: Tim Newsome <tim@sifive.com>
2023-02-15Add `riscv icount` command.Tim Newsome1-0/+17
Also refactor shared code for clearing itrigger/etrigger/icount. Change-Id: Iac2e756332c89d2ed43435391e3c097abc825255 Signed-off-by: Tim Newsome <tim@sifive.com>
2023-01-28rtos: Support rt-kernelAndreas Fritiofson1-1/+4
Works for the proprietary rt-kernel from rt-labs. See: https://rt-labs.com/product/rt-kernel/ Change-Id: Id2c2e292c15fb17eab25e3d07db05014daa2a2b0 Signed-off-by: Andreas Fritiofson <andreas.fritiofson@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/6668 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2023-01-28doc:usb_adapters: add lsusb dump of esp_usb_jtagErhan Kurubas3-1/+136
Also, esp_usb_jtag added to the supported driver list of "adapter serial" command. Signed-off-by: Erhan Kurubas <erhan.kurubas@espressif.com> Change-Id: Ie65cbf9b44f5de6d7995102d1a281161468f6103 Reviewed-on: https://review.openocd.org/c/openocd/+/7440 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2023-01-15doc: usb_adapters: add other adaptersAntonio Borneo10-0/+1232
Mainly get from web or from OpenOCD users Change-Id: Id4d6354bc9b6972622adfacf3549c7c3e0549bc2 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7298 Tested-by: jenkins
2023-01-15doc: usb_adapters: add lsusb dump of few adaptersAntonio Borneo19-0/+2606
Real dumps from adapters I have access to. Serial numbers have been manually edited but are still consistent. Change-Id: Iee2d16e09615746e29588f91fdfb77eb9fad4daa Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7297 Tested-by: jenkins
2023-01-15doc: usb_adapters: add container for lsusb dump of adaptersAntonio Borneo2-0/+67
When extending an existing adapter driver, developer has to carefully avoid to break backward compatibility. But not all developers have access to many adapters for testing. Prepare a folder aimed at containing 'lsusb -v' dumps of adapters to be used as reference. Add documentation and a simple dump script. Change-Id: Ia3a9132d65ec8869734721f9605cebcebcf33608 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7296 Tested-by: jenkins
2023-01-15armv8: Add support of pointer authenticationKoudai Iwahori1-0/+10
When pointer authentication is enabled, some upper bits of the link register (LR[63:VA_SIZE]) are used to store a signature. Therefore, GDB need to remove the signature to get backtraces. GDB has support of pointer authentication. When pointer authenticaion is enabled, GDB requests 8-bytes mask to the target to remove the signature. mask[63:VA_SIZE] should be all set and mask[VA_SIZE-1:0] should be all cleared. GDB removes the signature by addr&~mask or addr|mask. I added a feature to provide the mask for pointer authentication. Signed-off-by: Koudai Iwahori <koudai@google.com> Change-Id: I56fbbf9cc23619b6536ecd326f350c8bf137f322 Reviewed-on: https://review.openocd.org/c/openocd/+/7248 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2023-01-15nds32: drop it, together with aice adapter driverAntonio Borneo1-4/+1
The target nds32 and its companion adapter aice have not received any real improvement since 2013. It has been hard to keep them aligned during the evolution of OpenOCD code, with no way for maintainers to really check if they are still working. No real documentation is present for them in OpenOCD. The nds32 code triggers ~50 errors/warnings with scan-build. The arch nds32 has been dropped from Linux kernel v5.18-rc1. For all the reasons above, this code has been deprecated with commit 2e5df83de7f2 ("nds32: deprecate it, together with aice adapter driver") and tagged to be dropped before v0.13.0. Let it r.i.p. in OpenOCD git history. While there, drop from checkpatch list the camelcase symbols that where only used in this code. Change-Id: Ide52a217f2228e9da2f1cc5036c48f3536f26952 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7382 Tested-by: jenkins
2023-01-02target/riscv: Add `riscv etrigger` command.Tim Newsome1-0/+15
Change-Id: I7982231c5067b82e4ddb2999bca51dba06ccac7a Signed-off-by: Tim Newsome <tim@sifive.com>
2023-01-02target/riscv: Add `riscv itrigger` command.Tim Newsome1-0/+22
This lets the user set an itrigger trigger, which doesn't fit in the normal breakpoint abstraction. This implementation only allows control of a single itrigger. Hardware could support more than one, and that may be useful to catch different interrupts in different execution modes. But it would make the code/UI more complex and it feels like an unlikely use case. Change-Id: I76c88636ee73d4bd298b2bd1435cb5d052e86c91 Signed-off-by: Tim Newsome <tim@sifive.com>
2022-12-03doc: describe tcl port consistently.Karl Palsson1-1/+1
One place described the tcl port as 5555, which was changed in 163bd86071a Reported on IRC. Change-Id: If740a29443793d6a4d4f8c9db54f0fc8344a6c1c Signed-off-by: Karl Palsson <karlp@tweak.net.au> Reviewed-on: https://review.openocd.org/c/openocd/+/7385 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2022-11-11pld/virtex2: small doc extensionDaniel Anselmi1-0/+8
Change-Id: I174cd702388be04268b38178fbfacb90db452f72 Signed-off-by: Daniel Anselmi <danselmi@gmx.ch> Reviewed-on: https://review.openocd.org/c/openocd/+/7303 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2022-10-21doc: fix semihosting_redirect command documentationTarek BOCHKATI1-2/+2
Change-Id: I78c82a21e4160851a5c0b58394ac7897479808ff Signed-off-by: Tarek BOCHKATI <tarek.bouchkati@st.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7278 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2022-10-21doc: fix riscv commandsAntonio Borneo1-6/+11
- Fix the declaration of riscv command 'set_mem_access'. - Remove non existing riscv command 'set_scratch_ram'. - Add riscv commands 'info', 'reset_delays'; copy the description from the 'help' text. - Don't add riscv commands 'set_prefer_sba' and 'test_sba_config_reg' as they are marked as deprecated. - Ensure that 'test_sba_config_reg' prints a deprecation warning when used. Change-Id: I39dc3aec4e7f13b69ac19685f1b593790acdde83 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Signed-off-by: Jan Matyas <matyas@codasip.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7268 Reviewed-by: Tim Newsome <tim@sifive.com> Tested-by: jenkins
2022-10-21doc: remove unreferenced anchorsAntonio Borneo1-4/+0
Remove the @anchor{} tags that are not referenced in the documentation. Change-Id: Ia8e9f75afb08e08ef99d0c8fd82115d689e4a267 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7270 Tested-by: jenkins
2022-10-21doc: fix espusbjtag commands typeAntonio Borneo1-2/+2
Exec commands should be reported as {Command}. Change-Id: Iacb50d77b354617ecd24b0f1c2ec24e240179698 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7267 Tested-by: jenkins Reviewed-by: Erhan Kurubas <erhan.kurubas@espressif.com>
2022-10-21doc: fix xtensa commands typeAntonio Borneo1-9/+9
Config commands should be reported as {Config Command} Change-Id: Ic778df31bb1dc9aefdbe3d8006b06bb370d25e6f Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7266 Tested-by: jenkins Reviewed-by: Ian Thompson <ianst@cadence.com> Reviewed-by: Erhan Kurubas <erhan.kurubas@espressif.com>
2022-10-05Support cJTAG JScan3 modemrv961-0/+9
2022-09-23doc: fix copyright datesAntonio Borneo1-1/+1
The copyright date for OpenOCD project has never been updated. Add the range till current year. Change-Id: I42c7e3b2bf2e3a486bf836d063460dfa7b40d24d Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7201 Tested-by: jenkins
2022-09-22Improve oSCAN1 documentationmrv961-3/+16
Signed-off-by: mrv96 <mrv96@users.noreply.github.com>
2022-09-18checkpatch: import new script version from kernel v6.0-rc3Antonio Borneo1-0/+1249
Replace existing checkpatch script with the one available in the latest Linux kernel. Add also from the same kernel version the spelling database and the script spdxcheck.py, even if the script cannot be found by checkpatch in the current path. Add an empty "const_structs.checkpatch" file and an initial "spdxexclude" file. The script as is doesn't work properly in OpenOCD project. Further patches in this series are required. Gerrit will use the checkpatch in this commit to test/build the commit itself. A minimal configuration file is then required to avoid a failure in the test/build process. This commit includes the OpenOCD commits: commit 164450a01576 ("Change checkpatch.pl tab expanding to 4 characters.") commit 667d510dabd5 ("checkpatch: fix false indent trigger") already merged in upstream checkpatch in kernel v6.0-rc3. Change-Id: Ic9cdecff2df0a1e23cdb01d10f14c5988480b8d6 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/5116 Tested-by: jenkins
2022-09-13drivers/bcm2835gpio: Migrate to adapter gpio commandsSteve Marple1-56/+2
Use the new "adapter gpio" commands to configure the GPIOs used by the bcm2835gpio driver. The driver supports only 1 chip (gpiochip0). The reset function now honours the srst_open_drain and trst_open_drain options. Signed-off-by: Steve Marple <stevemarple@googlemail.com> Change-Id: I5b6c68b16362000cf5141a83394549d2bf3af108 Reviewed-on: https://review.openocd.org/c/openocd/+/7123 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2022-09-13src/flash/nor: flash driver for RSL10Toms Stūrmanis1-0/+25
Add new flash driver for internal flash of onsemi RSL10 device. Valgrind-clean. Clang AddressSanitizer shows no errors. Signed-off-by: Toms Stūrmanis <toms.sturmanis@gmail.com> Change-Id: I8030542cb9805e94f56d7a69404cef5d88d6dd5a Reviewed-on: https://review.openocd.org/c/openocd/+/7115 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-by: Tomas Vanek <vanekt@fbl.cz>
2022-08-27doc: how to use QEMU to test big-endian buildAntonio Borneo2-0/+199
Document the process of using buildroot to build a big-endian binary of OpenOCD and using QEMU User Mode Emulation for running the big-endian binary on a little-endian host PC. Change-Id: Ic5fe26e353a4cf69e57af3c23ae7fa4b25347b2b Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/6968 Tested-by: jenkins Reviewed-by: Tomas Vanek <vanekt@fbl.cz>
2022-08-20target: add generic Xtensa LX supportIan Thompson1-17/+144
Generic Xtensa LX support extends the original Espressif/Xtensa patch-set to support arbitrary Xtensa configurations, as defined in a core-specific .cfg file. Not yet fully-featured. Additional functionality to be added: - Xtensa NX support - DAP/SWD support - File-IO support - Generic Xtensa multi-core support Valgrind-clean, no new Clang analyzer warnings Signed-off-by: Ian Thompson <ianst@cadence.com> Change-Id: I08e7bf8fa57c25b5d0cb75a1aa7a2ac13a380c52 Reviewed-on: https://review.openocd.org/c/openocd/+/7055 Tested-by: jenkins Reviewed-by: Erhan Kurubas <erhan.kurubas@espressif.com> Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2022-08-15drivers/linuxgpiod: Migrate to adapter gpio commandsSteve Marple1-81/+8
Use the new "adapter gpio" commands to configure the GPIOs used by the linuxgpiod driver. Adds support for drive mode and resistor pull options on all signals. Change-Id: Ic90cb4f06db82435294228b6793330107a9f3606 Signed-off-by: Steve Marple <stevemarple@googlemail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/7048 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
2022-08-15drivers/am335xgpio: Migrate to adapter gpio commandsSteve Marple1-74/+4
Use the new "adapter gpio" commands to configure the GPIOs used by the am335xgpio driver. The AM335x has 4 GPIO 'chips' (chip number 0-3 inclusive), with each one providing 32 GPIOs (gpio_num 0-31 inclusive). Change-Id: I7c63c0e4763657ea51790c43fc40d32b7c3580bb Signed-off-by: Steve Marple <stevemarple@googlemail.com> Reviewed-on: https://review.openocd.org/c/openocd/+/6984 Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>