fixed warnings + added zy1000 jtag_add_clocks support.
[openocd.git] / src / jtag / zy1000.c
blob2c56191326a5af2ece954f385b6702fb0d24d552
1 /***************************************************************************
2 * Copyright (C) 2007-2008 by Øyvind Harboe *
3 * *
4 * This program is free software; you can redistribute it and/or modify *
5 * it under the terms of the GNU General Public License as published by *
6 * the Free Software Foundation; either version 2 of the License, or *
7 * (at your option) any later version. *
8 * *
9 * This program is distributed in the hope that it will be useful, *
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
12 * GNU General Public License for more details. *
13 * *
14 * You should have received a copy of the GNU General Public License *
15 * along with this program; if not, write to the *
16 * Free Software Foundation, Inc., *
17 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
18 ***************************************************************************/
19 #ifdef HAVE_CONFIG_H
20 #include "config.h"
21 #endif
24 #include "log.h"
25 #include "jtag.h"
26 #include "bitbang.h"
27 #include "../target/embeddedice.h"
30 #include <cyg/hal/hal_io.h> // low level i/o
31 #include <cyg/hal/hal_diag.h>
33 #include <stdlib.h>
35 #define ZYLIN_VERSION "1.48"
36 #define ZYLIN_DATE __DATE__
37 #define ZYLIN_TIME __TIME__
38 #define ZYLIN_OPENOCD "$Revision: 1241 $"
39 #define ZYLIN_OPENOCD_VERSION "Zylin JTAG ZY1000 " ZYLIN_VERSION " " ZYLIN_DATE " " ZYLIN_TIME
40 const char *zylin_config_dir="/config/settings";
42 extern int jtag_error;
44 /* low level command set
46 int zy1000_read(void);
47 static void zy1000_write(int tck, int tms, int tdi);
48 void zy1000_reset(int trst, int srst);
51 int zy1000_speed(int speed);
52 int zy1000_register_commands(struct command_context_s *cmd_ctx);
53 int zy1000_init(void);
54 int zy1000_quit(void);
56 /* interface commands */
57 int zy1000_handle_zy1000_port_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
59 static int zy1000_khz(int khz, int *jtag_speed)
61 if (khz==0)
63 *jtag_speed=0;
65 else
67 *jtag_speed=64000/khz;
69 return ERROR_OK;
72 static int zy1000_speed_div(int speed, int *khz)
74 if (speed==0)
76 *khz = 0;
78 else
80 *khz=64000/speed;
83 return ERROR_OK;
86 static bool readPowerDropout(void)
88 cyg_uint32 state;
89 // sample and clear power dropout
90 HAL_WRITE_UINT32(ZY1000_JTAG_BASE+0x10, 0x80);
91 HAL_READ_UINT32(ZY1000_JTAG_BASE+0x10, state);
92 bool powerDropout;
93 powerDropout = (state & 0x80) != 0;
94 return powerDropout;
98 static bool readSRST(void)
100 cyg_uint32 state;
101 // sample and clear SRST sensing
102 HAL_WRITE_UINT32(ZY1000_JTAG_BASE+0x10, 0x00000040);
103 HAL_READ_UINT32(ZY1000_JTAG_BASE+0x10, state);
104 bool srstAsserted;
105 srstAsserted = (state & 0x40) != 0;
106 return srstAsserted;
109 static int zy1000_srst_asserted(int *srst_asserted)
111 *srst_asserted=readSRST();
112 return ERROR_OK;
115 static int zy1000_power_dropout(int *dropout)
117 *dropout=readPowerDropout();
118 return ERROR_OK;
122 jtag_interface_t zy1000_interface =
124 .name = "ZY1000",
125 .execute_queue = bitbang_execute_queue,
126 .speed = zy1000_speed,
127 .register_commands = zy1000_register_commands,
128 .init = zy1000_init,
129 .quit = zy1000_quit,
130 .khz = zy1000_khz,
131 .speed_div = zy1000_speed_div,
132 .power_dropout = zy1000_power_dropout,
133 .srst_asserted = zy1000_srst_asserted,
136 bitbang_interface_t zy1000_bitbang =
138 .read = zy1000_read,
139 .write = zy1000_write,
140 .reset = zy1000_reset
145 static void zy1000_write(int tck, int tms, int tdi)
150 int zy1000_read(void)
152 return -1;
155 extern bool readSRST(void);
157 void zy1000_reset(int trst, int srst)
159 LOG_DEBUG("zy1000 trst=%d, srst=%d", trst, srst);
160 if(!srst)
162 ZY1000_POKE(ZY1000_JTAG_BASE+0x14, 0x00000001);
164 else
166 /* Danger!!! if clk!=0 when in
167 * idle in TAP_IDLE, reset halt on str912 will fail.
169 ZY1000_POKE(ZY1000_JTAG_BASE+0x10, 0x00000001);
172 if(!trst)
174 ZY1000_POKE(ZY1000_JTAG_BASE+0x14, 0x00000002);
176 else
178 /* assert reset */
179 ZY1000_POKE(ZY1000_JTAG_BASE+0x10, 0x00000002);
182 if (trst||(srst&&(jtag_reset_config & RESET_SRST_PULLS_TRST)))
184 waitIdle();
185 /* we're now in the RESET state until trst is deasserted */
186 ZY1000_POKE(ZY1000_JTAG_BASE+0x20, TAP_RESET);
187 } else
189 /* We'll get RCLK failure when we assert TRST, so clear any false positives here */
190 ZY1000_POKE(ZY1000_JTAG_BASE+0x14, 0x400);
193 /* wait for srst to float back up */
194 if (!srst)
196 int i;
197 for (i=0; i<1000; i++)
199 // We don't want to sense our own reset, so we clear here.
200 // There is of course a timing hole where we could loose
201 // a "real" reset.
202 if (!readSRST())
203 break;
205 /* wait 1ms */
206 alive_sleep(1);
209 if (i==1000)
211 LOG_USER("SRST didn't deassert after %dms", i);
212 } else if (i>1)
214 LOG_USER("SRST took %dms to deassert", i);
219 int zy1000_speed(int speed)
221 if(speed == 0)
223 /*0 means RCLK*/
224 speed = 0;
225 ZY1000_POKE(ZY1000_JTAG_BASE+0x10, 0x100);
226 LOG_DEBUG("jtag_speed using RCLK");
228 else
230 if(speed > 8190 || speed < 2)
232 LOG_USER("valid ZY1000 jtag_speed=[8190,2]. Divisor is 64MHz / even values between 8190-2, i.e. min 7814Hz, max 32MHz");
233 return ERROR_INVALID_ARGUMENTS;
236 LOG_USER("jtag_speed %d => JTAG clk=%f", speed, 64.0/(float)speed);
237 ZY1000_POKE(ZY1000_JTAG_BASE+0x14, 0x100);
238 ZY1000_POKE(ZY1000_JTAG_BASE+0x1c, speed&~1);
240 return ERROR_OK;
243 static bool savePower;
246 static void setPower(bool power)
248 savePower = power;
249 if (power)
251 HAL_WRITE_UINT32(ZY1000_JTAG_BASE+0x14, 0x8);
252 } else
254 HAL_WRITE_UINT32(ZY1000_JTAG_BASE+0x10, 0x8);
258 int handle_power_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)
260 if (argc > 1)
262 return ERROR_INVALID_ARGUMENTS;
265 if (argc == 1)
267 if (strcmp(args[0], "on") == 0)
269 setPower(1);
271 else if (strcmp(args[0], "off") == 0)
273 setPower(0);
274 } else
276 command_print(cmd_ctx, "arg is \"on\" or \"off\"");
277 return ERROR_INVALID_ARGUMENTS;
281 command_print(cmd_ctx, "Target power %s", savePower ? "on" : "off");
283 return ERROR_OK;
287 /* Give TELNET a way to find out what version this is */
288 int handle_zy1000_version_command(struct command_context_s *cmd_ctx, char *cmd,
289 char **args, int argc)
291 if (argc > 1)
293 return ERROR_COMMAND_SYNTAX_ERROR;
295 if (argc == 0)
297 command_print(cmd_ctx, ZYLIN_OPENOCD_VERSION);
299 else if (strcmp("openocd", args[0]) == 0)
301 int revision;
302 revision = atol(ZYLIN_OPENOCD+strlen("XRevision: "));
303 command_print(cmd_ctx, "%d", revision);
305 else if (strcmp("zy1000", args[0]) == 0)
307 command_print(cmd_ctx, "%s", ZYLIN_VERSION);
309 else if (strcmp("date", args[0]) == 0)
311 command_print(cmd_ctx, "%s", ZYLIN_DATE);
313 else
315 return ERROR_COMMAND_SYNTAX_ERROR;
318 return ERROR_OK;
322 static int
323 zylinjtag_Jim_Command_powerstatus(Jim_Interp *interp,
324 int argc,
325 Jim_Obj * const *argv)
327 if (argc != 1)
329 Jim_WrongNumArgs(interp, 1, argv, "powerstatus");
330 return JIM_ERR;
333 cyg_uint32 status;
334 ZY1000_PEEK(ZY1000_JTAG_BASE+0x10, status);
336 Jim_SetResult(interp, Jim_NewIntObj(interp, (status&0x80)!=0));
338 return JIM_OK;
341 int zy1000_register_commands(struct command_context_s *cmd_ctx)
343 register_command(cmd_ctx, NULL, "power", handle_power_command, COMMAND_ANY,
344 "power <on/off> - turn power switch to target on/off. No arguments - print status.");
345 register_command(cmd_ctx, NULL, "zy1000_version", handle_zy1000_version_command,
346 COMMAND_EXEC, "show zy1000 version numbers");
348 Jim_CreateCommand(interp, "powerstatus", zylinjtag_Jim_Command_powerstatus, NULL, NULL);
350 return ERROR_OK;
356 int zy1000_init(void)
358 LOG_USER("%s", ZYLIN_OPENOCD_VERSION);
360 ZY1000_POKE(ZY1000_JTAG_BASE+0x10, 0x30); // Turn on LED1 & LED2
362 setPower(true); // on by default
365 /* deassert resets. Important to avoid infinite loop waiting for SRST to deassert */
366 zy1000_reset(0, 0);
367 zy1000_speed(jtag_speed);
369 bitbang_interface = &zy1000_bitbang;
371 return ERROR_OK;
374 int zy1000_quit(void)
377 return ERROR_OK;
383 int interface_jtag_execute_queue(void)
385 cyg_uint32 empty;
387 waitIdle();
388 ZY1000_PEEK(ZY1000_JTAG_BASE+0x10, empty);
389 /* clear JTAG error register */
390 ZY1000_POKE(ZY1000_JTAG_BASE+0x14, 0x400);
392 if ((empty&0x400)!=0)
394 LOG_WARNING("RCLK timeout");
395 /* the error is informative only as we don't want to break the firmware if there
396 * is a false positive.
398 // return ERROR_FAIL;
400 return ERROR_OK;
407 static cyg_uint32 getShiftValue(void)
409 cyg_uint32 value;
410 waitIdle();
411 ZY1000_PEEK(ZY1000_JTAG_BASE+0xc, value);
412 VERBOSE(LOG_INFO("getShiftValue %08x", value));
413 return value;
415 #if 0
416 static cyg_uint32 getShiftValueFlip(void)
418 cyg_uint32 value;
419 waitIdle();
420 ZY1000_PEEK(ZY1000_JTAG_BASE+0x18, value);
421 VERBOSE(LOG_INFO("getShiftValue %08x (flipped)", value));
422 return value;
424 #endif
426 #if 0
427 static void shiftValueInnerFlip(const enum tap_state state, const enum tap_state endState, int repeat, cyg_uint32 value)
429 VERBOSE(LOG_INFO("shiftValueInner %s %s %d %08x (flipped)", jtag_state_name(state), jtag_state_name(endState), repeat, value));
430 cyg_uint32 a,b;
431 a=state;
432 b=endState;
433 ZY1000_POKE(ZY1000_JTAG_BASE+0xc, value);
434 ZY1000_POKE(ZY1000_JTAG_BASE+0x8, (1<<15)|(repeat<<8)|(a<<4)|b);
435 VERBOSE(getShiftValueFlip());
437 #endif
439 extern int jtag_check_value(u8 *captured, void *priv);
441 static void gotoEndState(void)
443 setCurrentState(cmd_queue_end_state);
446 static __inline void scanFields(int num_fields, scan_field_t *fields, enum tap_state shiftState, int pause)
448 int i;
449 int j;
450 int k;
452 for (i = 0; i < num_fields; i++)
454 cyg_uint32 value;
456 static u8 *in_buff=NULL; /* pointer to buffer for scanned data */
457 static int in_buff_size=0;
458 u8 *inBuffer=NULL;
461 // figure out where to store the input data
462 int num_bits=fields[i].num_bits;
463 if (fields[i].in_value!=NULL)
465 inBuffer=fields[i].in_value;
466 } else if (fields[i].in_handler!=NULL)
468 if (in_buff_size*8<num_bits)
470 // we need more space
471 if (in_buff!=NULL)
472 free(in_buff);
473 in_buff=NULL;
474 in_buff_size=(num_bits+7)/8;
475 in_buff=malloc(in_buff_size);
476 if (in_buff==NULL)
478 LOG_ERROR("Out of memory");
479 jtag_error=ERROR_JTAG_QUEUE_FAILED;
480 return;
483 inBuffer=in_buff;
486 // here we shuffle N bits out/in
487 j=0;
488 while (j<num_bits)
490 enum tap_state pause_state;
491 int l;
492 k=num_bits-j;
493 pause_state=(shiftState==TAP_DRSHIFT)?TAP_DRSHIFT:TAP_IRSHIFT;
494 if (k>32)
496 k=32;
497 /* we have more to shift out */
498 } else if (pause&&(i == num_fields-1))
500 /* this was the last to shift out this time */
501 pause_state=(shiftState==TAP_DRSHIFT)?TAP_DRPAUSE:TAP_IRPAUSE;
504 // we have (num_bits+7)/8 bytes of bits to toggle out.
505 // bits are pushed out LSB to MSB
506 value=0;
507 if (fields[i].out_value!=NULL)
509 for (l=0; l<k; l+=8)
511 value|=fields[i].out_value[(j+l)/8]<<l;
514 /* mask away unused bits for easier debugging */
515 value&=~(((u32)0xffffffff)<<k);
517 shiftValueInner(shiftState, pause_state, k, value);
519 if (inBuffer!=NULL)
521 // data in, LSB to MSB
522 value=getShiftValue();
523 // we're shifting in data to MSB, shift data to be aligned for returning the value
524 value >>= 32-k;
526 for (l=0; l<k; l+=8)
528 inBuffer[(j+l)/8]=(value>>l)&0xff;
531 j+=k;
534 if (fields[i].in_handler!=NULL)
536 // invoke callback
537 int r=fields[i].in_handler(inBuffer, fields[i].in_handler_priv, fields+i);
538 if (r!=ERROR_OK)
540 /* this will cause jtag_execute_queue() to return an error */
541 jtag_error=r;
547 int interface_jtag_add_end_state(enum tap_state state)
549 return ERROR_OK;
553 int interface_jtag_add_ir_scan(int num_fields, scan_field_t *fields, enum tap_state state)
556 int j;
557 int scan_size = 0;
558 jtag_tap_t *tap, *nextTap;
559 for(tap = jtag_NextEnabledTap(NULL); tap!= NULL; tap=nextTap)
561 nextTap=jtag_NextEnabledTap(tap);
562 int pause=(nextTap==NULL);
564 int found = 0;
566 scan_size = tap->ir_length;
568 /* search the list */
569 for (j=0; j < num_fields; j++)
571 if (tap == fields[j].tap)
573 found = 1;
575 if ((jtag_verify_capture_ir)&&(fields[j].in_handler==NULL))
577 jtag_set_check_value(fields+j, tap->expected, tap->expected_mask, NULL);
578 } else if (jtag_verify_capture_ir)
580 fields[j].in_check_value = tap->expected;
581 fields[j].in_check_mask = tap->expected_mask;
584 scanFields(1, fields+j, TAP_IRSHIFT, pause);
585 /* update device information */
586 buf_cpy(fields[j].out_value, tap->cur_instr, scan_size);
588 tap->bypass = 0;
589 break;
593 if (!found)
595 /* if a device isn't listed, set it to BYPASS */
596 u8 ones[]={0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff};
598 scan_field_t tmp;
599 memset(&tmp, 0, sizeof(tmp));
600 tmp.out_value = ones;
601 tmp.num_bits = scan_size;
602 scanFields(1, &tmp, TAP_IRSHIFT, pause);
603 /* update device information */
604 buf_cpy(tmp.out_value, tap->cur_instr, scan_size);
605 tap->bypass = 1;
608 gotoEndState();
610 return ERROR_OK;
617 int interface_jtag_add_plain_ir_scan(int num_fields, scan_field_t *fields, enum tap_state state)
619 scanFields(num_fields, fields, TAP_IRSHIFT, 1);
620 gotoEndState();
622 return ERROR_OK;
625 /*extern jtag_command_t **jtag_get_last_command_p(void);*/
627 int interface_jtag_add_dr_scan(int num_fields, scan_field_t *fields, enum tap_state state)
630 int j;
631 jtag_tap_t *tap, *nextTap;
632 for(tap = jtag_NextEnabledTap(NULL); tap!= NULL; tap=nextTap)
634 nextTap=jtag_NextEnabledTap(tap);
635 int found=0;
636 int pause=(nextTap==NULL);
638 for (j=0; j < num_fields; j++)
640 if (tap == fields[j].tap)
642 found = 1;
644 scanFields(1, fields+j, TAP_DRSHIFT, pause);
647 if (!found)
649 scan_field_t tmp;
650 /* program the scan field to 1 bit length, and ignore it's value */
651 tmp.num_bits = 1;
652 tmp.out_value = NULL;
653 tmp.out_mask = NULL;
654 tmp.in_value = NULL;
655 tmp.in_check_value = NULL;
656 tmp.in_check_mask = NULL;
657 tmp.in_handler = NULL;
658 tmp.in_handler_priv = NULL;
660 scanFields(1, &tmp, TAP_DRSHIFT, pause);
662 else
666 gotoEndState();
667 return ERROR_OK;
670 int interface_jtag_add_plain_dr_scan(int num_fields, scan_field_t *fields, enum tap_state state)
672 scanFields(num_fields, fields, TAP_DRSHIFT, 1);
673 gotoEndState();
674 return ERROR_OK;
678 int interface_jtag_add_tlr()
680 setCurrentState(TAP_RESET);
681 return ERROR_OK;
687 extern int jtag_nsrst_delay;
688 extern int jtag_ntrst_delay;
690 int interface_jtag_add_reset(int req_trst, int req_srst)
692 zy1000_reset(req_trst, req_srst);
693 return ERROR_OK;
696 static int zy1000_jtag_add_clocks(int num_cycles, enum tap_state state, enum tap_state clockstate)
698 /* num_cycles can be 0 */
699 setCurrentState(clockstate);
701 /* execute num_cycles, 32 at the time. */
702 int i;
703 for (i=0; i<num_cycles; i+=32)
705 int num;
706 num=32;
707 if (num_cycles-i<num)
709 num=num_cycles-i;
711 shiftValueInner(clockstate, clockstate, num, 0);
714 #if !TEST_MANUAL()
715 /* finish in end_state */
716 setCurrentState(state);
717 #else
718 enum tap_state t=TAP_IDLE;
719 /* test manual drive code on any target */
720 int tms;
721 u8 tms_scan = TAP_MOVE(t, state);
723 for (i = 0; i < 7; i++)
725 tms = (tms_scan >> i) & 1;
726 waitIdle();
727 ZY1000_POKE(ZY1000_JTAG_BASE+0x28, tms);
729 waitIdle();
730 ZY1000_POKE(ZY1000_JTAG_BASE+0x20, state);
731 #endif
734 return ERROR_OK;
737 int interface_jtag_add_runtest(int num_cycles, enum tap_state state)
739 return zy1000_jtag_add_clocks(num_cycles, state, TAP_IDLE);
742 int interface_jtag_add_clocks(int num_cycles)
744 return zy1000_jtag_add_clocks(num_cycles, cmd_queue_cur_state, cmd_queue_end_state);
747 int interface_jtag_add_sleep(u32 us)
749 jtag_sleep(us);
750 return ERROR_OK;
753 int interface_jtag_add_pathmove(int num_states, enum tap_state *path)
755 int state_count;
756 int tms = 0;
758 /*wait for the fifo to be empty*/
759 waitIdle();
761 state_count = 0;
763 enum tap_state cur_state=cmd_queue_cur_state;
765 while (num_states)
767 if (tap_transitions[cur_state].low == path[state_count])
769 tms = 0;
771 else if (tap_transitions[cur_state].high == path[state_count])
773 tms = 1;
775 else
777 LOG_ERROR("BUG: %s -> %s isn't a valid TAP transition", jtag_state_name(cur_state), jtag_state_name(path[state_count]));
778 exit(-1);
781 waitIdle();
782 ZY1000_POKE(ZY1000_JTAG_BASE+0x28, tms);
784 cur_state = path[state_count];
785 state_count++;
786 num_states--;
789 waitIdle();
790 ZY1000_POKE(ZY1000_JTAG_BASE+0x20, cur_state);
791 return ERROR_OK;
796 void embeddedice_write_dcc(jtag_tap_t *tap, int reg_addr, u8 *buffer, int little, int count)
798 // static int const reg_addr=0x5;
799 enum tap_state end_state=cmd_queue_end_state;
800 if (jtag_NextEnabledTap(jtag_NextEnabledTap(NULL))==NULL)
802 /* better performance via code duplication */
803 if (little)
805 int i;
806 for (i = 0; i < count; i++)
808 shiftValueInner(TAP_DRSHIFT, TAP_DRSHIFT, 32, fast_target_buffer_get_u32(buffer, 1));
809 shiftValueInner(TAP_DRSHIFT, end_state, 6, reg_addr|(1<<5));
810 buffer+=4;
812 } else
814 int i;
815 for (i = 0; i < count; i++)
817 shiftValueInner(TAP_DRSHIFT, TAP_DRSHIFT, 32, fast_target_buffer_get_u32(buffer, 0));
818 shiftValueInner(TAP_DRSHIFT, end_state, 6, reg_addr|(1<<5));
819 buffer+=4;
823 else
825 int i;
826 for (i = 0; i < count; i++)
828 embeddedice_write_reg_inner(tap, reg_addr, fast_target_buffer_get_u32(buffer, little));
829 buffer += 4;
834 int loadFile(const char *fileName, void **data, int *len);
836 /* boolean parameter stored on config */
837 int boolParam(char *var)
839 bool result = false;
840 char *name = alloc_printf("%s/%s", zylin_config_dir, var);
841 if (name == NULL)
842 return result;
844 void *data;
845 int len;
846 if (loadFile(name, &data, &len) == ERROR_OK)
848 if (len > 1)
849 len = 1;
850 result = strncmp((char *) data, "1", len) == 0;
851 free(data);
853 free(name);
854 return result;