src/jtag/hla/hla_transport.c

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2
   3 /***************************************************************************
   4  *   Copyright (C) 2011 by Mathias Kuester                                 *
   5  *   Mathias Kuester <kesmtp@freenet.de>                                   *
   6  *                                                                         *
   7  *   Copyright (C) 2012 by Spencer Oliver                                  *
   8  *   spen@spen-soft.co.uk                                                  *
   9  ***************************************************************************/
  10
  11 #ifdef HAVE_CONFIG_H
  12 #include "config.h"
  13 #endif
  14
  15 /* project specific includes */
  16 #include <jtag/interface.h>
  17 #include <jtag/tcl.h>
  18 #include <transport/transport.h>
  19 #include <helper/time_support.h>
  20 #include <target/target.h>
  21 #include <jtag/hla/hla_transport.h>
  22 #include <jtag/hla/hla_interface.h>
  23
  24 COMMAND_HANDLER(hl_transport_jtag_command)
  25 {
  26         LOG_DEBUG("hl_transport_jtag_command");
  27
  28         return ERROR_OK;
  29 }
  30
  31 COMMAND_HANDLER(hl_transport_reset_command)
  32 {
  33         return hl_interface_init_reset();
  34 }
  35
  36 static const struct command_registration hl_swd_transport_subcommand_handlers[] = {
  37         {
  38          .name = "newdap",
  39          .mode = COMMAND_CONFIG,
  40          .jim_handler = jim_jtag_newtap,
  41          .help = "declare a new SWD DAP",
  42          },
  43         COMMAND_REGISTRATION_DONE
  44 };
  45
  46 static const struct command_registration hl_swd_transport_command_handlers[] = {
  47         {
  48          .name = "swd",
  49          .mode = COMMAND_ANY,
  50          .help = "SWD command group",
  51          .usage = "",
  52          .chain = hl_swd_transport_subcommand_handlers,
  53          },
  54         COMMAND_REGISTRATION_DONE
  55 };
  56
  57 static const struct command_registration hl_transport_jtag_subcommand_handlers[] = {
  58         {
  59          .name = "newtap",
  60          .mode = COMMAND_CONFIG,
  61          .jim_handler = jim_jtag_newtap,
  62          .help = "Create a new TAP instance named basename.tap_type, "
  63          "and appends it to the scan chain.",
  64          .usage = "basename tap_type '-irlen' count "
  65          "['-expected_id' number]",
  66          },
  67         {
  68          .name = "init",
  69          .mode = COMMAND_ANY,
  70          .handler = hl_transport_jtag_command,
  71          .usage = ""
  72          },
  73         {
  74          .name = "arp_init",
  75          .mode = COMMAND_ANY,
  76          .handler = hl_transport_jtag_command,
  77          .usage = ""
  78          },
  79         {
  80          .name = "arp_init-reset",
  81          .mode = COMMAND_ANY,
  82          .handler = hl_transport_reset_command,
  83          .usage = ""
  84          },
  85         {
  86          .name = "tapisenabled",
  87          .mode = COMMAND_EXEC,
  88          .jim_handler = jim_jtag_tap_enabler,
  89          },
  90         {
  91          .name = "tapenable",
  92          .mode = COMMAND_EXEC,
  93          .jim_handler = jim_jtag_tap_enabler,
  94          },
  95         {
  96          .name = "tapdisable",
  97          .mode = COMMAND_EXEC,
  98          .handler = hl_transport_jtag_command,
  99          .usage = "",
 100          },
 101         {
 102          .name = "configure",
 103          .mode = COMMAND_EXEC,
 104          .handler = hl_transport_jtag_command,
 105          .usage = "",
 106          },
 107         {
 108          .name = "cget",
 109          .mode = COMMAND_EXEC,
 110          .jim_handler = jim_jtag_configure,
 111          },
 112         {
 113          .name = "names",
 114          .mode = COMMAND_ANY,
 115          .handler = hl_transport_jtag_command,
 116          .usage = "",
 117          },
 118
 119         COMMAND_REGISTRATION_DONE
 120 };
 121
 122 static const struct command_registration hl_jtag_transport_command_handlers[] = {
 123         {
 124          .name = "jtag",
 125          .mode = COMMAND_ANY,
 126          .help = "perform jtag tap actions",
 127          .usage = "",
 128          .chain = hl_transport_jtag_subcommand_handlers,
 129          },
 130         {
 131          .name = "jtag_ntrst_delay",
 132          .mode = COMMAND_ANY,
 133          .handler = hl_transport_jtag_command,
 134          .usage = "",
 135          },
 136         COMMAND_REGISTRATION_DONE
 137 };
 138
 139
 140 static int hl_transport_init(struct command_context *cmd_ctx)
 141 {
 142         LOG_DEBUG("hl_transport_init");
 143         struct target *t = get_current_target(cmd_ctx);
 144         struct transport *transport;
 145         enum hl_transports tr;
 146
 147         if (!t) {
 148                 LOG_ERROR("no current target");
 149                 return ERROR_FAIL;
 150         }
 151
 152         transport = get_current_transport();
 153
 154         if (!transport) {
 155                 LOG_ERROR("no transport selected");
 156                 return ERROR_FAIL;
 157         }
 158
 159         LOG_DEBUG("current transport %s", transport->name);
 160
 161         /* get selected transport as enum */
 162         tr = HL_TRANSPORT_UNKNOWN;
 163
 164         if (strcmp(transport->name, "hla_swd") == 0)
 165                 tr = HL_TRANSPORT_SWD;
 166         else if (strcmp(transport->name, "hla_jtag") == 0)
 167                 tr = HL_TRANSPORT_JTAG;
 168
 169         int retval = hl_interface_open(tr);
 170
 171         if (retval != ERROR_OK)
 172                 return retval;
 173
 174         return hl_interface_init_target(t);
 175 }
 176
 177 static int hl_jtag_transport_select(struct command_context *cmd_ctx)
 178 {
 179         LOG_DEBUG("hl_jtag_transport_select");
 180
 181         /* NOTE:  interface init must already have been done.
 182          * That works with only C code ... no Tcl glue required.
 183          */
 184
 185         return register_commands(cmd_ctx, NULL, hl_jtag_transport_command_handlers);
 186 }
 187
 188 static int hl_swd_transport_select(struct command_context *cmd_ctx)
 189 {
 190         LOG_DEBUG("hl_swd_transport_select");
 191         return register_commands(cmd_ctx, NULL, hl_swd_transport_command_handlers);
 192 }
 193
 194 static struct transport hl_swd_transport = {
 195         .name = "hla_swd",
 196         .select = hl_swd_transport_select,
 197         .init = hl_transport_init,
 198         .override_target = hl_interface_override_target,
 199 };
 200
 201 static struct transport hl_jtag_transport = {
 202         .name = "hla_jtag",
 203         .select = hl_jtag_transport_select,
 204         .init = hl_transport_init,
 205         .override_target = hl_interface_override_target,
 206 };
 207
 208 const char *hl_transports[] = { "hla_swd", "hla_jtag", NULL };
 209
 210 static void hl_constructor(void) __attribute__ ((constructor));
 211 static void hl_constructor(void)
 212 {
 213         transport_register(&hl_swd_transport);
 214         transport_register(&hl_jtag_transport);
 215 }
 216
 217 bool transport_is_hla(void)
 218 {
 219         struct transport *t;
 220         t = get_current_transport();
 221         return t == &hl_swd_transport || t == &hl_jtag_transport;
 222 }