jtag/drivers/kitprog: Restructure commands
Use a command group 'kitprog' with subcommands instead of individual commands with 'kitprog_' prefix. The old command is still available to ensure backwards compatibility, but is marked as deprecated. Change-Id: I7f0d447939819ffc488a3d7a8de672b58887127f Signed-off-by: Marc Schink <dev@zapb.de> Reviewed-on: https://review.openocd.org/c/openocd/+/7967 Reviewed-by: Bohdan Tymkiv <bohdan200@gmail.com> Tested-by: jenkins Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
This commit is contained in:
parent
1c9f4ac181
commit
f55b122b42
|
@ -2991,7 +2991,7 @@ This driver is for Cypress Semiconductor's KitProg adapters. The KitProg is an
|
||||||
SWD-only adapter that is designed to be used with Cypress's PSoC and PRoC device
|
SWD-only adapter that is designed to be used with Cypress's PSoC and PRoC device
|
||||||
families, but it is possible to use it with some other devices. If you are using
|
families, but it is possible to use it with some other devices. If you are using
|
||||||
this adapter with a PSoC or a PRoC, you may need to add
|
this adapter with a PSoC or a PRoC, you may need to add
|
||||||
@command{kitprog_init_acquire_psoc} or @command{kitprog acquire_psoc} to your
|
@command{kitprog init_acquire_psoc} or @command{kitprog acquire_psoc} to your
|
||||||
configuration script.
|
configuration script.
|
||||||
|
|
||||||
Note that this driver is for the proprietary KitProg protocol, not the CMSIS-DAP
|
Note that this driver is for the proprietary KitProg protocol, not the CMSIS-DAP
|
||||||
|
@ -3012,14 +3012,14 @@ versions only implement "SWD line reset". Second, due to a firmware quirk, an
|
||||||
SWD sequence must be sent after every target reset in order to re-establish
|
SWD sequence must be sent after every target reset in order to re-establish
|
||||||
communications with the target.
|
communications with the target.
|
||||||
@item Due in part to the limitation above, KitProg devices with firmware below
|
@item Due in part to the limitation above, KitProg devices with firmware below
|
||||||
version 2.14 will need to use @command{kitprog_init_acquire_psoc} in order to
|
version 2.14 will need to use @command{kitprog init_acquire_psoc} in order to
|
||||||
communicate with PSoC 5LP devices. This is because, assuming debug is not
|
communicate with PSoC 5LP devices. This is because, assuming debug is not
|
||||||
disabled on the PSoC, the PSoC 5LP needs its JTAG interface switched to SWD
|
disabled on the PSoC, the PSoC 5LP needs its JTAG interface switched to SWD
|
||||||
mode before communication can begin, but prior to firmware 2.14, "JTAG to SWD"
|
mode before communication can begin, but prior to firmware 2.14, "JTAG to SWD"
|
||||||
could only be sent with an acquisition sequence.
|
could only be sent with an acquisition sequence.
|
||||||
@end itemize
|
@end itemize
|
||||||
|
|
||||||
@deffn {Config Command} {kitprog_init_acquire_psoc}
|
@deffn {Config Command} {kitprog init_acquire_psoc}
|
||||||
Indicate that a PSoC acquisition sequence needs to be run during adapter init.
|
Indicate that a PSoC acquisition sequence needs to be run during adapter init.
|
||||||
Please be aware that the acquisition sequence hard-resets the target.
|
Please be aware that the acquisition sequence hard-resets the target.
|
||||||
@end deffn
|
@end deffn
|
||||||
|
|
|
@ -879,6 +879,13 @@ static const struct command_registration kitprog_subcommand_handlers[] = {
|
||||||
.usage = "",
|
.usage = "",
|
||||||
.help = "try to acquire a PSoC",
|
.help = "try to acquire a PSoC",
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
.name = "init_acquire_psoc",
|
||||||
|
.handler = &kitprog_handle_init_acquire_psoc_command,
|
||||||
|
.mode = COMMAND_CONFIG,
|
||||||
|
.help = "try to acquire a PSoC during init",
|
||||||
|
.usage = "",
|
||||||
|
},
|
||||||
COMMAND_REGISTRATION_DONE
|
COMMAND_REGISTRATION_DONE
|
||||||
};
|
};
|
||||||
|
|
||||||
|
@ -890,13 +897,6 @@ static const struct command_registration kitprog_command_handlers[] = {
|
||||||
.usage = "<cmd>",
|
.usage = "<cmd>",
|
||||||
.chain = kitprog_subcommand_handlers,
|
.chain = kitprog_subcommand_handlers,
|
||||||
},
|
},
|
||||||
{
|
|
||||||
.name = "kitprog_init_acquire_psoc",
|
|
||||||
.handler = &kitprog_handle_init_acquire_psoc_command,
|
|
||||||
.mode = COMMAND_CONFIG,
|
|
||||||
.help = "try to acquire a PSoC during init",
|
|
||||||
.usage = "",
|
|
||||||
},
|
|
||||||
COMMAND_REGISTRATION_DONE
|
COMMAND_REGISTRATION_DONE
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|
|
@ -1126,6 +1126,12 @@ proc "cmsis_dap_usb" {args} {
|
||||||
eval cmsis-dap usb $args
|
eval cmsis-dap usb $args
|
||||||
}
|
}
|
||||||
|
|
||||||
|
lappend _telnet_autocomplete_skip "kitprog_init_acquire_psoc"
|
||||||
|
proc "kitprog_init_acquire_psoc" {} {
|
||||||
|
echo "DEPRECATED! use 'kitprog init_acquire_psoc', not 'kitprog_init_acquire_psoc'"
|
||||||
|
eval kitprog init_acquire_psoc
|
||||||
|
}
|
||||||
|
|
||||||
lappend _telnet_autocomplete_skip "pld device"
|
lappend _telnet_autocomplete_skip "pld device"
|
||||||
proc "pld device" {driver tap_name {opt 0}} {
|
proc "pld device" {driver tap_name {opt 0}} {
|
||||||
echo "DEPRECATED! use 'pld create ...', not 'pld device ...'"
|
echo "DEPRECATED! use 'pld create ...', not 'pld device ...'"
|
||||||
|
|
Loading…
Reference in New Issue