DAP.c 52 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816
  1. /*
  2. * Copyright (c) 2013-2022 ARM Limited. All rights reserved.
  3. *
  4. * SPDX-License-Identifier: Apache-2.0
  5. *
  6. * Licensed under the Apache License, Version 2.0 (the License); you may
  7. * not use this file except in compliance with the License.
  8. * You may obtain a copy of the License at
  9. *
  10. * www.apache.org/licenses/LICENSE-2.0
  11. *
  12. * Unless required by applicable law or agreed to in writing, software
  13. * distributed under the License is distributed on an AS IS BASIS, WITHOUT
  14. * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15. * See the License for the specific language governing permissions and
  16. * limitations under the License.
  17. *
  18. * ----------------------------------------------------------------------
  19. *
  20. * $Date: 5. December 2022
  21. * $Revision: V2.1.2
  22. *
  23. * Project: CMSIS-DAP Source
  24. * Title: DAP.c CMSIS-DAP Commands
  25. *
  26. *---------------------------------------------------------------------------*/
  27. #include <string.h>
  28. #include "DAP_config.h"
  29. #include "DAP.h"
  30. #if (DAP_PACKET_SIZE < 64U)
  31. #error "Minimum Packet Size is 64!"
  32. #endif
  33. #if (DAP_PACKET_SIZE > 32768U)
  34. #error "Maximum Packet Size is 32768!"
  35. #endif
  36. #if (DAP_PACKET_COUNT < 1U)
  37. #error "Minimum Packet Count is 1!"
  38. #endif
  39. #if (DAP_PACKET_COUNT > 255U)
  40. #error "Maximum Packet Count is 255!"
  41. #endif
  42. // Clock Macros
  43. #define MAX_SWJ_CLOCK(delay_cycles) \
  44. ((CPU_CLOCK/2U) / (IO_PORT_WRITE_CYCLES + delay_cycles))
  45. DAP_Data_t DAP_Data; // DAP Data
  46. volatile uint8_t DAP_TransferAbort; // Transfer Abort Flag
  47. static const char DAP_FW_Ver [] = DAP_FW_VER;
  48. // Common clock delay calculation routine
  49. // clock: requested SWJ frequency in Hertz
  50. static void Set_Clock_Delay(uint32_t clock) {
  51. uint32_t delay;
  52. if (clock >= MAX_SWJ_CLOCK(DELAY_FAST_CYCLES)) {
  53. DAP_Data.fast_clock = 1U;
  54. DAP_Data.clock_delay = 1U;
  55. } else {
  56. DAP_Data.fast_clock = 0U;
  57. delay = ((CPU_CLOCK/2U) + (clock - 1U)) / clock;
  58. if (delay > IO_PORT_WRITE_CYCLES) {
  59. delay -= IO_PORT_WRITE_CYCLES;
  60. delay = (delay + (DELAY_SLOW_CYCLES - 1U)) / DELAY_SLOW_CYCLES;
  61. } else {
  62. delay = 1U;
  63. }
  64. DAP_Data.clock_delay = delay;
  65. }
  66. }
  67. // Get DAP Information
  68. // id: info identifier
  69. // info: pointer to info data
  70. // return: number of bytes in info data
  71. static uint8_t DAP_Info(uint8_t id, uint8_t *info) {
  72. uint8_t length = 0U;
  73. switch (id) {
  74. case DAP_ID_VENDOR:
  75. length = DAP_GetVendorString((char *)info);
  76. break;
  77. case DAP_ID_PRODUCT:
  78. length = DAP_GetProductString((char *)info);
  79. break;
  80. case DAP_ID_SER_NUM:
  81. length = DAP_GetSerNumString((char *)info);
  82. break;
  83. case DAP_ID_DAP_FW_VER:
  84. length = (uint8_t)sizeof(DAP_FW_Ver);
  85. memcpy(info, DAP_FW_Ver, length);
  86. break;
  87. case DAP_ID_DEVICE_VENDOR:
  88. length = DAP_GetTargetDeviceVendorString((char *)info);
  89. break;
  90. case DAP_ID_DEVICE_NAME:
  91. length = DAP_GetTargetDeviceNameString((char *)info);
  92. break;
  93. case DAP_ID_BOARD_VENDOR:
  94. length = DAP_GetTargetBoardVendorString((char *)info);
  95. break;
  96. case DAP_ID_BOARD_NAME:
  97. length = DAP_GetTargetBoardNameString((char *)info);
  98. break;
  99. case DAP_ID_PRODUCT_FW_VER:
  100. length = DAP_GetProductFirmwareVersionString((char *)info);
  101. break;
  102. case DAP_ID_CAPABILITIES:
  103. info[0] = ((DAP_SWD != 0) ? (1U << 0) : 0U) |
  104. ((DAP_JTAG != 0) ? (1U << 1) : 0U) |
  105. ((SWO_UART != 0) ? (1U << 2) : 0U) |
  106. ((SWO_MANCHESTER != 0) ? (1U << 3) : 0U) |
  107. /* Atomic Commands */ (1U << 4) |
  108. ((TIMESTAMP_CLOCK != 0U) ? (1U << 5) : 0U) |
  109. ((SWO_STREAM != 0U) ? (1U << 6) : 0U) |
  110. ((DAP_UART != 0U) ? (1U << 7) : 0U);
  111. info[1] = ((DAP_UART_USB_COM_PORT != 0) ? (1U << 0) : 0U);
  112. length = 2U;
  113. break;
  114. case DAP_ID_TIMESTAMP_CLOCK:
  115. #if (TIMESTAMP_CLOCK != 0U)
  116. info[0] = (uint8_t)(TIMESTAMP_CLOCK >> 0);
  117. info[1] = (uint8_t)(TIMESTAMP_CLOCK >> 8);
  118. info[2] = (uint8_t)(TIMESTAMP_CLOCK >> 16);
  119. info[3] = (uint8_t)(TIMESTAMP_CLOCK >> 24);
  120. length = 4U;
  121. #endif
  122. break;
  123. case DAP_ID_UART_RX_BUFFER_SIZE:
  124. #if (DAP_UART != 0)
  125. info[0] = (uint8_t)(DAP_UART_RX_BUFFER_SIZE >> 0);
  126. info[1] = (uint8_t)(DAP_UART_RX_BUFFER_SIZE >> 8);
  127. info[2] = (uint8_t)(DAP_UART_RX_BUFFER_SIZE >> 16);
  128. info[3] = (uint8_t)(DAP_UART_RX_BUFFER_SIZE >> 24);
  129. length = 4U;
  130. #endif
  131. break;
  132. case DAP_ID_UART_TX_BUFFER_SIZE:
  133. #if (DAP_UART != 0)
  134. info[0] = (uint8_t)(DAP_UART_TX_BUFFER_SIZE >> 0);
  135. info[1] = (uint8_t)(DAP_UART_TX_BUFFER_SIZE >> 8);
  136. info[2] = (uint8_t)(DAP_UART_TX_BUFFER_SIZE >> 16);
  137. info[3] = (uint8_t)(DAP_UART_TX_BUFFER_SIZE >> 24);
  138. length = 4U;
  139. #endif
  140. break;
  141. case DAP_ID_SWO_BUFFER_SIZE:
  142. #if ((SWO_UART != 0) || (SWO_MANCHESTER != 0))
  143. info[0] = (uint8_t)(SWO_BUFFER_SIZE >> 0);
  144. info[1] = (uint8_t)(SWO_BUFFER_SIZE >> 8);
  145. info[2] = (uint8_t)(SWO_BUFFER_SIZE >> 16);
  146. info[3] = (uint8_t)(SWO_BUFFER_SIZE >> 24);
  147. length = 4U;
  148. #endif
  149. break;
  150. case DAP_ID_PACKET_SIZE:
  151. info[0] = (uint8_t)(DAP_PACKET_SIZE >> 0);
  152. info[1] = (uint8_t)(DAP_PACKET_SIZE >> 8);
  153. length = 2U;
  154. break;
  155. case DAP_ID_PACKET_COUNT:
  156. info[0] = DAP_PACKET_COUNT;
  157. length = 1U;
  158. break;
  159. default:
  160. break;
  161. }
  162. return (length);
  163. }
  164. // Delay for specified time
  165. // delay: delay time in ms
  166. void Delayms(uint32_t delay) {
  167. delay *= ((CPU_CLOCK/1000U) + (DELAY_SLOW_CYCLES-1U)) / DELAY_SLOW_CYCLES;
  168. PIN_DELAY_SLOW(delay);
  169. }
  170. // Process Delay command and prepare response
  171. // request: pointer to request data
  172. // response: pointer to response data
  173. // return: number of bytes in response (lower 16 bits)
  174. // number of bytes in request (upper 16 bits)
  175. static uint32_t DAP_Delay(const uint8_t *request, uint8_t *response) {
  176. uint32_t delay;
  177. delay = (uint32_t)(*(request+0)) |
  178. (uint32_t)(*(request+1) << 8);
  179. delay *= ((CPU_CLOCK/1000000U) + (DELAY_SLOW_CYCLES-1U)) / DELAY_SLOW_CYCLES;
  180. PIN_DELAY_SLOW(delay);
  181. *response = DAP_OK;
  182. return ((2U << 16) | 1U);
  183. }
  184. // Process Host Status command and prepare response
  185. // request: pointer to request data
  186. // response: pointer to response data
  187. // return: number of bytes in response (lower 16 bits)
  188. // number of bytes in request (upper 16 bits)
  189. static uint32_t DAP_HostStatus(const uint8_t *request, uint8_t *response) {
  190. switch (*request) {
  191. case DAP_DEBUGGER_CONNECTED:
  192. LED_CONNECTED_OUT((*(request+1) & 1U));
  193. break;
  194. case DAP_TARGET_RUNNING:
  195. LED_RUNNING_OUT((*(request+1) & 1U));
  196. break;
  197. default:
  198. *response = DAP_ERROR;
  199. return ((2U << 16) | 1U);
  200. }
  201. *response = DAP_OK;
  202. return ((2U << 16) | 1U);
  203. }
  204. // Process Connect command and prepare response
  205. // request: pointer to request data
  206. // response: pointer to response data
  207. // return: number of bytes in response (lower 16 bits)
  208. // number of bytes in request (upper 16 bits)
  209. static uint32_t DAP_Connect(const uint8_t *request, uint8_t *response) {
  210. uint32_t port;
  211. if (*request == DAP_PORT_AUTODETECT) {
  212. port = DAP_DEFAULT_PORT;
  213. } else {
  214. port = *request;
  215. }
  216. switch (port) {
  217. #if (DAP_SWD != 0)
  218. case DAP_PORT_SWD:
  219. DAP_Data.debug_port = DAP_PORT_SWD;
  220. PORT_SWD_SETUP();
  221. break;
  222. #endif
  223. #if (DAP_JTAG != 0)
  224. case DAP_PORT_JTAG:
  225. DAP_Data.debug_port = DAP_PORT_JTAG;
  226. PORT_JTAG_SETUP();
  227. break;
  228. #endif
  229. default:
  230. port = DAP_PORT_DISABLED;
  231. break;
  232. }
  233. *response = (uint8_t)port;
  234. return ((1U << 16) | 1U);
  235. }
  236. // Process Disconnect command and prepare response
  237. // response: pointer to response data
  238. // return: number of bytes in response
  239. static uint32_t DAP_Disconnect(uint8_t *response) {
  240. DAP_Data.debug_port = DAP_PORT_DISABLED;
  241. PORT_OFF();
  242. *response = DAP_OK;
  243. return (1U);
  244. }
  245. // Process Reset Target command and prepare response
  246. // response: pointer to response data
  247. // return: number of bytes in response
  248. static uint32_t DAP_ResetTarget(uint8_t *response) {
  249. *(response+1) = RESET_TARGET();
  250. *(response+0) = DAP_OK;
  251. return (2U);
  252. }
  253. // Process SWJ Pins command and prepare response
  254. // request: pointer to request data
  255. // response: pointer to response data
  256. // return: number of bytes in response (lower 16 bits)
  257. // number of bytes in request (upper 16 bits)
  258. static uint32_t DAP_SWJ_Pins(const uint8_t *request, uint8_t *response) {
  259. #if ((DAP_SWD != 0) || (DAP_JTAG != 0))
  260. uint32_t value;
  261. uint32_t select;
  262. uint32_t wait;
  263. uint32_t timestamp;
  264. value = (uint32_t) *(request+0);
  265. select = (uint32_t) *(request+1);
  266. wait = (uint32_t)(*(request+2) << 0) |
  267. (uint32_t)(*(request+3) << 8) |
  268. (uint32_t)(*(request+4) << 16) |
  269. (uint32_t)(*(request+5) << 24);
  270. if ((select & (1U << DAP_SWJ_SWCLK_TCK)) != 0U) {
  271. if ((value & (1U << DAP_SWJ_SWCLK_TCK)) != 0U) {
  272. PIN_SWCLK_TCK_SET();
  273. } else {
  274. PIN_SWCLK_TCK_CLR();
  275. }
  276. }
  277. if ((select & (1U << DAP_SWJ_SWDIO_TMS)) != 0U) {
  278. if ((value & (1U << DAP_SWJ_SWDIO_TMS)) != 0U) {
  279. PIN_SWDIO_TMS_SET();
  280. } else {
  281. PIN_SWDIO_TMS_CLR();
  282. }
  283. }
  284. if ((select & (1U << DAP_SWJ_TDI)) != 0U) {
  285. PIN_TDI_OUT(value >> DAP_SWJ_TDI);
  286. }
  287. if ((select & (1U << DAP_SWJ_nTRST)) != 0U) {
  288. PIN_nTRST_OUT(value >> DAP_SWJ_nTRST);
  289. }
  290. if ((select & (1U << DAP_SWJ_nRESET)) != 0U){
  291. PIN_nRESET_OUT(value >> DAP_SWJ_nRESET);
  292. }
  293. if (wait != 0U) {
  294. #if (TIMESTAMP_CLOCK != 0U)
  295. if (wait > 3000000U) {
  296. wait = 3000000U;
  297. }
  298. #if (TIMESTAMP_CLOCK >= 1000000U)
  299. wait *= TIMESTAMP_CLOCK / 1000000U;
  300. #else
  301. wait /= 1000000U / TIMESTAMP_CLOCK;
  302. #endif
  303. #else
  304. wait = 1U;
  305. #endif
  306. timestamp = TIMESTAMP_GET();
  307. do {
  308. if ((select & (1U << DAP_SWJ_SWCLK_TCK)) != 0U) {
  309. if ((value >> DAP_SWJ_SWCLK_TCK) ^ PIN_SWCLK_TCK_IN()) {
  310. continue;
  311. }
  312. }
  313. if ((select & (1U << DAP_SWJ_SWDIO_TMS)) != 0U) {
  314. if ((value >> DAP_SWJ_SWDIO_TMS) ^ PIN_SWDIO_TMS_IN()) {
  315. continue;
  316. }
  317. }
  318. if ((select & (1U << DAP_SWJ_TDI)) != 0U) {
  319. if ((value >> DAP_SWJ_TDI) ^ PIN_TDI_IN()) {
  320. continue;
  321. }
  322. }
  323. if ((select & (1U << DAP_SWJ_nTRST)) != 0U) {
  324. if ((value >> DAP_SWJ_nTRST) ^ PIN_nTRST_IN()) {
  325. continue;
  326. }
  327. }
  328. if ((select & (1U << DAP_SWJ_nRESET)) != 0U) {
  329. if ((value >> DAP_SWJ_nRESET) ^ PIN_nRESET_IN()) {
  330. continue;
  331. }
  332. }
  333. break;
  334. } while ((TIMESTAMP_GET() - timestamp) < wait);
  335. }
  336. value = (PIN_SWCLK_TCK_IN() << DAP_SWJ_SWCLK_TCK) |
  337. (PIN_SWDIO_TMS_IN() << DAP_SWJ_SWDIO_TMS) |
  338. (PIN_TDI_IN() << DAP_SWJ_TDI) |
  339. (PIN_TDO_IN() << DAP_SWJ_TDO) |
  340. (PIN_nTRST_IN() << DAP_SWJ_nTRST) |
  341. (PIN_nRESET_IN() << DAP_SWJ_nRESET);
  342. *response = (uint8_t)value;
  343. #else
  344. *response = 0U;
  345. #endif
  346. return ((6U << 16) | 1U);
  347. }
  348. // Process SWJ Clock command and prepare response
  349. // request: pointer to request data
  350. // response: pointer to response data
  351. // return: number of bytes in response (lower 16 bits)
  352. // number of bytes in request (upper 16 bits)
  353. static uint32_t DAP_SWJ_Clock(const uint8_t *request, uint8_t *response) {
  354. #if ((DAP_SWD != 0) || (DAP_JTAG != 0))
  355. uint32_t clock;
  356. uint32_t delay;
  357. clock = (uint32_t)(*(request+0) << 0) |
  358. (uint32_t)(*(request+1) << 8) |
  359. (uint32_t)(*(request+2) << 16) |
  360. (uint32_t)(*(request+3) << 24);
  361. if (clock == 0U) {
  362. *response = DAP_ERROR;
  363. return ((4U << 16) | 1U);
  364. }
  365. Set_Clock_Delay(clock);
  366. *response = DAP_OK;
  367. #else
  368. *response = DAP_ERROR;
  369. #endif
  370. return ((4U << 16) | 1U);
  371. }
  372. // Process SWJ Sequence command and prepare response
  373. // request: pointer to request data
  374. // response: pointer to response data
  375. // return: number of bytes in response (lower 16 bits)
  376. // number of bytes in request (upper 16 bits)
  377. static uint32_t DAP_SWJ_Sequence(const uint8_t *request, uint8_t *response) {
  378. uint32_t count;
  379. count = *request++;
  380. if (count == 0U) {
  381. count = 256U;
  382. }
  383. #if ((DAP_SWD != 0) || (DAP_JTAG != 0))
  384. SWJ_Sequence(count, request);
  385. *response = DAP_OK;
  386. #else
  387. *response = DAP_ERROR;
  388. #endif
  389. count = (count + 7U) >> 3;
  390. return (((count + 1U) << 16) | 1U);
  391. }
  392. // Process SWD Configure command and prepare response
  393. // request: pointer to request data
  394. // response: pointer to response data
  395. // return: number of bytes in response (lower 16 bits)
  396. // number of bytes in request (upper 16 bits)
  397. static uint32_t DAP_SWD_Configure(const uint8_t *request, uint8_t *response) {
  398. #if (DAP_SWD != 0)
  399. uint8_t value;
  400. value = *request;
  401. DAP_Data.swd_conf.turnaround = (value & 0x03U) + 1U;
  402. DAP_Data.swd_conf.data_phase = (value & 0x04U) ? 1U : 0U;
  403. *response = DAP_OK;
  404. #else
  405. *response = DAP_ERROR;
  406. #endif
  407. return ((1U << 16) | 1U);
  408. }
  409. // Process SWD Sequence command and prepare response
  410. // request: pointer to request data
  411. // response: pointer to response data
  412. // return: number of bytes in response (lower 16 bits)
  413. // number of bytes in request (upper 16 bits)
  414. static uint32_t DAP_SWD_Sequence(const uint8_t *request, uint8_t *response) {
  415. uint32_t sequence_info;
  416. uint32_t sequence_count;
  417. uint32_t request_count;
  418. uint32_t response_count;
  419. uint32_t count;
  420. #if (DAP_SWD != 0)
  421. *response++ = DAP_OK;
  422. #else
  423. *response++ = DAP_ERROR;
  424. #endif
  425. request_count = 1U;
  426. response_count = 1U;
  427. sequence_count = *request++;
  428. while (sequence_count--) {
  429. sequence_info = *request++;
  430. count = sequence_info & SWD_SEQUENCE_CLK;
  431. if (count == 0U) {
  432. count = 64U;
  433. }
  434. count = (count + 7U) / 8U;
  435. #if (DAP_SWD != 0)
  436. if ((sequence_info & SWD_SEQUENCE_DIN) != 0U) {
  437. PIN_SWDIO_OUT_DISABLE();
  438. } else {
  439. PIN_SWDIO_OUT_ENABLE();
  440. }
  441. SWD_Sequence(sequence_info, request, response);
  442. if (sequence_count == 0U) {
  443. PIN_SWDIO_OUT_ENABLE();
  444. }
  445. #endif
  446. if ((sequence_info & SWD_SEQUENCE_DIN) != 0U) {
  447. request_count++;
  448. #if (DAP_SWD != 0)
  449. response += count;
  450. response_count += count;
  451. #endif
  452. } else {
  453. request += count;
  454. request_count += count + 1U;
  455. }
  456. }
  457. return ((request_count << 16) | response_count);
  458. }
  459. // Process JTAG Sequence command and prepare response
  460. // request: pointer to request data
  461. // response: pointer to response data
  462. // return: number of bytes in response (lower 16 bits)
  463. // number of bytes in request (upper 16 bits)
  464. static uint32_t DAP_JTAG_Sequence(const uint8_t *request, uint8_t *response) {
  465. uint32_t sequence_info;
  466. uint32_t sequence_count;
  467. uint32_t request_count;
  468. uint32_t response_count;
  469. uint32_t count;
  470. #if (DAP_JTAG != 0)
  471. *response++ = DAP_OK;
  472. #else
  473. *response++ = DAP_ERROR;
  474. #endif
  475. request_count = 1U;
  476. response_count = 1U;
  477. sequence_count = *request++;
  478. while (sequence_count--) {
  479. sequence_info = *request++;
  480. count = sequence_info & JTAG_SEQUENCE_TCK;
  481. if (count == 0U) {
  482. count = 64U;
  483. }
  484. count = (count + 7U) / 8U;
  485. #if (DAP_JTAG != 0)
  486. JTAG_Sequence(sequence_info, request, response);
  487. #endif
  488. request += count;
  489. request_count += count + 1U;
  490. #if (DAP_JTAG != 0)
  491. if ((sequence_info & JTAG_SEQUENCE_TDO) != 0U) {
  492. response += count;
  493. response_count += count;
  494. }
  495. #endif
  496. }
  497. return ((request_count << 16) | response_count);
  498. }
  499. // Process JTAG Configure command and prepare response
  500. // request: pointer to request data
  501. // response: pointer to response data
  502. // return: number of bytes in response (lower 16 bits)
  503. // number of bytes in request (upper 16 bits)
  504. static uint32_t DAP_JTAG_Configure(const uint8_t *request, uint8_t *response) {
  505. uint32_t count;
  506. #if (DAP_JTAG != 0)
  507. uint32_t length;
  508. uint32_t bits;
  509. uint32_t n;
  510. count = *request++;
  511. DAP_Data.jtag_dev.count = (uint8_t)count;
  512. bits = 0U;
  513. for (n = 0U; n < count; n++) {
  514. length = *request++;
  515. DAP_Data.jtag_dev.ir_length[n] = (uint8_t)length;
  516. DAP_Data.jtag_dev.ir_before[n] = (uint16_t)bits;
  517. bits += length;
  518. }
  519. for (n = 0U; n < count; n++) {
  520. bits -= DAP_Data.jtag_dev.ir_length[n];
  521. DAP_Data.jtag_dev.ir_after[n] = (uint16_t)bits;
  522. }
  523. *response = DAP_OK;
  524. #else
  525. count = *request;
  526. *response = DAP_ERROR;
  527. #endif
  528. return (((count + 1U) << 16) | 1U);
  529. }
  530. // Process JTAG IDCODE command and prepare response
  531. // request: pointer to request data
  532. // response: pointer to response data
  533. // return: number of bytes in response (lower 16 bits)
  534. // number of bytes in request (upper 16 bits)
  535. static uint32_t DAP_JTAG_IDCode(const uint8_t *request, uint8_t *response) {
  536. #if (DAP_JTAG != 0)
  537. uint32_t data;
  538. if (DAP_Data.debug_port != DAP_PORT_JTAG) {
  539. goto id_error;
  540. }
  541. // Device index (JTAP TAP)
  542. DAP_Data.jtag_dev.index = *request;
  543. if (DAP_Data.jtag_dev.index >= DAP_Data.jtag_dev.count) {
  544. goto id_error;
  545. }
  546. // Select JTAG chain
  547. JTAG_IR(JTAG_IDCODE);
  548. // Read IDCODE register
  549. data = JTAG_ReadIDCode();
  550. // Store Data
  551. *(response+0) = DAP_OK;
  552. *(response+1) = (uint8_t)(data >> 0);
  553. *(response+2) = (uint8_t)(data >> 8);
  554. *(response+3) = (uint8_t)(data >> 16);
  555. *(response+4) = (uint8_t)(data >> 24);
  556. return ((1U << 16) | 5U);
  557. id_error:
  558. #endif
  559. *response = DAP_ERROR;
  560. return ((1U << 16) | 1U);
  561. }
  562. // Process Transfer Configure command and prepare response
  563. // request: pointer to request data
  564. // response: pointer to response data
  565. // return: number of bytes in response (lower 16 bits)
  566. // number of bytes in request (upper 16 bits)
  567. static uint32_t DAP_TransferConfigure(const uint8_t *request, uint8_t *response) {
  568. DAP_Data.transfer.idle_cycles = *(request+0);
  569. DAP_Data.transfer.retry_count = (uint16_t) *(request+1) |
  570. (uint16_t)(*(request+2) << 8);
  571. DAP_Data.transfer.match_retry = (uint16_t) *(request+3) |
  572. (uint16_t)(*(request+4) << 8);
  573. *response = DAP_OK;
  574. return ((5U << 16) | 1U);
  575. }
  576. // Process SWD Transfer command and prepare response
  577. // request: pointer to request data
  578. // response: pointer to response data
  579. // return: number of bytes in response (lower 16 bits)
  580. // number of bytes in request (upper 16 bits)
  581. #if (DAP_SWD != 0)
  582. static uint32_t DAP_SWD_Transfer(const uint8_t *request, uint8_t *response) {
  583. const
  584. uint8_t *request_head;
  585. uint32_t request_count;
  586. uint32_t request_value;
  587. uint8_t *response_head;
  588. uint32_t response_count;
  589. uint32_t response_value;
  590. uint32_t post_read;
  591. uint32_t check_write;
  592. uint32_t match_value;
  593. uint32_t match_retry;
  594. uint32_t retry;
  595. uint32_t data;
  596. #if (TIMESTAMP_CLOCK != 0U)
  597. uint32_t timestamp;
  598. #endif
  599. request_head = request;
  600. response_count = 0U;
  601. response_value = 0U;
  602. response_head = response;
  603. response += 2;
  604. DAP_TransferAbort = 0U;
  605. post_read = 0U;
  606. check_write = 0U;
  607. request++; // Ignore DAP index
  608. request_count = *request++;
  609. while (request_count != 0) {
  610. request_count--;
  611. request_value = *request++;
  612. if ((request_value & DAP_TRANSFER_RnW) != 0U) {
  613. // Read register
  614. if (post_read) {
  615. // Read was posted before
  616. retry = DAP_Data.transfer.retry_count;
  617. if ((request_value & (DAP_TRANSFER_APnDP | DAP_TRANSFER_MATCH_VALUE)) == DAP_TRANSFER_APnDP) {
  618. // Read previous AP data and post next AP read
  619. do {
  620. response_value = SWD_Transfer(request_value, &data);
  621. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  622. } else {
  623. // Read previous AP data
  624. do {
  625. response_value = SWD_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, &data);
  626. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  627. post_read = 0U;
  628. }
  629. if (response_value != DAP_TRANSFER_OK) {
  630. break;
  631. }
  632. // Store previous AP data
  633. *response++ = (uint8_t) data;
  634. *response++ = (uint8_t)(data >> 8);
  635. *response++ = (uint8_t)(data >> 16);
  636. *response++ = (uint8_t)(data >> 24);
  637. #if (TIMESTAMP_CLOCK != 0U)
  638. if (post_read) {
  639. // Store Timestamp of next AP read
  640. if ((request_value & DAP_TRANSFER_TIMESTAMP) != 0U) {
  641. timestamp = DAP_Data.timestamp;
  642. *response++ = (uint8_t) timestamp;
  643. *response++ = (uint8_t)(timestamp >> 8);
  644. *response++ = (uint8_t)(timestamp >> 16);
  645. *response++ = (uint8_t)(timestamp >> 24);
  646. }
  647. }
  648. #endif
  649. }
  650. if ((request_value & DAP_TRANSFER_MATCH_VALUE) != 0U) {
  651. // Read with value match
  652. match_value = (uint32_t)(*(request+0) << 0) |
  653. (uint32_t)(*(request+1) << 8) |
  654. (uint32_t)(*(request+2) << 16) |
  655. (uint32_t)(*(request+3) << 24);
  656. request += 4;
  657. match_retry = DAP_Data.transfer.match_retry;
  658. if ((request_value & DAP_TRANSFER_APnDP) != 0U) {
  659. // Post AP read
  660. retry = DAP_Data.transfer.retry_count;
  661. do {
  662. response_value = SWD_Transfer(request_value, NULL);
  663. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  664. if (response_value != DAP_TRANSFER_OK) {
  665. break;
  666. }
  667. }
  668. do {
  669. // Read register until its value matches or retry counter expires
  670. retry = DAP_Data.transfer.retry_count;
  671. do {
  672. response_value = SWD_Transfer(request_value, &data);
  673. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  674. if (response_value != DAP_TRANSFER_OK) {
  675. break;
  676. }
  677. } while (((data & DAP_Data.transfer.match_mask) != match_value) && match_retry-- && !DAP_TransferAbort);
  678. if ((data & DAP_Data.transfer.match_mask) != match_value) {
  679. response_value |= DAP_TRANSFER_MISMATCH;
  680. }
  681. if (response_value != DAP_TRANSFER_OK) {
  682. break;
  683. }
  684. } else {
  685. // Normal read
  686. retry = DAP_Data.transfer.retry_count;
  687. if ((request_value & DAP_TRANSFER_APnDP) != 0U) {
  688. // Read AP register
  689. if (post_read == 0U) {
  690. // Post AP read
  691. do {
  692. response_value = SWD_Transfer(request_value, NULL);
  693. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  694. if (response_value != DAP_TRANSFER_OK) {
  695. break;
  696. }
  697. #if (TIMESTAMP_CLOCK != 0U)
  698. // Store Timestamp
  699. if ((request_value & DAP_TRANSFER_TIMESTAMP) != 0U) {
  700. timestamp = DAP_Data.timestamp;
  701. *response++ = (uint8_t) timestamp;
  702. *response++ = (uint8_t)(timestamp >> 8);
  703. *response++ = (uint8_t)(timestamp >> 16);
  704. *response++ = (uint8_t)(timestamp >> 24);
  705. }
  706. #endif
  707. post_read = 1U;
  708. }
  709. } else {
  710. // Read DP register
  711. do {
  712. response_value = SWD_Transfer(request_value, &data);
  713. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  714. if (response_value != DAP_TRANSFER_OK) {
  715. break;
  716. }
  717. #if (TIMESTAMP_CLOCK != 0U)
  718. // Store Timestamp
  719. if ((request_value & DAP_TRANSFER_TIMESTAMP) != 0U) {
  720. timestamp = DAP_Data.timestamp;
  721. *response++ = (uint8_t) timestamp;
  722. *response++ = (uint8_t)(timestamp >> 8);
  723. *response++ = (uint8_t)(timestamp >> 16);
  724. *response++ = (uint8_t)(timestamp >> 24);
  725. }
  726. #endif
  727. // Store data
  728. *response++ = (uint8_t) data;
  729. *response++ = (uint8_t)(data >> 8);
  730. *response++ = (uint8_t)(data >> 16);
  731. *response++ = (uint8_t)(data >> 24);
  732. }
  733. }
  734. check_write = 0U;
  735. } else {
  736. // Write register
  737. if (post_read) {
  738. // Read previous data
  739. retry = DAP_Data.transfer.retry_count;
  740. do {
  741. response_value = SWD_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, &data);
  742. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  743. if (response_value != DAP_TRANSFER_OK) {
  744. break;
  745. }
  746. // Store previous data
  747. *response++ = (uint8_t) data;
  748. *response++ = (uint8_t)(data >> 8);
  749. *response++ = (uint8_t)(data >> 16);
  750. *response++ = (uint8_t)(data >> 24);
  751. post_read = 0U;
  752. }
  753. // Load data
  754. data = (uint32_t)(*(request+0) << 0) |
  755. (uint32_t)(*(request+1) << 8) |
  756. (uint32_t)(*(request+2) << 16) |
  757. (uint32_t)(*(request+3) << 24);
  758. request += 4;
  759. if ((request_value & DAP_TRANSFER_MATCH_MASK) != 0U) {
  760. // Write match mask
  761. DAP_Data.transfer.match_mask = data;
  762. response_value = DAP_TRANSFER_OK;
  763. } else {
  764. // Write DP/AP register
  765. retry = DAP_Data.transfer.retry_count;
  766. do {
  767. response_value = SWD_Transfer(request_value, &data);
  768. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  769. if (response_value != DAP_TRANSFER_OK) {
  770. break;
  771. }
  772. #if (TIMESTAMP_CLOCK != 0U)
  773. // Store Timestamp
  774. if ((request_value & DAP_TRANSFER_TIMESTAMP) != 0U) {
  775. timestamp = DAP_Data.timestamp;
  776. *response++ = (uint8_t) timestamp;
  777. *response++ = (uint8_t)(timestamp >> 8);
  778. *response++ = (uint8_t)(timestamp >> 16);
  779. *response++ = (uint8_t)(timestamp >> 24);
  780. }
  781. #endif
  782. check_write = 1U;
  783. }
  784. }
  785. response_count++;
  786. if (DAP_TransferAbort) {
  787. break;
  788. }
  789. }
  790. while (request_count != 0) {
  791. // Process canceled requests
  792. request_count--;
  793. request_value = *request++;
  794. if ((request_value & DAP_TRANSFER_RnW) != 0U) {
  795. // Read register
  796. if ((request_value & DAP_TRANSFER_MATCH_VALUE) != 0U) {
  797. // Read with value match
  798. request += 4;
  799. }
  800. } else {
  801. // Write register
  802. request += 4;
  803. }
  804. }
  805. if (response_value == DAP_TRANSFER_OK) {
  806. if (post_read) {
  807. // Read previous data
  808. retry = DAP_Data.transfer.retry_count;
  809. do {
  810. response_value = SWD_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, &data);
  811. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  812. if (response_value != DAP_TRANSFER_OK) {
  813. goto end;
  814. }
  815. // Store previous data
  816. *response++ = (uint8_t) data;
  817. *response++ = (uint8_t)(data >> 8);
  818. *response++ = (uint8_t)(data >> 16);
  819. *response++ = (uint8_t)(data >> 24);
  820. } else if (check_write) {
  821. // Check last write
  822. retry = DAP_Data.transfer.retry_count;
  823. do {
  824. response_value = SWD_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, NULL);
  825. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  826. }
  827. }
  828. end:
  829. *(response_head+0) = (uint8_t)response_count;
  830. *(response_head+1) = (uint8_t)response_value;
  831. return (((uint32_t)(request - request_head) << 16) | (uint32_t)(response - response_head));
  832. }
  833. #endif
  834. // Process JTAG Transfer command and prepare response
  835. // request: pointer to request data
  836. // response: pointer to response data
  837. // return: number of bytes in response (lower 16 bits)
  838. // number of bytes in request (upper 16 bits)
  839. #if (DAP_JTAG != 0)
  840. static uint32_t DAP_JTAG_Transfer(const uint8_t *request, uint8_t *response) {
  841. const
  842. uint8_t *request_head;
  843. uint32_t request_count;
  844. uint32_t request_value;
  845. uint32_t request_ir;
  846. uint8_t *response_head;
  847. uint32_t response_count;
  848. uint32_t response_value;
  849. uint32_t post_read;
  850. uint32_t match_value;
  851. uint32_t match_retry;
  852. uint32_t retry;
  853. uint32_t data;
  854. uint32_t ir;
  855. #if (TIMESTAMP_CLOCK != 0U)
  856. uint32_t timestamp;
  857. #endif
  858. request_head = request;
  859. response_count = 0U;
  860. response_value = 0U;
  861. response_head = response;
  862. response += 2;
  863. DAP_TransferAbort = 0U;
  864. ir = 0U;
  865. post_read = 0U;
  866. // Device index (JTAP TAP)
  867. DAP_Data.jtag_dev.index = *request++;
  868. if (DAP_Data.jtag_dev.index >= DAP_Data.jtag_dev.count) {
  869. goto end;
  870. }
  871. request_count = *request++;
  872. while (request_count != 0) {
  873. request_count--;
  874. request_value = *request++;
  875. request_ir = (request_value & DAP_TRANSFER_APnDP) ? JTAG_APACC : JTAG_DPACC;
  876. if ((request_value & DAP_TRANSFER_RnW) != 0U) {
  877. // Read register
  878. if (post_read) {
  879. // Read was posted before
  880. retry = DAP_Data.transfer.retry_count;
  881. if ((ir == request_ir) && ((request_value & DAP_TRANSFER_MATCH_VALUE) == 0U)) {
  882. // Read previous data and post next read
  883. do {
  884. response_value = JTAG_Transfer(request_value, &data);
  885. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  886. } else {
  887. // Select JTAG chain
  888. if (ir != JTAG_DPACC) {
  889. ir = JTAG_DPACC;
  890. JTAG_IR(ir);
  891. }
  892. // Read previous data
  893. do {
  894. response_value = JTAG_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, &data);
  895. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  896. post_read = 0U;
  897. }
  898. if (response_value != DAP_TRANSFER_OK) {
  899. break;
  900. }
  901. // Store previous data
  902. *response++ = (uint8_t) data;
  903. *response++ = (uint8_t)(data >> 8);
  904. *response++ = (uint8_t)(data >> 16);
  905. *response++ = (uint8_t)(data >> 24);
  906. #if (TIMESTAMP_CLOCK != 0U)
  907. if (post_read) {
  908. // Store Timestamp of next AP read
  909. if ((request_value & DAP_TRANSFER_TIMESTAMP) != 0U) {
  910. timestamp = DAP_Data.timestamp;
  911. *response++ = (uint8_t) timestamp;
  912. *response++ = (uint8_t)(timestamp >> 8);
  913. *response++ = (uint8_t)(timestamp >> 16);
  914. *response++ = (uint8_t)(timestamp >> 24);
  915. }
  916. }
  917. #endif
  918. }
  919. if ((request_value & DAP_TRANSFER_MATCH_VALUE) != 0U) {
  920. // Read with value match
  921. match_value = (uint32_t)(*(request+0) << 0) |
  922. (uint32_t)(*(request+1) << 8) |
  923. (uint32_t)(*(request+2) << 16) |
  924. (uint32_t)(*(request+3) << 24);
  925. request += 4;
  926. match_retry = DAP_Data.transfer.match_retry;
  927. // Select JTAG chain
  928. if (ir != request_ir) {
  929. ir = request_ir;
  930. JTAG_IR(ir);
  931. }
  932. // Post DP/AP read
  933. retry = DAP_Data.transfer.retry_count;
  934. do {
  935. response_value = JTAG_Transfer(request_value, NULL);
  936. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  937. if (response_value != DAP_TRANSFER_OK) {
  938. break;
  939. }
  940. do {
  941. // Read register until its value matches or retry counter expires
  942. retry = DAP_Data.transfer.retry_count;
  943. do {
  944. response_value = JTAG_Transfer(request_value, &data);
  945. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  946. if (response_value != DAP_TRANSFER_OK) {
  947. break;
  948. }
  949. } while (((data & DAP_Data.transfer.match_mask) != match_value) && match_retry-- && !DAP_TransferAbort);
  950. if ((data & DAP_Data.transfer.match_mask) != match_value) {
  951. response_value |= DAP_TRANSFER_MISMATCH;
  952. }
  953. if (response_value != DAP_TRANSFER_OK) {
  954. break;
  955. }
  956. } else {
  957. // Normal read
  958. if (post_read == 0U) {
  959. // Select JTAG chain
  960. if (ir != request_ir) {
  961. ir = request_ir;
  962. JTAG_IR(ir);
  963. }
  964. // Post DP/AP read
  965. retry = DAP_Data.transfer.retry_count;
  966. do {
  967. response_value = JTAG_Transfer(request_value, NULL);
  968. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  969. if (response_value != DAP_TRANSFER_OK) {
  970. break;
  971. }
  972. #if (TIMESTAMP_CLOCK != 0U)
  973. // Store Timestamp
  974. if ((request_value & DAP_TRANSFER_TIMESTAMP) != 0U) {
  975. timestamp = DAP_Data.timestamp;
  976. *response++ = (uint8_t) timestamp;
  977. *response++ = (uint8_t)(timestamp >> 8);
  978. *response++ = (uint8_t)(timestamp >> 16);
  979. *response++ = (uint8_t)(timestamp >> 24);
  980. }
  981. #endif
  982. post_read = 1U;
  983. }
  984. }
  985. } else {
  986. // Write register
  987. if (post_read) {
  988. // Select JTAG chain
  989. if (ir != JTAG_DPACC) {
  990. ir = JTAG_DPACC;
  991. JTAG_IR(ir);
  992. }
  993. // Read previous data
  994. retry = DAP_Data.transfer.retry_count;
  995. do {
  996. response_value = JTAG_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, &data);
  997. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  998. if (response_value != DAP_TRANSFER_OK) {
  999. break;
  1000. }
  1001. // Store previous data
  1002. *response++ = (uint8_t) data;
  1003. *response++ = (uint8_t)(data >> 8);
  1004. *response++ = (uint8_t)(data >> 16);
  1005. *response++ = (uint8_t)(data >> 24);
  1006. post_read = 0U;
  1007. }
  1008. // Load data
  1009. data = (uint32_t)(*(request+0) << 0) |
  1010. (uint32_t)(*(request+1) << 8) |
  1011. (uint32_t)(*(request+2) << 16) |
  1012. (uint32_t)(*(request+3) << 24);
  1013. request += 4;
  1014. if ((request_value & DAP_TRANSFER_MATCH_MASK) != 0U) {
  1015. // Write match mask
  1016. DAP_Data.transfer.match_mask = data;
  1017. response_value = DAP_TRANSFER_OK;
  1018. } else {
  1019. // Select JTAG chain
  1020. if (ir != request_ir) {
  1021. ir = request_ir;
  1022. JTAG_IR(ir);
  1023. }
  1024. // Write DP/AP register
  1025. retry = DAP_Data.transfer.retry_count;
  1026. do {
  1027. response_value = JTAG_Transfer(request_value, &data);
  1028. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1029. if (response_value != DAP_TRANSFER_OK) {
  1030. break;
  1031. }
  1032. #if (TIMESTAMP_CLOCK != 0U)
  1033. // Store Timestamp
  1034. if ((request_value & DAP_TRANSFER_TIMESTAMP) != 0U) {
  1035. timestamp = DAP_Data.timestamp;
  1036. *response++ = (uint8_t) timestamp;
  1037. *response++ = (uint8_t)(timestamp >> 8);
  1038. *response++ = (uint8_t)(timestamp >> 16);
  1039. *response++ = (uint8_t)(timestamp >> 24);
  1040. }
  1041. #endif
  1042. }
  1043. }
  1044. response_count++;
  1045. if (DAP_TransferAbort) {
  1046. break;
  1047. }
  1048. }
  1049. while (request_count != 0) {
  1050. // Process canceled requests
  1051. request_count--;
  1052. request_value = *request++;
  1053. if ((request_value & DAP_TRANSFER_RnW) != 0U) {
  1054. // Read register
  1055. if ((request_value & DAP_TRANSFER_MATCH_VALUE) != 0U) {
  1056. // Read with value match
  1057. request += 4;
  1058. }
  1059. } else {
  1060. // Write register
  1061. request += 4;
  1062. }
  1063. }
  1064. if (response_value == DAP_TRANSFER_OK) {
  1065. // Select JTAG chain
  1066. if (ir != JTAG_DPACC) {
  1067. ir = JTAG_DPACC;
  1068. JTAG_IR(ir);
  1069. }
  1070. if (post_read) {
  1071. // Read previous data
  1072. retry = DAP_Data.transfer.retry_count;
  1073. do {
  1074. response_value = JTAG_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, &data);
  1075. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1076. if (response_value != DAP_TRANSFER_OK) {
  1077. goto end;
  1078. }
  1079. // Store previous data
  1080. *response++ = (uint8_t) data;
  1081. *response++ = (uint8_t)(data >> 8);
  1082. *response++ = (uint8_t)(data >> 16);
  1083. *response++ = (uint8_t)(data >> 24);
  1084. } else {
  1085. // Check last write
  1086. retry = DAP_Data.transfer.retry_count;
  1087. do {
  1088. response_value = JTAG_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, NULL);
  1089. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1090. }
  1091. }
  1092. end:
  1093. *(response_head+0) = (uint8_t)response_count;
  1094. *(response_head+1) = (uint8_t)response_value;
  1095. return (((uint32_t)(request - request_head) << 16) | (uint32_t)(response - response_head));
  1096. }
  1097. #endif
  1098. // Process Dummy Transfer command and prepare response
  1099. // request: pointer to request data
  1100. // response: pointer to response data
  1101. // return: number of bytes in response (lower 16 bits)
  1102. // number of bytes in request (upper 16 bits)
  1103. static uint32_t DAP_Dummy_Transfer(const uint8_t *request, uint8_t *response) {
  1104. const
  1105. uint8_t *request_head;
  1106. uint32_t request_count;
  1107. uint32_t request_value;
  1108. request_head = request;
  1109. request++; // Ignore DAP index
  1110. request_count = *request++;
  1111. for (; request_count != 0U; request_count--) {
  1112. // Process dummy requests
  1113. request_value = *request++;
  1114. if ((request_value & DAP_TRANSFER_RnW) != 0U) {
  1115. // Read register
  1116. if ((request_value & DAP_TRANSFER_MATCH_VALUE) != 0U) {
  1117. // Read with value match
  1118. request += 4;
  1119. }
  1120. } else {
  1121. // Write register
  1122. request += 4;
  1123. }
  1124. }
  1125. *(response+0) = 0U; // Response count
  1126. *(response+1) = 0U; // Response value
  1127. return (((uint32_t)(request - request_head) << 16) | 2U);
  1128. }
  1129. // Process Transfer command and prepare response
  1130. // request: pointer to request data
  1131. // response: pointer to response data
  1132. // return: number of bytes in response (lower 16 bits)
  1133. // number of bytes in request (upper 16 bits)
  1134. static uint32_t DAP_Transfer(const uint8_t *request, uint8_t *response) {
  1135. uint32_t num;
  1136. switch (DAP_Data.debug_port) {
  1137. #if (DAP_SWD != 0)
  1138. case DAP_PORT_SWD:
  1139. num = DAP_SWD_Transfer(request, response);
  1140. break;
  1141. #endif
  1142. #if (DAP_JTAG != 0)
  1143. case DAP_PORT_JTAG:
  1144. num = DAP_JTAG_Transfer(request, response);
  1145. break;
  1146. #endif
  1147. default:
  1148. num = DAP_Dummy_Transfer(request, response);
  1149. break;
  1150. }
  1151. return (num);
  1152. }
  1153. // Process SWD Transfer Block command and prepare response
  1154. // request: pointer to request data
  1155. // response: pointer to response data
  1156. // return: number of bytes in response
  1157. #if (DAP_SWD != 0)
  1158. static uint32_t DAP_SWD_TransferBlock(const uint8_t *request, uint8_t *response) {
  1159. uint32_t request_count;
  1160. uint32_t request_value;
  1161. uint32_t response_count;
  1162. uint32_t response_value;
  1163. uint8_t *response_head;
  1164. uint32_t retry;
  1165. uint32_t data;
  1166. response_count = 0U;
  1167. response_value = 0U;
  1168. response_head = response;
  1169. response += 3;
  1170. DAP_TransferAbort = 0U;
  1171. request++; // Ignore DAP index
  1172. request_count = (uint32_t)(*(request+0) << 0) |
  1173. (uint32_t)(*(request+1) << 8);
  1174. request += 2;
  1175. if (request_count == 0U) {
  1176. goto end;
  1177. }
  1178. request_value = *request++;
  1179. if ((request_value & DAP_TRANSFER_RnW) != 0U) {
  1180. // Read register block
  1181. if ((request_value & DAP_TRANSFER_APnDP) != 0U) {
  1182. // Post AP read
  1183. retry = DAP_Data.transfer.retry_count;
  1184. do {
  1185. response_value = SWD_Transfer(request_value, NULL);
  1186. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1187. if (response_value != DAP_TRANSFER_OK) {
  1188. goto end;
  1189. }
  1190. }
  1191. while (request_count--) {
  1192. // Read DP/AP register
  1193. if ((request_count == 0U) && ((request_value & DAP_TRANSFER_APnDP) != 0U)) {
  1194. // Last AP read
  1195. request_value = DP_RDBUFF | DAP_TRANSFER_RnW;
  1196. }
  1197. retry = DAP_Data.transfer.retry_count;
  1198. do {
  1199. response_value = SWD_Transfer(request_value, &data);
  1200. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1201. if (response_value != DAP_TRANSFER_OK) {
  1202. goto end;
  1203. }
  1204. // Store data
  1205. *response++ = (uint8_t) data;
  1206. *response++ = (uint8_t)(data >> 8);
  1207. *response++ = (uint8_t)(data >> 16);
  1208. *response++ = (uint8_t)(data >> 24);
  1209. response_count++;
  1210. }
  1211. } else {
  1212. // Write register block
  1213. while (request_count--) {
  1214. // Load data
  1215. data = (uint32_t)(*(request+0) << 0) |
  1216. (uint32_t)(*(request+1) << 8) |
  1217. (uint32_t)(*(request+2) << 16) |
  1218. (uint32_t)(*(request+3) << 24);
  1219. request += 4;
  1220. // Write DP/AP register
  1221. retry = DAP_Data.transfer.retry_count;
  1222. do {
  1223. response_value = SWD_Transfer(request_value, &data);
  1224. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1225. if (response_value != DAP_TRANSFER_OK) {
  1226. goto end;
  1227. }
  1228. response_count++;
  1229. }
  1230. // Check last write
  1231. retry = DAP_Data.transfer.retry_count;
  1232. do {
  1233. response_value = SWD_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, NULL);
  1234. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1235. }
  1236. end:
  1237. *(response_head+0) = (uint8_t)(response_count >> 0);
  1238. *(response_head+1) = (uint8_t)(response_count >> 8);
  1239. *(response_head+2) = (uint8_t) response_value;
  1240. return ((uint32_t)(response - response_head));
  1241. }
  1242. #endif
  1243. // Process JTAG Transfer Block command and prepare response
  1244. // request: pointer to request data
  1245. // response: pointer to response data
  1246. // return: number of bytes in response
  1247. #if (DAP_JTAG != 0)
  1248. static uint32_t DAP_JTAG_TransferBlock(const uint8_t *request, uint8_t *response) {
  1249. uint32_t request_count;
  1250. uint32_t request_value;
  1251. uint32_t response_count;
  1252. uint32_t response_value;
  1253. uint8_t *response_head;
  1254. uint32_t retry;
  1255. uint32_t data;
  1256. uint32_t ir;
  1257. response_count = 0U;
  1258. response_value = 0U;
  1259. response_head = response;
  1260. response += 3;
  1261. DAP_TransferAbort = 0U;
  1262. // Device index (JTAP TAP)
  1263. DAP_Data.jtag_dev.index = *request++;
  1264. if (DAP_Data.jtag_dev.index >= DAP_Data.jtag_dev.count) {
  1265. goto end;
  1266. }
  1267. request_count = (uint32_t)(*(request+0) << 0) |
  1268. (uint32_t)(*(request+1) << 8);
  1269. request += 2;
  1270. if (request_count == 0U) {
  1271. goto end;
  1272. }
  1273. request_value = *request++;
  1274. // Select JTAG chain
  1275. ir = (request_value & DAP_TRANSFER_APnDP) ? JTAG_APACC : JTAG_DPACC;
  1276. JTAG_IR(ir);
  1277. if ((request_value & DAP_TRANSFER_RnW) != 0U) {
  1278. // Post read
  1279. retry = DAP_Data.transfer.retry_count;
  1280. do {
  1281. response_value = JTAG_Transfer(request_value, NULL);
  1282. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1283. if (response_value != DAP_TRANSFER_OK) {
  1284. goto end;
  1285. }
  1286. // Read register block
  1287. while (request_count--) {
  1288. // Read DP/AP register
  1289. if (request_count == 0U) {
  1290. // Last read
  1291. if (ir != JTAG_DPACC) {
  1292. JTAG_IR(JTAG_DPACC);
  1293. }
  1294. request_value = DP_RDBUFF | DAP_TRANSFER_RnW;
  1295. }
  1296. retry = DAP_Data.transfer.retry_count;
  1297. do {
  1298. response_value = JTAG_Transfer(request_value, &data);
  1299. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1300. if (response_value != DAP_TRANSFER_OK) {
  1301. goto end;
  1302. }
  1303. // Store data
  1304. *response++ = (uint8_t) data;
  1305. *response++ = (uint8_t)(data >> 8);
  1306. *response++ = (uint8_t)(data >> 16);
  1307. *response++ = (uint8_t)(data >> 24);
  1308. response_count++;
  1309. }
  1310. } else {
  1311. // Write register block
  1312. while (request_count--) {
  1313. // Load data
  1314. data = (uint32_t)(*(request+0) << 0) |
  1315. (uint32_t)(*(request+1) << 8) |
  1316. (uint32_t)(*(request+2) << 16) |
  1317. (uint32_t)(*(request+3) << 24);
  1318. request += 4;
  1319. // Write DP/AP register
  1320. retry = DAP_Data.transfer.retry_count;
  1321. do {
  1322. response_value = JTAG_Transfer(request_value, &data);
  1323. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1324. if (response_value != DAP_TRANSFER_OK) {
  1325. goto end;
  1326. }
  1327. response_count++;
  1328. }
  1329. // Check last write
  1330. if (ir != JTAG_DPACC) {
  1331. JTAG_IR(JTAG_DPACC);
  1332. }
  1333. retry = DAP_Data.transfer.retry_count;
  1334. do {
  1335. response_value = JTAG_Transfer(DP_RDBUFF | DAP_TRANSFER_RnW, NULL);
  1336. } while ((response_value == DAP_TRANSFER_WAIT) && retry-- && !DAP_TransferAbort);
  1337. }
  1338. end:
  1339. *(response_head+0) = (uint8_t)(response_count >> 0);
  1340. *(response_head+1) = (uint8_t)(response_count >> 8);
  1341. *(response_head+2) = (uint8_t) response_value;
  1342. return ((uint32_t)(response - response_head));
  1343. }
  1344. #endif
  1345. // Process Transfer Block command and prepare response
  1346. // request: pointer to request data
  1347. // response: pointer to response data
  1348. // return: number of bytes in response (lower 16 bits)
  1349. // number of bytes in request (upper 16 bits)
  1350. static uint32_t DAP_TransferBlock(const uint8_t *request, uint8_t *response) {
  1351. uint32_t num;
  1352. switch (DAP_Data.debug_port) {
  1353. #if (DAP_SWD != 0)
  1354. case DAP_PORT_SWD:
  1355. num = DAP_SWD_TransferBlock (request, response);
  1356. break;
  1357. #endif
  1358. #if (DAP_JTAG != 0)
  1359. case DAP_PORT_JTAG:
  1360. num = DAP_JTAG_TransferBlock(request, response);
  1361. break;
  1362. #endif
  1363. default:
  1364. *(response+0) = 0U; // Response count [7:0]
  1365. *(response+1) = 0U; // Response count[15:8]
  1366. *(response+2) = 0U; // Response value
  1367. num = 3U;
  1368. break;
  1369. }
  1370. if ((*(request+3) & DAP_TRANSFER_RnW) != 0U) {
  1371. // Read register block
  1372. num |= 4U << 16;
  1373. } else {
  1374. // Write register block
  1375. num |= (4U + (((uint32_t)(*(request+1)) | (uint32_t)(*(request+2) << 8)) * 4)) << 16;
  1376. }
  1377. return (num);
  1378. }
  1379. // Process SWD Write ABORT command and prepare response
  1380. // request: pointer to request data
  1381. // response: pointer to response data
  1382. // return: number of bytes in response
  1383. #if (DAP_SWD != 0)
  1384. static uint32_t DAP_SWD_WriteAbort(const uint8_t *request, uint8_t *response) {
  1385. uint32_t data;
  1386. // Load data (Ignore DAP index)
  1387. data = (uint32_t)(*(request+1) << 0) |
  1388. (uint32_t)(*(request+2) << 8) |
  1389. (uint32_t)(*(request+3) << 16) |
  1390. (uint32_t)(*(request+4) << 24);
  1391. // Write Abort register
  1392. SWD_Transfer(DP_ABORT, &data);
  1393. *response = DAP_OK;
  1394. return (1U);
  1395. }
  1396. #endif
  1397. // Process JTAG Write ABORT command and prepare response
  1398. // request: pointer to request data
  1399. // response: pointer to response data
  1400. // return: number of bytes in response
  1401. #if (DAP_JTAG != 0)
  1402. static uint32_t DAP_JTAG_WriteAbort(const uint8_t *request, uint8_t *response) {
  1403. uint32_t data;
  1404. // Device index (JTAP TAP)
  1405. DAP_Data.jtag_dev.index = *request;
  1406. if (DAP_Data.jtag_dev.index >= DAP_Data.jtag_dev.count) {
  1407. *response = DAP_ERROR;
  1408. return (1U);
  1409. }
  1410. // Select JTAG chain
  1411. JTAG_IR(JTAG_ABORT);
  1412. // Load data
  1413. data = (uint32_t)(*(request+1) << 0) |
  1414. (uint32_t)(*(request+2) << 8) |
  1415. (uint32_t)(*(request+3) << 16) |
  1416. (uint32_t)(*(request+4) << 24);
  1417. // Write Abort register
  1418. JTAG_WriteAbort(data);
  1419. *response = DAP_OK;
  1420. return (1U);
  1421. }
  1422. #endif
  1423. // Process Write ABORT command and prepare response
  1424. // request: pointer to request data
  1425. // response: pointer to response data
  1426. // return: number of bytes in response (lower 16 bits)
  1427. // number of bytes in request (upper 16 bits)
  1428. static uint32_t DAP_WriteAbort(const uint8_t *request, uint8_t *response) {
  1429. uint32_t num;
  1430. switch (DAP_Data.debug_port) {
  1431. #if (DAP_SWD != 0)
  1432. case DAP_PORT_SWD:
  1433. num = DAP_SWD_WriteAbort (request, response);
  1434. break;
  1435. #endif
  1436. #if (DAP_JTAG != 0)
  1437. case DAP_PORT_JTAG:
  1438. num = DAP_JTAG_WriteAbort(request, response);
  1439. break;
  1440. #endif
  1441. default:
  1442. *response = DAP_ERROR;
  1443. num = 1U;
  1444. break;
  1445. }
  1446. return ((5U << 16) | num);
  1447. }
  1448. // Process DAP Vendor command request and prepare response
  1449. // Default function (can be overridden)
  1450. // request: pointer to request data
  1451. // response: pointer to response data
  1452. // return: number of bytes in response (lower 16 bits)
  1453. // number of bytes in request (upper 16 bits)
  1454. __WEAK uint32_t DAP_ProcessVendorCommand(const uint8_t *request, uint8_t *response) {
  1455. (void)request;
  1456. *response = ID_DAP_Invalid;
  1457. return ((1U << 16) | 1U);
  1458. }
  1459. // Process DAP command request and prepare response
  1460. // request: pointer to request data
  1461. // response: pointer to response data
  1462. // return: number of bytes in response (lower 16 bits)
  1463. // number of bytes in request (upper 16 bits)
  1464. uint32_t DAP_ProcessCommand(const uint8_t *request, uint8_t *response) {
  1465. uint32_t num;
  1466. if ((*request >= ID_DAP_Vendor0) && (*request <= ID_DAP_Vendor31)) {
  1467. return DAP_ProcessVendorCommand(request, response);
  1468. }
  1469. *response++ = *request;
  1470. switch (*request++) {
  1471. case ID_DAP_Info:
  1472. num = DAP_Info(*request, response+1);
  1473. *response = (uint8_t)num;
  1474. return ((2U << 16) + 2U + num);
  1475. case ID_DAP_HostStatus:
  1476. num = DAP_HostStatus(request, response);
  1477. break;
  1478. case ID_DAP_Connect:
  1479. num = DAP_Connect(request, response);
  1480. break;
  1481. case ID_DAP_Disconnect:
  1482. num = DAP_Disconnect(response);
  1483. break;
  1484. case ID_DAP_Delay:
  1485. num = DAP_Delay(request, response);
  1486. break;
  1487. case ID_DAP_ResetTarget:
  1488. num = DAP_ResetTarget(response);
  1489. break;
  1490. case ID_DAP_SWJ_Pins:
  1491. num = DAP_SWJ_Pins(request, response);
  1492. break;
  1493. case ID_DAP_SWJ_Clock:
  1494. num = DAP_SWJ_Clock(request, response);
  1495. break;
  1496. case ID_DAP_SWJ_Sequence:
  1497. num = DAP_SWJ_Sequence(request, response);
  1498. break;
  1499. case ID_DAP_SWD_Configure:
  1500. num = DAP_SWD_Configure(request, response);
  1501. break;
  1502. case ID_DAP_SWD_Sequence:
  1503. num = DAP_SWD_Sequence(request, response);
  1504. break;
  1505. case ID_DAP_JTAG_Sequence:
  1506. num = DAP_JTAG_Sequence(request, response);
  1507. break;
  1508. case ID_DAP_JTAG_Configure:
  1509. num = DAP_JTAG_Configure(request, response);
  1510. break;
  1511. case ID_DAP_JTAG_IDCODE:
  1512. num = DAP_JTAG_IDCode(request, response);
  1513. break;
  1514. case ID_DAP_TransferConfigure:
  1515. num = DAP_TransferConfigure(request, response);
  1516. break;
  1517. case ID_DAP_Transfer:
  1518. num = DAP_Transfer(request, response);
  1519. break;
  1520. case ID_DAP_TransferBlock:
  1521. num = DAP_TransferBlock(request, response);
  1522. break;
  1523. case ID_DAP_WriteABORT:
  1524. num = DAP_WriteAbort(request, response);
  1525. break;
  1526. #if ((SWO_UART != 0) || (SWO_MANCHESTER != 0))
  1527. case ID_DAP_SWO_Transport:
  1528. num = SWO_Transport(request, response);
  1529. break;
  1530. case ID_DAP_SWO_Mode:
  1531. num = SWO_Mode(request, response);
  1532. break;
  1533. case ID_DAP_SWO_Baudrate:
  1534. num = SWO_Baudrate(request, response);
  1535. break;
  1536. case ID_DAP_SWO_Control:
  1537. num = SWO_Control(request, response);
  1538. break;
  1539. case ID_DAP_SWO_Status:
  1540. num = SWO_Status(response);
  1541. break;
  1542. case ID_DAP_SWO_ExtendedStatus:
  1543. num = SWO_ExtendedStatus(request, response);
  1544. break;
  1545. case ID_DAP_SWO_Data:
  1546. num = SWO_Data(request, response);
  1547. break;
  1548. #endif
  1549. #if (DAP_UART != 0)
  1550. case ID_DAP_UART_Transport:
  1551. num = UART_Transport(request, response);
  1552. break;
  1553. case ID_DAP_UART_Configure:
  1554. num = UART_Configure(request, response);
  1555. break;
  1556. case ID_DAP_UART_Control:
  1557. num = UART_Control(request, response);
  1558. break;
  1559. case ID_DAP_UART_Status:
  1560. num = UART_Status(response);
  1561. break;
  1562. case ID_DAP_UART_Transfer:
  1563. num = UART_Transfer(request, response);
  1564. break;
  1565. #endif
  1566. default:
  1567. *(response-1) = ID_DAP_Invalid;
  1568. return ((1U << 16) | 1U);
  1569. }
  1570. return ((1U << 16) + 1U + num);
  1571. }
  1572. // Execute DAP command (process request and prepare response)
  1573. // request: pointer to request data
  1574. // response: pointer to response data
  1575. // return: number of bytes in response (lower 16 bits)
  1576. // number of bytes in request (upper 16 bits)
  1577. uint32_t DAP_ExecuteCommand(const uint8_t *request, uint8_t *response) {
  1578. uint32_t cnt, num, n;
  1579. if (*request == ID_DAP_ExecuteCommands) {
  1580. *response++ = *request++;
  1581. cnt = *request++;
  1582. *response++ = (uint8_t)cnt;
  1583. num = (2U << 16) | 2U;
  1584. while (cnt--) {
  1585. n = DAP_ProcessCommand(request, response);
  1586. num += n;
  1587. request += (uint16_t)(n >> 16);
  1588. response += (uint16_t) n;
  1589. }
  1590. return (num);
  1591. }
  1592. return DAP_ProcessCommand(request, response);
  1593. }
  1594. // Setup DAP
  1595. void DAP_Setup(void) {
  1596. // Default settings
  1597. DAP_Data.debug_port = 0U;
  1598. DAP_Data.transfer.idle_cycles = 0U;
  1599. DAP_Data.transfer.retry_count = 100U;
  1600. DAP_Data.transfer.match_retry = 0U;
  1601. DAP_Data.transfer.match_mask = 0x00000000U;
  1602. #if (DAP_SWD != 0)
  1603. DAP_Data.swd_conf.turnaround = 1U;
  1604. DAP_Data.swd_conf.data_phase = 0U;
  1605. #endif
  1606. #if (DAP_JTAG != 0)
  1607. DAP_Data.jtag_dev.count = 0U;
  1608. #endif
  1609. // Sets DAP_Data.fast_clock and DAP_Data.clock_delay.
  1610. Set_Clock_Delay(DAP_DEFAULT_SWJ_CLOCK);
  1611. DAP_SETUP(); // Device specific setup
  1612. }