usb_tmc.h

/* This file is the part of the Lightweight USB device Stack for STM32 microcontrollers
 *
 * Copyright ©2020 Alexander Voronov <avv.0@ya.ru>
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *   http://www.apache.org/licenses/LICENSE-2.0
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef _USB_TMC_H_
#define _USB_TMC_H_

#ifdef __cplusplus
extern "C" {
#endif

#include <stdint.h>

#define USB_CLASS_TMC           0xFE
#define USB_TMC_SUBCLASS_TMC    0x03
#define USB_TMC_PROTO_NONE      0x00 
#define USB_TMC_PROTO_USB488    0x01 
#define USB_TMC_REQ_INITIATE_ABORT_BULK_OUT     1
#define USB_TMC_REQ_CHECK_ABORT_BULK_OUT_STATUS 2
#define USB_TMC_REQ_INITIATE_ABORT_BULK_IN      3
#define USB_TMC_REQ_CHECK_ABORT_BULK_IN_STATUS  4
#define USB_TMC_REQ_INITIATE_CLEAR              5
#define USB_TMC_REQ_CHECK_CLEAR_STATUS          6
#define USB_TMC_REQ_GET_CAPABILITIES            7
#define USB_TMC_REQ_INDICATOR_PULSE             64

#define USB_TMC_STATUS_SUCCESS                  0x01
#define USB_TMC_STATUS_PENDING                  0x02
#define USB_TMC_STATUS_FAILED                   0x80
#define USB_TMC_STATUS_TRANSFER_NOT_IN_PROGRESS 0x81
#define USB_TMC_STATUS_SPLIT_NOT_IN_PROGRESS    0x82
#define USB_TMC_STATUS_SPLIT_IN_PROGRESS        0x83

struct usb_tmc_get_capabilities_response {
    uint8_t USBTMC_status;
    uint8_t Reserved0;
    uint16_t bcdUSBTMC;
    uint8_t InterfaceCapabilities;
    uint8_t DeviceCapabilities;
    uint8_t Reserved1[18];
} __attribute__((packed));

#define USB_TMC_DEV_DEP_MSG_OUT             1
#define USB_TMC_REQUEST_DEV_DEP_MSG_IN      2
#define USB_TMC_DEV_DEP_MSG_IN              2
#define USB_TMC_VENDOR_SPECIFIC_OUT         126
#define USB_TMC_REQUEST_VENDOR_SPECIFIC_IN  127
#define USB_TMC_VENDOR_SPECIFIC_IN          127

#define USB_TMC_TRANSFER_ATTR_EOM           0x01

#define USB_TMC_TRANSFER_ATTR_TERM_CHAR     0x02

union usb_tmc_bulk_header_specific {
    struct {
        uint32_t TransferSize;
        uint8_t bmTransferAttributes;
        uint8_t Reserved[3];
    } dev_dep_msg_out;

    struct {
        uint32_t TransferSize;
        uint8_t bmTransferAttributes;
        uint8_t TermChar;
        uint8_t Reserved[2];
    } request_dev_dep_msg_in;

    struct {
        uint32_t TransferSize;
        uint8_t bmTransferAttributes;
        uint8_t Reserved[3];
    } dev_dep_msg_in;

    struct {
        uint32_t TransferSize;
        uint8_t Reserved[4];
    } vendor_specific_out;

    struct {
        uint32_t TransferSize;
        uint8_t Reserved[4];
    } request_vendor_specific_in;

    struct {
        uint32_t TransferSize;
        uint8_t Reserved[4];
    } vendor_specific_in;
};

struct usb_tmc_bulk_header {
    uint8_t MsgId;
    uint8_t bTag;
    uint8_t bTagInverse;
    uint8_t Reserved;
    union usb_tmc_bulk_header_specific MsgSpecific;
} __attribute__((packed));

#if defined(__cplusplus)
}
#endif

#endif /* _USB_TMC_H_ */