interesting
/
riscv-openocd
mirror of https://github.com/riscv/riscv-openocd.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

OScan1 code cleanup 

- change OSCAN1 to OScan1
- fix spacing
This commit is contained in:
mrv96 2022-09-30 11:25:55 +02:00 committed by Tim Newsome
parent 6d4ba7cca8
commit b70ccf297f
2 changed files with 115 additions and 115 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
configure.ac
View File

@ -110,7 +110,7 @@ m4_define([ADAPTER_OPT], [m4_translit(ADAPTER_ARG($1), [_], [-])])
m4_define([USB1_ADAPTERS], m4_define([USB1_ADAPTERS],
[[[ftdi], [MPSSE mode of FTDI based devices], [FTDI]], [[[ftdi], [MPSSE mode of FTDI based devices], [FTDI]],
[[ftdi_oscan1], [cJTAG OSCAN1 tunneled thru MPSSE], [FTDI_OSCAN1]], [[ftdi_oscan1], [cJTAG OScan1 tunneled thru MPSSE], [FTDI_OSCAN1]],
[[stlink], [ST-Link Programmer], [HLADAPTER_STLINK]], [[stlink], [ST-Link Programmer], [HLADAPTER_STLINK]],
[[ti_icdi], [TI ICDI JTAG Programmer], [HLADAPTER_ICDI]], [[ti_icdi], [TI ICDI JTAG Programmer], [HLADAPTER_ICDI]],
[[ulink], [Keil ULINK JTAG Programmer], [ULINK]], [[ulink], [Keil ULINK JTAG Programmer], [ULINK]],

22
src/jtag/drivers/ftdi.c
View File

@ -107,16 +107,16 @@ static bool swd_mode;
#if BUILD_FTDI_OSCAN1 == 1 #if BUILD_FTDI_OSCAN1 == 1
/* /*
The cJTAG 2-wire OSCAN1 protocol, in lieu of 4-wire JTAG, is a configuration option The cJTAG 2-wire OScan1 protocol, in lieu of 4-wire JTAG, is a configuration option
for some SoCs. An FTDI-based adapter that can be configured to appropriately drive for some SoCs. An FTDI-based adapter that can be configured to appropriately drive
the bidirectional pin TMSC is able to drive OSCAN1 protocol. For example, an Olimex the bidirectional pin TMSC is able to drive OScan1 protocol. For example, an Olimex
ARM-USB-TINY-H with the ARM-JTAG-SWD adapter, connected to a cJTAG-enabled ARM-USB-TINY-H with the ARM-JTAG-SWD adapter, connected to a cJTAG-enabled
target board is such a topology. A TCK cycle with TMS=1/TDI=N translates to a TMSC target board is such a topology. A TCK cycle with TMS=1/TDI=N translates to a TMSC
output of N, and a TCK cycle with TMS=0 translates to a TMSC input from the target back output of N, and a TCK cycle with TMS=0 translates to a TMSC input from the target back
to the adapter/probe. The OSCAN1 protocol uses 3 TCK cycles to generate the data flow to the adapter/probe. The OScan1 protocol uses 3 TCK cycles to generate the data flow
that is equivalent to that of a single TCK cycle in 4-wire JTAG. The OSCAN1-related that is equivalent to that of a single TCK cycle in 4-wire JTAG. The OScan1-related
code in this module translates IR/DR scan commanads and JTAG state traversal commands code in this module translates IR/DR scan commanads and JTAG state traversal commands
to the two-wire clocking and signaling of OSCAN1 protocol, if placed into oscan1 mode to the two-wire clocking and signaling of OScan1 protocol, if placed into OScan1 mode
during initialization. during initialization.
*/ */
static void oscan1_reset_online_activate(void); static void oscan1_reset_online_activate(void);
@ -670,7 +670,7 @@ static void ftdi_execute_command(struct jtag_command *cmd)
switch (cmd->type) { switch (cmd->type) {
case JTAG_RESET: case JTAG_RESET:
#if BUILD_FTDI_OSCAN1 == 1 #if BUILD_FTDI_OSCAN1 == 1
oscan1_reset_online_activate(); /* put the target back into OSCAN1 mode */ oscan1_reset_online_activate(); /* put the target back into OScan1 mode */
#endif #endif
break; break;
case JTAG_RUNTEST: case JTAG_RUNTEST:
@ -679,7 +679,7 @@ static void ftdi_execute_command(struct jtag_command *cmd)
case JTAG_TLR_RESET: case JTAG_TLR_RESET:
ftdi_execute_statemove(cmd); ftdi_execute_statemove(cmd);
#if BUILD_FTDI_OSCAN1 == 1 #if BUILD_FTDI_OSCAN1 == 1
oscan1_reset_online_activate(); /* put the target back into OSCAN1 mode */ oscan1_reset_online_activate(); /* put the target back into OScan1 mode */
#endif #endif
break; break;
case JTAG_PATHMOVE: case JTAG_PATHMOVE:
@ -763,7 +763,7 @@ static int ftdi_initialize(void)
} else if (oscan1_mode) { } else if (oscan1_mode) {
struct signal *sig = find_signal_by_name("JTAG_SEL"); struct signal *sig = find_signal_by_name("JTAG_SEL");
if (!sig) { if (!sig) {
LOG_ERROR("OSCAN1 mode is active but JTAG_SEL signal is not defined"); LOG_ERROR("OScan1 mode is active but JTAG_SEL signal is not defined");
return ERROR_JTAG_INIT_FAILED; return ERROR_JTAG_INIT_FAILED;
} }
/* A dummy JTAG_SEL would have zero mask */ /* A dummy JTAG_SEL would have zero mask */
@ -816,7 +816,7 @@ static void oscan1_mpsse_clock_data(struct mpsse_ctx *ctx, const uint8_t *out, u
int bitnum; int bitnum;
uint8_t bit; uint8_t bit;
/* OSCAN1 uses 3 separate clocks */ /* OScan1 uses 3 separate clocks */
/* drive TMSC to the *negation* of the desired TDI value */ /* drive TMSC to the *negation* of the desired TDI value */
bitnum = out_offset + i; bitnum = out_offset + i;
@ -862,7 +862,7 @@ static void oscan1_mpsse_clock_tms_cs(struct mpsse_ctx *ctx, const uint8_t *out,
uint8_t tmsbit; uint8_t tmsbit;
uint8_t tdibit; uint8_t tdibit;
/* OSCAN1 uses 3 separate clocks */ /* OScan1 uses 3 separate clocks */
/* drive TMSC to the *negation* of the desired TDI value */ /* drive TMSC to the *negation* of the desired TDI value */
tdibit = tdi ? 0 : 1; tdibit = tdi ? 0 : 1;
@ -1356,7 +1356,7 @@ static const struct command_registration ftdi_subcommand_handlers[] = {
.name = "oscan1_mode", .name = "oscan1_mode",
.handler = &ftdi_handle_oscan1_mode_command, .handler = &ftdi_handle_oscan1_mode_command,
.mode = COMMAND_ANY, .mode = COMMAND_ANY,
.help = "set to 'on' to use OSCAN1 mode for signaling, otherwise 'off' (default is 'off')", .help = "set to 'on' to use OScan1 mode for signaling, otherwise 'off' (default is 'off')",
.usage = "(on|off)", .usage = "(on|off)",
}, },
#endif #endif