/* * Copyright (C) 2020 Gwenhael Goavec-Merou * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #include #include #include #include #include #include #include #include "display.hpp" #include "jtag.hpp" #include "ftdipp_mpsse.hpp" #include "ftdiJtagBitbang.hpp" #include "ftdiJtagMPSSE.hpp" #include "dirtyJtag.hpp" using namespace std; #define DEBUG 0 #ifdef DEBUG #define display(...) \ do { if (_verbose) fprintf(stdout, __VA_ARGS__);}while(0) #else #define display(...) do {}while(0) #endif /* * AD0 -> TCK * AD1 -> TDI * AD2 -> TD0 * AD3 -> TMS */ /* Rmq: * pour TMS: l'envoi de n necessite de mettre n-1 comme longueur * mais le bit n+1 est utilise pour l'etat suivant le dernier * front. Donc il faut envoyer 6bits ([5:0]) pertinents pour * utiliser le bit 6 comme etat apres la commande, * le bit 7 corresponds a l'etat de TDI (donc si on fait 7 cycles * l'etat de TDI va donner l'etat de TMS...) * transfert/lecture: le dernier bit de IR ou DR doit etre envoye en * meme temps que le TMS qui fait sortir de l'etat donc il faut * pour n bits a transferer : * - envoyer 8bits * (n/8)-1 * - envoyer les 7 bits du dernier octet; * - envoyer le dernier avec 0x4B ou 0x6B */ Jtag::Jtag(cable_t &cable, const jtag_pins_conf_t *pin_conf, string dev, uint32_t clkHZ, bool verbose): _verbose(verbose), _state(RUN_TEST_IDLE), _tms_buffer_size(128), _num_tms(0), _board_name("nope") { init_internal(cable, dev, pin_conf, clkHZ); } Jtag::Jtag(cable_t &cable, const jtag_pins_conf_t *pin_conf, uint32_t clkHZ, bool verbose): _verbose(verbose), _state(RUN_TEST_IDLE), _tms_buffer_size(128), _num_tms(0), _board_name("nope") { init_internal(cable, "", pin_conf, clkHZ); } Jtag::~Jtag() { free(_tms_buffer); delete _jtag; } void Jtag::init_internal(cable_t &cable, const string &dev, const jtag_pins_conf_t *pin_conf, uint32_t clkHZ) { switch (cable.type) { case MODE_FTDI_BITBANG: if (pin_conf == NULL) throw std::exception(); _jtag = new FtdiJtagBitBang(cable.config, pin_conf, dev, clkHZ, _verbose); break; case MODE_FTDI_SERIAL: _jtag = new FtdiJtagMPSSE(cable.config, dev, clkHZ, _verbose); break; case MODE_DIRTYJTAG: _jtag = new DirtyJtag(clkHZ, _verbose); break; default: std::cerr << "Jtag: unknown cable type" << std::endl; throw std::exception(); } _tms_buffer = (unsigned char *)malloc(sizeof(unsigned char) * _tms_buffer_size); bzero(_tms_buffer, _tms_buffer_size); } int Jtag::detectChain(vector &devices, int max_dev) { unsigned char rx_buff[4]; /* WA for CH552/tangNano: write is always mandatory */ unsigned char tx_buff[4] = {0xff, 0xff, 0xff, 0xff}; unsigned int tmp; devices.clear(); go_test_logic_reset(); set_state(SHIFT_DR); for (int i = 0; i < max_dev; i++) { read_write(tx_buff, rx_buff, 32, (i == max_dev-1)?1:0); tmp = 0; for (int ii=0; ii < 4; ii++) tmp |= (rx_buff[ii] << (8*ii)); if (tmp != 0 && tmp != 0xffffffff) devices.push_back(tmp); } go_test_logic_reset(); return devices.size(); } void Jtag::setTMS(unsigned char tms) { display("%s %x %d %d\n", __func__, tms, _num_tms, (_num_tms >> 3)); if (_num_tms+1 == _tms_buffer_size * 8) flushTMS(); if (tms != 0) _tms_buffer[_num_tms>>3] |= (0x1) << (_num_tms & 0x7); _num_tms++; } /* reconstruct byte sent to TMS pins * - use up to 6 bits * -since next bit after length is use to * fix TMS state after sent we copy last bit * to bit after next * -bit 7 is TDI state for each clk cycles */ int Jtag::flushTMS(bool flush_buffer) { int ret = 0; if (_num_tms != 0) { display("%s: %d %x\n", __func__, _num_tms, _tms_buffer[0]); ret = _jtag->writeTMS(_tms_buffer, _num_tms, flush_buffer); /* reset buffer and number of bits */ bzero(_tms_buffer, _tms_buffer_size); _num_tms = 0; } else if (flush_buffer) { _jtag->flush(); } return ret; } void Jtag::go_test_logic_reset() { /* idenpendly to current state 5 clk with TMS high is enough */ for (int i = 0; i < 6; i++) setTMS(0x01); flushTMS(true); _state = TEST_LOGIC_RESET; } int Jtag::read_write(unsigned char *tdi, unsigned char *tdo, int len, char last) { flushTMS(true); _jtag->writeTDI(tdi, tdo, len, last); if (last == 1) _state = (_state == SHIFT_DR) ? EXIT1_DR : EXIT1_IR; return 0; } void Jtag::toggleClk(int nb) { unsigned char c = (TEST_LOGIC_RESET == _state) ? 1 : 0; flushTMS(true); if (_jtag->toggleClk(c, 0, nb) >= 0) return; throw std::exception(); return; } int Jtag::shiftDR(unsigned char *tdi, unsigned char *tdo, int drlen, int end_state) { set_state(SHIFT_DR); // force transmit tms state flushTMS(true); // currently don't care about multiple device in the chain read_write(tdi, tdo, drlen, 1);// 1 since only one device set_state(end_state); return 0; } int Jtag::shiftIR(unsigned char tdi, int irlen, int end_state) { if (irlen > 8) { cerr << "Error: this method this direct char don't support more than 1 byte" << endl; return -1; } return shiftIR(&tdi, NULL, irlen, end_state); } int Jtag::shiftIR(unsigned char *tdi, unsigned char *tdo, int irlen, int end_state) { display("%s: avant shiftIR\n", __func__); set_state(SHIFT_IR); flushTMS(true); // currently don't care about multiple device in the chain display("%s: envoi ircode\n", __func__); read_write(tdi, tdo, irlen, 1); // 1 since only one device set_state(end_state); return 0; } void Jtag::set_state(int newState) { unsigned char tms; while (newState != _state) { display("_state : %16s(%02d) -> %s(%02d) ", getStateName((tapState_t)_state), _state, getStateName((tapState_t)newState), newState); switch (_state) { case TEST_LOGIC_RESET: if (newState == TEST_LOGIC_RESET) { tms = 1; } else { tms = 0; _state = RUN_TEST_IDLE; } break; case RUN_TEST_IDLE: if (newState == RUN_TEST_IDLE) { tms = 0; } else { tms = 1; _state = SELECT_DR_SCAN; } break; case SELECT_DR_SCAN: switch (newState) { case CAPTURE_DR: case SHIFT_DR: case EXIT1_DR: case PAUSE_DR: case EXIT2_DR: case UPDATE_DR: tms = 0; _state = CAPTURE_DR; break; default: tms = 1; _state = SELECT_IR_SCAN; } break; case SELECT_IR_SCAN: switch (newState) { case CAPTURE_IR: case SHIFT_IR: case EXIT1_IR: case PAUSE_IR: case EXIT2_IR: case UPDATE_IR: tms = 0; _state = CAPTURE_IR; break; default: tms = 1; _state = TEST_LOGIC_RESET; } break; /* DR column */ case CAPTURE_DR: if (newState == SHIFT_DR) { tms = 0; _state = SHIFT_DR; } else { tms = 1; _state = EXIT1_DR; } break; case SHIFT_DR: if (newState == SHIFT_DR) { tms = 0; } else { tms = 1; _state = EXIT1_DR; } break; case EXIT1_DR: switch (newState) { case PAUSE_DR: case EXIT2_DR: case SHIFT_DR: case EXIT1_DR: tms = 0; _state = PAUSE_DR; break; default: tms = 1; _state = UPDATE_DR; } break; case PAUSE_DR: if (newState == PAUSE_DR) { tms = 0; } else { tms = 1; _state = EXIT2_DR; } break; case EXIT2_DR: switch (newState) { case SHIFT_DR: case EXIT1_DR: case PAUSE_DR: tms = 0; _state = SHIFT_DR; break; default: tms = 1; _state = UPDATE_DR; } break; case UPDATE_DR: if (newState == RUN_TEST_IDLE) { tms = 0; _state = RUN_TEST_IDLE; } else { tms = 1; _state = SELECT_DR_SCAN; } break; /* IR column */ case CAPTURE_IR: if (newState == SHIFT_IR) { tms = 0; _state = SHIFT_IR; } else { tms = 1; _state = EXIT1_IR; } break; case SHIFT_IR: if (newState == SHIFT_IR) { tms = 0; } else { tms = 1; _state = EXIT1_IR; } break; case EXIT1_IR: switch (newState) { case PAUSE_IR: case EXIT2_IR: case SHIFT_IR: case EXIT1_IR: tms = 0; _state = PAUSE_IR; break; default: tms = 1; _state = UPDATE_IR; } break; case PAUSE_IR: if (newState == PAUSE_IR) { tms = 0; } else { tms = 1; _state = EXIT2_IR; } break; case EXIT2_IR: switch (newState) { case SHIFT_IR: case EXIT1_IR: case PAUSE_IR: tms = 0; _state = SHIFT_IR; break; default: tms = 1; _state = UPDATE_IR; } break; case UPDATE_IR: if (newState == RUN_TEST_IDLE) { tms = 0; _state = RUN_TEST_IDLE; } else { tms = 1; _state = SELECT_DR_SCAN; } break; } setTMS(tms); display("%d %d %d %x\n", tms, _num_tms-1, _state, _tms_buffer[(_num_tms-1) / 8]); } /* force write buffer */ flushTMS(); } const char *Jtag::getStateName(tapState_t s) { switch (s) { case TEST_LOGIC_RESET: return "TEST_LOGIC_RESET"; case RUN_TEST_IDLE: return "RUN_TEST_IDLE"; case SELECT_DR_SCAN: return "SELECT_DR_SCAN"; case CAPTURE_DR: return "CAPTURE_DR"; case SHIFT_DR: return "SHIFT_DR"; case EXIT1_DR: return "EXIT1_DR"; case PAUSE_DR: return "PAUSE_DR"; case EXIT2_DR: return "EXIT2_DR"; case UPDATE_DR: return "UPDATE_DR"; case SELECT_IR_SCAN: return "SELECT_IR_SCAN"; case CAPTURE_IR: return "CAPTURE_IR"; case SHIFT_IR: return "SHIFT_IR"; case EXIT1_IR: return "EXIT1_IR"; case PAUSE_IR: return "PAUSE_IR"; case EXIT2_IR: return "EXIT2_IR"; case UPDATE_IR: return "UPDATE_IR"; default: return "Unknown"; } }