X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=src%2Fjtag%2Fhla%2Fhla_layout.h;h=e0bbd0fed6feac1bd2242b197f23cf3ae6a69f22;hb=b12fca236d191b0f280aaea0b63a5789480b5e05;hp=ccc3a003e83d18aa0906b8cbdcc9ae11ababff4b;hpb=ff94e02b7cfe5df892824e60140dcdd07ed2b01c;p=fw%2Fopenocd diff --git a/src/jtag/hla/hla_layout.h b/src/jtag/hla/hla_layout.h index ccc3a003e..e0bbd0fed 100644 --- a/src/jtag/hla/hla_layout.h +++ b/src/jtag/hla/hla_layout.h @@ -16,13 +16,13 @@ * 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., * - * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. * + * along with this program. If not, see . * ***************************************************************************/ -#ifndef _HL_LAYOUT_H -#define _HL_LAYOUT_H +#ifndef OPENOCD_JTAG_HLA_HLA_LAYOUT_H +#define OPENOCD_JTAG_HLA_HLA_LAYOUT_H + +#include /** */ struct hl_interface_s; @@ -31,37 +31,38 @@ struct hl_interface_param_s; /** */ extern struct hl_layout_api_s stlink_usb_layout_api; extern struct hl_layout_api_s icdi_usb_layout_api; +extern struct hl_layout_api_s nulink_usb_layout_api; /** */ struct hl_layout_api_s { /** */ - int (*open) (struct hl_interface_param_s *param, void **fd); + int (*open)(struct hl_interface_param_s *param, void **handle); /** */ - int (*close) (void *fd); + int (*close)(void *handle); /** */ - int (*reset) (void *fd); + int (*reset)(void *handle); /** */ - int (*assert_srst) (void *fd, int srst); + int (*assert_srst)(void *handle, int srst); /** */ - int (*run) (void *fd); + int (*run)(void *handle); /** */ - int (*halt) (void *fd); + int (*halt)(void *handle); /** */ - int (*step) (void *fd); + int (*step)(void *handle); /** */ - int (*read_regs) (void *fd); + int (*read_regs)(void *handle); /** */ - int (*read_reg) (void *fd, int num, uint32_t *val); + int (*read_reg)(void *handle, int num, uint32_t *val); /** */ - int (*write_reg) (void *fd, int num, uint32_t val); + int (*write_reg)(void *handle, int num, uint32_t val); /** */ - int (*read_mem) (void *handle, uint32_t addr, uint32_t size, + int (*read_mem)(void *handle, uint32_t addr, uint32_t size, uint32_t count, uint8_t *buffer); /** */ - int (*write_mem) (void *handle, uint32_t addr, uint32_t size, + int (*write_mem)(void *handle, uint32_t addr, uint32_t size, uint32_t count, const uint8_t *buffer); /** */ - int (*write_debug_reg) (void *handle, uint32_t addr, uint32_t val); + int (*write_debug_reg)(void *handle, uint32_t addr, uint32_t val); /** * Read the idcode of the target connected to the adapter * @@ -72,9 +73,42 @@ struct hl_layout_api_s { * @param idcode Storage for the detected idcode * @returns ERROR_OK on success, or an error code on failure. */ - int (*idcode) (void *handle, uint32_t *idcode); + int (*idcode)(void *handle, uint32_t *idcode); + /** */ + int (*override_target)(const char *targetname); + /** */ + int (*custom_command)(void *handle, const char *command); + /** */ + int (*speed)(void *handle, int khz, bool query); + /** + * Configure trace parameters for the adapter + * + * @param handle A handle to adapter + * @param enabled Whether to enable trace + * @param pin_protocol Configured pin protocol + * @param port_size Trace port width for sync mode + * @param trace_freq A pointer to the configured trace + * frequency; if it points to 0, the adapter driver must write + * its maximum supported rate there + * @returns ERROR_OK on success, an error code on failure. + */ + int (*config_trace)(void *handle, bool enabled, + enum tpiu_pin_protocol pin_protocol, uint32_t port_size, + unsigned int *trace_freq, unsigned int traceclkin_freq, + uint16_t *prescaler); + /** + * Poll for new trace data + * + * @param handle A handle to adapter + * @param buf A pointer to buffer to store received data + * @param size A pointer to buffer size; must be filled with + * the actual amount of bytes written + * + * @returns ERROR_OK on success, an error code on failure. + */ + int (*poll_trace)(void *handle, uint8_t *buf, size_t *size); /** */ - enum target_state (*state) (void *fd); + enum target_state (*state)(void *fd); }; /** */ @@ -82,9 +116,9 @@ struct hl_layout { /** */ char *name; /** */ - int (*open) (struct hl_interface_s *adapter); + int (*open)(struct hl_interface_s *adapter); /** */ - int (*close) (struct hl_interface_s *adapter); + int (*close)(struct hl_interface_s *adapter); /** */ struct hl_layout_api_s *api; }; @@ -94,4 +128,4 @@ const struct hl_layout *hl_layout_get_list(void); /** */ int hl_layout_init(struct hl_interface_s *adapter); -#endif /* _HL_LAYOUT_H */ +#endif /* OPENOCD_JTAG_HLA_HLA_LAYOUT_H */