openFPGALoader/src/cmsisDAP.hpp

// SPDX-License-Identifier: Apache-2.0
/*
 * Copyright (c) 2021 Gwenhael Goavec-Merou <[email protected]>
 */

#ifndef SRC_CMSISDAP_HPP_
#define SRC_CMSISDAP_HPP_

#ifdef ENABLE_CMSISDAP_V1
#include <hidapi.h>
#endif
#ifdef ENABLE_CMSISDAP_V2
#include <libusb.h>
#endif

#include <string>
#include <vector>

#include "cable.hpp"
#include "jtagInterface.hpp"

class CmsisDAP: public JtagInterface {
	public:
		/*!
		 * \brief constructor: open device with vid/pid if != 0
		 *                    else search for a compatible device
		 * \param[in] vid: vendor id
		 * \param[in] pid: product id
		 * \param[in] index: interface number
		 * \param[in] clkHZ: clock frequency
		 * \param[in] verbose: verbose level (0 normal, 1 verbose)
		 */
		CmsisDAP(const cable_t &cable, int index, uint32_t clkHZ, int8_t verbose);

		~CmsisDAP();

		/*!
		 * \brief configure probe clk frequency
		 * \param[in] clkHZ: frequency in Hertz
		 * \return <= 0 if something wrong, clkHZ otherwise
		 */
		int setClkFreq(uint32_t clkHZ) override;

		/*!
		 * \brief store a len tms bits in a buffer. send is only done if
		 *   flush_buffer
		 * \param[in] tms: serie of tms state
		 * \param[in] len: number of tms bits
		 * \param[in] flush_buffer: force buffer to be send or not
		 * \return <= 0 if something wrong, len otherwise
		 */
		int writeTMS(const uint8_t *tms, uint32_t len, bool flush_buffer, const uint8_t tdi = 1) override;

		/*!
		 * \brief write and read len bits with optional tms set to 1 if end
		 * \param[in] tx: serie of tdi state to send
		 * \param[out] rx: buffer to store tdo bits from device
		 * \param[in] len: number of bit to read/write
		 * \param[in] end: if true tms is set to one with the last tdi bit
		 * \return <= 0 if something wrong, len otherwise
		 */
		int writeTDI(const uint8_t *tx, uint8_t *rx, uint32_t len, bool end) override;

		/*!
		 * \brief send a serie of clock cycle with constant TMS and TDI
		 * \param[in] tms: tms state
		 * \param[in] tdi: tdi state
		 * \param[in] clk_len: number of clock cycle
		 * \return <= 0 if something wrong, clk_len otherwise
		 */
		int toggleClk(uint8_t tms, uint8_t tdi, uint32_t clk_len) override;

		/*!
		 * \brief flush TMS buffer
		 * \return <=0 if something fail, > 0 otherwise
		 */
		int flush() override;

		/* not used */
		int get_buffer_size() override { return 0;}
		/* not used */
		bool isFull() override {return false;}

	private:
		/*!
		 * \brief connect device in JTAG mode
		 * \return 1 if success <= 0 otherwise
		 */
		int dapConnect();

		/*!
		 * \brief disconnect device
		 * \return 1 if success <= 0 otherwise
		 */
		int dapDisconnect();
		int dapResetTarget();

#ifdef ENABLE_CMSISDAP_V1
		bool initWithHID(const cable_t &cable, int index, int8_t verbose);
#endif
#ifdef ENABLE_CMSISDAP_V2
		struct cmsis_dap_v2_dev_t {
			libusb_device_handle *handle;
			uint16_t vid;
			uint16_t pid;
			std::wstring serial;
			std::wstring vendor;
			std::wstring product;
			int interface_num;
			int config_num;
			uint8_t ep_in;
			uint8_t ep_out;
			int packet_size;
		};

		std::vector<cmsis_dap_v2_dev_t> findCmsisDapDevices(uint16_t vid, uint16_t pid);
		bool initWithBulk(const cable_t &cable, int8_t verbose, bool err_as_info);
#endif
		int read_info(uint8_t info, uint8_t *rd_info, int max_len);
		int xfer(int tx_len, uint8_t *rx_buff, int rx_len);
		int xfer(uint8_t instruction, int tx_len,
				uint8_t *rx_buff, int rx_len);

		void display_info(uint8_t info, uint8_t type);
		int writeJtagSequence(uint8_t tms, const uint8_t *tx, uint8_t *rx,
				uint32_t len, bool end);

		bool _verbose;                /**< display more message */
		int16_t _device_idx;          /**< device index */
		uint16_t _vid;                /**< device Vendor ID */
		uint16_t _pid;                /**< device Product ID */
		std::wstring _serial_number;  /**< device serial number */
		std::wstring _vendor;         /**< device manufacturer */
		std::wstring _product_name;   /**< device product name */

#ifdef ENABLE_CMSISDAP_V1
		hid_device *_hid_dev;           /**< hid device used to communicate */
#endif
#ifdef ENABLE_CMSISDAP_V2
		libusb_device_handle *_usb_dev; /**< libusb device used to communicate */
		libusb_context *_ctx;       /**< libusb context */
#endif
		unsigned char *_ll_buffer; /**< message buffer */
		unsigned char *_buffer;    /**< subset of _ll_buffer */
#ifdef ENABLE_CMSISDAP_V2
		int _pkt_sz;               /**< USB bulk packet size */
		int _ep_in;                /**< USB bulk in endpoint */
		int _ep_out;               /**< USB bulk out endpoint */
#endif
		int _num_tms;              /**< current tms length */
		int _is_connect;           /**< device status ((dis)connected) */
		int _backend;              /**< type of USB backend */
};

#endif  // SRC_CMSISDAP_HPP_