openocd: fix SPDX tag format for files .c
[fw/openocd] / src / target / arm_jtag.c
index 9452c2b98c99d83d0168827d1f576fff60e2a390..c1ec4735ac6a6b73feac7f892b29f982dadc4ecd 100644 (file)
+// SPDX-License-Identifier: GPL-2.0-or-later
+
 /***************************************************************************
  *   Copyright (C) 2005 by Dominic Rath                                    *
  *   Dominic.Rath@gmx.de                                                   *
  *                                                                         *
- *   Copyright (C) 2007,2008 Øyvind Harboe                                 *
+ *   Copyright (C) 2007,2008 Øyvind Harboe                                 *
  *   oyvind.harboe@zylin.com                                               *
- *                                                                         *
- *   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 2 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, write to the                         *
- *   Free Software Foundation, Inc.,                                       *
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  ***************************************************************************/
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
 
 #include "arm_jtag.h"
 
-#include "binarybuffer.h"
-#include "log.h"
-#include "jtag.h"
-
-#include <stdlib.h>
-
 #if 0
 #define _ARM_JTAG_SCAN_N_CHECK_
 #endif
 
-int arm_jtag_set_instr(arm_jtag_t *jtag_info, u32 new_instr,  in_handler_t handler)
-{
-       jtag_device_t *device = jtag_get_device(jtag_info->chain_pos);
-       
-       if (buf_get_u32(device->cur_instr, 0, device->ir_length) != new_instr)
-       {
-               scan_field_t field;
-               u8 t[4];
-       
-               field.device = jtag_info->chain_pos;
-               field.num_bits = device->ir_length;
-               field.out_value = t;
-               buf_set_u32(field.out_value, 0, field.num_bits, new_instr);
-               field.out_mask = NULL;
-               field.in_value = NULL;
-               field.in_check_value = NULL;
-               field.in_check_mask = NULL;
-               field.in_handler = handler;
-               field.in_handler_priv = NULL;
-               jtag_add_ir_scan(1, &field, -1);
-       }
-       
-       return ERROR_OK;
-}
-
-int arm_jtag_scann(arm_jtag_t *jtag_info, u32 new_scan_chain)
+int arm_jtag_set_instr_inner(struct jtag_tap *tap,
+               uint32_t new_instr, void *no_verify_capture, tap_state_t end_state)
 {
-       int retval = ERROR_OK;
-       if(jtag_info->cur_scan_chain != new_scan_chain)
-       {
-               u32 values[1];
-               int num_bits[1];
-               
-               values[0]=new_scan_chain;
-               num_bits[0]=jtag_info->scann_size;
-
-               if((retval = arm_jtag_set_instr(jtag_info, jtag_info->scann_instr, NULL)) != ERROR_OK)
-               {
-                       return retval;
-               }
-
-               jtag_add_dr_out(jtag_info->chain_pos,
-                               1,
-                               num_bits,
-                               values,
-                               -1);
-               
-               jtag_info->cur_scan_chain = new_scan_chain;
-       }
+       struct scan_field field;
+       uint8_t t[4] = { 0 };
 
-       return retval;
-}
+       field.num_bits = tap->ir_length;
+       field.out_value = t;
+       buf_set_u32(t, 0, field.num_bits, new_instr);
+       field.in_value = NULL;
 
-int arm_jtag_reset_callback(enum jtag_event event, void *priv)
-{
-       arm_jtag_t *jtag_info = priv;
-       
-       if (event == JTAG_TRST_ASSERTED)
-       {
-               jtag_info->cur_scan_chain = 0;
+       if (!no_verify_capture)
+               jtag_add_ir_scan(tap, &field, end_state);
+       else {
+               /* FIX!!!! this is a kludge!!! arm926ejs.c should reimplement this arm_jtag_set_instr to
+                * have special verification code.
+                */
+               jtag_add_ir_scan_noverify(tap, &field, end_state);
        }
-       
-       return ERROR_OK;
-}
-
-int arm_jtag_setup_connection(arm_jtag_t *jtag_info)
-{
-       jtag_info->scann_instr = 0x2;
-       jtag_info->cur_scan_chain = 0;
-       jtag_info->intest_instr = 0xc;
-
-       return jtag_register_event_callback(arm_jtag_reset_callback, jtag_info);
-}
 
-/* read JTAG buffer into host-endian u32, flipping bit-order */
-int arm_jtag_buf_to_u32_flip(u8 *in_buf, void *priv, struct scan_field_s *field)
-{
-       u32 *dest = priv;
-       *dest = flip_u32(le_to_h_u32(in_buf), 32);
        return ERROR_OK;
 }
 
-/* read JTAG buffer into little-endian u32, flipping bit-order */
-int arm_jtag_buf_to_le32_flip(u8 *in_buf, void *priv, struct scan_field_s *field)
+int arm_jtag_scann_inner(struct arm_jtag *jtag_info, uint32_t new_scan_chain, tap_state_t end_state)
 {
-       h_u32_to_le(((u8*)priv), flip_u32(le_to_h_u32(in_buf), 32));
-       return ERROR_OK;
-}
+       int retval = ERROR_OK;
 
-/* read JTAG buffer into little-endian u16, flipping bit-order */
-int arm_jtag_buf_to_le16_flip(u8 *in_buf, void *priv, struct scan_field_s *field)
-{
-       h_u16_to_le(((u8*)priv), flip_u32(le_to_h_u32(in_buf), 32) & 0xffff);
-       return ERROR_OK;
-}
+       uint8_t out_value[4] = { 0 };
+       buf_set_u32(out_value, 0, jtag_info->scann_size, new_scan_chain);
+       struct scan_field field = { .num_bits = jtag_info->scann_size, .out_value = out_value, };
 
-/* read JTAG buffer into big-endian u32, flipping bit-order */
-int arm_jtag_buf_to_be32_flip(u8 *in_buf, void *priv, struct scan_field_s *field)
-{
-       h_u32_to_be(((u8*)priv), flip_u32(le_to_h_u32(in_buf), 32));
-       return ERROR_OK;
-}
+       retval = arm_jtag_set_instr(jtag_info->tap, jtag_info->scann_instr, NULL, end_state);
+       if (retval != ERROR_OK)
+               return retval;
 
-/* read JTAG buffer into big-endian u16, flipping bit-order */
-int arm_jtag_buf_to_be16_flip(u8 *in_buf, void *priv, struct scan_field_s *field)
-{
-       h_u16_to_be(((u8*)priv), flip_u32(le_to_h_u32(in_buf), 32) & 0xffff);
-       return ERROR_OK;
-}
+       jtag_add_dr_scan(jtag_info->tap,
+                       1,
+                       &field,
+                       end_state);
 
-/* read JTAG buffer into u8, flipping bit-order */
-int arm_jtag_buf_to_8_flip(u8 *in_buf, void *priv, struct scan_field_s *field)
-{
-       u8 *dest = priv;
-       *dest = flip_u32(le_to_h_u32(in_buf), 32) & 0xff;
-       return ERROR_OK;
-}
+       jtag_info->cur_scan_chain = new_scan_chain;
 
-/* not-flipping variants */
-/* read JTAG buffer into host-endian u32 */
-int arm_jtag_buf_to_u32(u8 *in_buf, void *priv, struct scan_field_s *field)
-{
-       u32 *dest = priv;
-       *dest = le_to_h_u32(in_buf);
-       return ERROR_OK;
+       return retval;
 }
 
-/* read JTAG buffer into little-endian u32 */
-int arm_jtag_buf_to_le32(u8 *in_buf, void *priv, struct scan_field_s *field)
+static int arm_jtag_reset_callback(enum jtag_event event, void *priv)
 {
-       h_u32_to_le(((u8*)priv), le_to_h_u32(in_buf));
-       return ERROR_OK;
-}
+       struct arm_jtag *jtag_info = priv;
 
-/* read JTAG buffer into little-endian u16 */
-int arm_jtag_buf_to_le16(u8 *in_buf, void *priv, struct scan_field_s *field)
-{
-       h_u16_to_le(((u8*)priv), le_to_h_u32(in_buf) & 0xffff);
-       return ERROR_OK;
-}
+       if (event == JTAG_TRST_ASSERTED)
+               jtag_info->cur_scan_chain = 0;
 
-/* read JTAG buffer into big-endian u32 */
-int arm_jtag_buf_to_be32(u8 *in_buf, void *priv, struct scan_field_s *field)
-{
-       h_u32_to_be(((u8*)priv), le_to_h_u32(in_buf));
        return ERROR_OK;
 }
 
-/* read JTAG buffer into big-endian u16 */
-int arm_jtag_buf_to_be16(u8 *in_buf, void *priv, struct scan_field_s *field)
+int arm_jtag_setup_connection(struct arm_jtag *jtag_info)
 {
-       h_u16_to_be(((u8*)priv), le_to_h_u32(in_buf) & 0xffff);
-       return ERROR_OK;
+       jtag_info->scann_instr = 0x2;
+       jtag_info->cur_scan_chain = 0;
+       jtag_info->intest_instr = 0xc;
+
+       return jtag_register_event_callback(arm_jtag_reset_callback, jtag_info);
 }
 
-/* read JTAG buffer into u8 */
-int arm_jtag_buf_to_8(u8 *in_buf, void *priv, struct scan_field_s *field)
+int arm_jtag_close_connection(struct arm_jtag *jtag_info)
 {
-       u8 *dest = priv;
-       *dest = le_to_h_u32(in_buf) & 0xff;
-       return ERROR_OK;
+       return jtag_unregister_event_callback(arm_jtag_reset_callback, jtag_info);
 }