#endif // CDC_DATA_INTERFACE | #endif // CDC_DATA_INTERFACE | ||||
#ifdef CDC2_DATA_INTERFACE | #ifdef CDC2_DATA_INTERFACE | ||||
EMIT_CDC_IAD_DESCRIPTOR(CDC2), | |||||
EMIT_CDC_DESCRIPTORS(CDC2), | |||||
// interface association descriptor, USB ECN, Table 9-Z | |||||
8, // bLength | |||||
11, // bDescriptorType | |||||
CDC2_STATUS_INTERFACE, // bFirstInterface | |||||
2, // bInterfaceCount | |||||
0x02, // bFunctionClass | |||||
0x02, // bFunctionSubClass | |||||
0x01, // bFunctionProtocol | |||||
0, // iFunction | |||||
// interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12 | |||||
9, // bLength | |||||
4, // bDescriptorType | |||||
CDC2_STATUS_INTERFACE, // bInterfaceNumber | |||||
0, // bAlternateSetting | |||||
1, // bNumEndpoints | |||||
0x02, // bInterfaceClass | |||||
0x02, // bInterfaceSubClass | |||||
0x01, // bInterfaceProtocol | |||||
0, // iInterface | |||||
// CDC Header Functional Descriptor, CDC Spec 5.2.3.1, Table 26 | |||||
5, // bFunctionLength | |||||
0x24, // bDescriptorType | |||||
0x00, // bDescriptorSubtype | |||||
0x10, 0x01, // bcdCDC | |||||
// Call Management Functional Descriptor, CDC Spec 5.2.3.2, Table 27 | |||||
5, // bFunctionLength | |||||
0x24, // bDescriptorType | |||||
0x01, // bDescriptorSubtype | |||||
0x01, // bmCapabilities | |||||
1, // bDataInterface | |||||
// Abstract Control Management Functional Descriptor, CDC Spec 5.2.3.3, Table 28 | |||||
4, // bFunctionLength | |||||
0x24, // bDescriptorType | |||||
0x02, // bDescriptorSubtype | |||||
0x06, // bmCapabilities | |||||
// Union Functional Descriptor, CDC Spec 5.2.3.8, Table 33 | |||||
5, // bFunctionLength | |||||
0x24, // bDescriptorType | |||||
0x06, // bDescriptorSubtype | |||||
CDC2_STATUS_INTERFACE, // bMasterInterface | |||||
CDC2_DATA_INTERFACE, // bSlaveInterface0 | |||||
// endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13 | |||||
7, // bLength | |||||
5, // bDescriptorType | |||||
CDC2_ACM_ENDPOINT | 0x80, // bEndpointAddress | |||||
0x03, // bmAttributes (0x03=intr) | |||||
CDC2_ACM_SIZE, 0, // wMaxPacketSize | |||||
64, // bInterval | |||||
// interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12 | |||||
9, // bLength | |||||
4, // bDescriptorType | |||||
CDC2_DATA_INTERFACE, // bInterfaceNumber | |||||
0, // bAlternateSetting | |||||
2, // bNumEndpoints | |||||
0x0A, // bInterfaceClass | |||||
0x00, // bInterfaceSubClass | |||||
0x00, // bInterfaceProtocol | |||||
0, // iInterface | |||||
// endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13 | |||||
7, // bLength | |||||
5, // bDescriptorType | |||||
CDC2_RX_ENDPOINT, // bEndpointAddress | |||||
0x02, // bmAttributes (0x02=bulk) | |||||
CDC2_RX_SIZE, 0, // wMaxPacketSize | |||||
0, // bInterval | |||||
// endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13 | |||||
7, // bLength | |||||
5, // bDescriptorType | |||||
CDC2_TX_ENDPOINT | 0x80, // bEndpointAddress | |||||
0x02, // bmAttributes (0x02=bulk) | |||||
CDC2_TX_SIZE, 0, // wMaxPacketSize | |||||
0, // bInterval | |||||
#endif // CDC2_DATA_INTERFACE | #endif // CDC2_DATA_INTERFACE | ||||
#ifdef CDC3_DATA_INTERFACE | #ifdef CDC3_DATA_INTERFACE | ||||
EMIT_CDC_IAD_DESCRIPTOR(CDC3), | |||||
EMIT_CDC_DESCRIPTORS(CDC3), | |||||
// interface association descriptor, USB ECN, Table 9-Z | |||||
8, // bLength | |||||
11, // bDescriptorType | |||||
CDC3_STATUS_INTERFACE, // bFirstInterface | |||||
2, // bInterfaceCount | |||||
0x02, // bFunctionClass | |||||
0x02, // bFunctionSubClass | |||||
0x01, // bFunctionProtocol | |||||
0, // iFunction | |||||
// interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12 | |||||
9, // bLength | |||||
4, // bDescriptorType | |||||
CDC3_STATUS_INTERFACE, // bInterfaceNumber | |||||
0, // bAlternateSetting | |||||
1, // bNumEndpoints | |||||
0x02, // bInterfaceClass | |||||
0x02, // bInterfaceSubClass | |||||
0x01, // bInterfaceProtocol | |||||
0, // iInterface | |||||
// CDC Header Functional Descriptor, CDC Spec 5.2.3.1, Table 26 | |||||
5, // bFunctionLength | |||||
0x24, // bDescriptorType | |||||
0x00, // bDescriptorSubtype | |||||
0x10, 0x01, // bcdCDC | |||||
// Call Management Functional Descriptor, CDC Spec 5.2.3.2, Table 27 | |||||
5, // bFunctionLength | |||||
0x24, // bDescriptorType | |||||
0x01, // bDescriptorSubtype | |||||
0x01, // bmCapabilities | |||||
1, // bDataInterface | |||||
// Abstract Control Management Functional Descriptor, CDC Spec 5.2.3.3, Table 28 | |||||
4, // bFunctionLength | |||||
0x24, // bDescriptorType | |||||
0x02, // bDescriptorSubtype | |||||
0x06, // bmCapabilities | |||||
// Union Functional Descriptor, CDC Spec 5.2.3.8, Table 33 | |||||
5, // bFunctionLength | |||||
0x24, // bDescriptorType | |||||
0x06, // bDescriptorSubtype | |||||
CDC3_STATUS_INTERFACE, // bMasterInterface | |||||
CDC3_DATA_INTERFACE, // bSlaveInterface0 | |||||
// endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13 | |||||
7, // bLength | |||||
5, // bDescriptorType | |||||
CDC3_ACM_ENDPOINT | 0x80, // bEndpointAddress | |||||
0x03, // bmAttributes (0x03=intr) | |||||
CDC3_ACM_SIZE, 0, // wMaxPacketSize | |||||
64, // bInterval | |||||
// interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12 | |||||
9, // bLength | |||||
4, // bDescriptorType | |||||
CDC3_DATA_INTERFACE, // bInterfaceNumber | |||||
0, // bAlternateSetting | |||||
2, // bNumEndpoints | |||||
0x0A, // bInterfaceClass | |||||
0x00, // bInterfaceSubClass | |||||
0x00, // bInterfaceProtocol | |||||
0, // iInterface | |||||
// endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13 | |||||
7, // bLength | |||||
5, // bDescriptorType | |||||
CDC3_RX_ENDPOINT, // bEndpointAddress | |||||
0x02, // bmAttributes (0x02=bulk) | |||||
CDC3_RX_SIZE, 0, // wMaxPacketSize | |||||
0, // bInterval | |||||
// endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13 | |||||
7, // bLength | |||||
5, // bDescriptorType | |||||
CDC3_TX_ENDPOINT | 0x80, // bEndpointAddress | |||||
0x02, // bmAttributes (0x02=bulk) | |||||
CDC3_TX_SIZE, 0, // wMaxPacketSize | |||||
0, // bInterval | |||||
#endif // CDC3_DATA_INTERFACE | #endif // CDC3_DATA_INTERFACE | ||||
#ifdef MIDI_INTERFACE | #ifdef MIDI_INTERFACE |
*/ | */ | ||||
#include "usb_dev.h" | #include "usb_dev.h" | ||||
#include "usb_serial3.h" | |||||
#include "core_pins.h" // for yield() | |||||
//#include "HardwareSerial.h" | |||||
#include <string.h> // for memcpy() | |||||
// defined by usb_dev.h -> usb_desc.h | // defined by usb_dev.h -> usb_desc.h | ||||
#if defined(CDC2_STATUS_INTERFACE) && defined(CDC2_DATA_INTERFACE) | |||||
#if defined(CDC3_STATUS_INTERFACE) && defined(CDC3_DATA_INTERFACE) | |||||
#if F_CPU >= 20000000 | #if F_CPU >= 20000000 | ||||
#include "usb_serial_port.h" | |||||
struct usb_serial_port usb_serial2_instance = { | |||||
.cdc_rx_endpoint = CDC2_RX_ENDPOINT, | |||||
.cdc_tx_endpoint = CDC2_TX_ENDPOINT, | |||||
.cdc_tx_size = CDC2_TX_SIZE, | |||||
}; | |||||
uint32_t usb_cdc3_line_coding[2]; | |||||
volatile uint32_t usb_cdc3_line_rtsdtr_millis; | |||||
volatile uint8_t usb_cdc3_line_rtsdtr=0; | |||||
volatile uint8_t usb_cdc3_transmit_flush_timer=0; | |||||
static usb_packet_t *rx_packet=NULL; | |||||
static usb_packet_t *tx_packet=NULL; | |||||
static volatile uint8_t tx_noautoflush=0; | |||||
#define TRANSMIT_FLUSH_TIMEOUT 5 /* in milliseconds */ | |||||
// get the next character, or -1 if nothing received | |||||
int usb_serial3_getchar(void) | |||||
{ | |||||
unsigned int i; | |||||
int c; | |||||
if (!rx_packet) { | |||||
if (!usb_configuration) return -1; | |||||
rx_packet = usb_rx(CDC3_RX_ENDPOINT); | |||||
if (!rx_packet) return -1; | |||||
} | |||||
i = rx_packet->index; | |||||
c = rx_packet->buf[i++]; | |||||
if (i >= rx_packet->len) { | |||||
usb_free(rx_packet); | |||||
rx_packet = NULL; | |||||
} else { | |||||
rx_packet->index = i; | |||||
} | |||||
return c; | |||||
} | |||||
// peek at the next character, or -1 if nothing received | |||||
int usb_serial3_peekchar(void) | |||||
{ | |||||
if (!rx_packet) { | |||||
if (!usb_configuration) return -1; | |||||
rx_packet = usb_rx(CDC3_RX_ENDPOINT); | |||||
if (!rx_packet) return -1; | |||||
} | |||||
if (!rx_packet) return -1; | |||||
return rx_packet->buf[rx_packet->index]; | |||||
} | |||||
// number of bytes available in the receive buffer | |||||
int usb_serial3_available(void) | |||||
{ | |||||
int count; | |||||
count = usb_rx_byte_count(CDC3_RX_ENDPOINT); | |||||
if (rx_packet) count += rx_packet->len - rx_packet->index; | |||||
return count; | |||||
} | |||||
// read a block of bytes to a buffer | |||||
int usb_serial3_read(void *buffer, uint32_t size) | |||||
{ | |||||
uint8_t *p = (uint8_t *)buffer; | |||||
uint32_t qty, count=0; | |||||
while (size) { | |||||
if (!usb_configuration) break; | |||||
if (!rx_packet) { | |||||
rx: | |||||
rx_packet = usb_rx(CDC3_RX_ENDPOINT); | |||||
if (!rx_packet) break; | |||||
if (rx_packet->len == 0) { | |||||
usb_free(rx_packet); | |||||
goto rx; | |||||
} | |||||
} | |||||
qty = rx_packet->len - rx_packet->index; | |||||
if (qty > size) qty = size; | |||||
memcpy(p, rx_packet->buf + rx_packet->index, qty); | |||||
p += qty; | |||||
count += qty; | |||||
size -= qty; | |||||
rx_packet->index += qty; | |||||
if (rx_packet->index >= rx_packet->len) { | |||||
usb_free(rx_packet); | |||||
rx_packet = NULL; | |||||
} | |||||
} | |||||
return count; | |||||
} | |||||
// discard any buffered input | |||||
void usb_serial3_flush_input(void) | |||||
{ | |||||
usb_packet_t *rx; | |||||
if (!usb_configuration) return; | |||||
if (rx_packet) { | |||||
usb_free(rx_packet); | |||||
rx_packet = NULL; | |||||
} | |||||
while (1) { | |||||
rx = usb_rx(CDC3_RX_ENDPOINT); | |||||
if (!rx) break; | |||||
usb_free(rx); | |||||
} | |||||
} | |||||
// Maximum number of transmit packets to queue so we don't starve other endpoints for memory | |||||
#define TX_PACKET_LIMIT 8 | |||||
// When the PC isn't listening, how long do we wait before discarding data? If this is | |||||
// too short, we risk losing data during the stalls that are common with ordinary desktop | |||||
// software. If it's too long, we stall the user's program when no software is running. | |||||
#define TX_TIMEOUT_MSEC 70 | |||||
#if F_CPU == 256000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1706) | |||||
#elif F_CPU == 240000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1600) | |||||
#elif F_CPU == 216000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1440) | |||||
#elif F_CPU == 192000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1280) | |||||
#elif F_CPU == 180000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1200) | |||||
#elif F_CPU == 168000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1100) | |||||
#elif F_CPU == 144000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 932) | |||||
#elif F_CPU == 120000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 764) | |||||
#elif F_CPU == 96000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 596) | |||||
#elif F_CPU == 72000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 512) | |||||
#elif F_CPU == 48000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 428) | |||||
#elif F_CPU == 24000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 262) | |||||
#endif | #endif | ||||
#endif // CDC2_STATUS_INTERFACE && CDC2_DATA_INTERFACE | |||||
// When we've suffered the transmit timeout, don't wait again until the computer | |||||
// begins accepting data. If no software is running to receive, we'll just discard | |||||
// data as rapidly as Serial.print() can generate it, until there's something to | |||||
// actually receive it. | |||||
static uint8_t transmit_previous_timeout=0; | |||||
// transmit a character. 0 returned on success, -1 on error | |||||
int usb_serial3_putchar(uint8_t c) | |||||
{ | |||||
return usb_serial3_write(&c, 1); | |||||
} | |||||
int usb_serial3_write(const void *buffer, uint32_t size) | |||||
{ | |||||
uint32_t ret = size; | |||||
uint32_t len; | |||||
uint32_t wait_count; | |||||
const uint8_t *src = (const uint8_t *)buffer; | |||||
uint8_t *dest; | |||||
tx_noautoflush = 1; | |||||
while (size > 0) { | |||||
if (!tx_packet) { | |||||
wait_count = 0; | |||||
while (1) { | |||||
if (!usb_configuration) { | |||||
tx_noautoflush = 0; | |||||
return -1; | |||||
} | |||||
if (usb_tx_packet_count(CDC3_TX_ENDPOINT) < TX_PACKET_LIMIT) { | |||||
tx_noautoflush = 1; | |||||
tx_packet = usb_malloc(); | |||||
if (tx_packet) break; | |||||
tx_noautoflush = 0; | |||||
} | |||||
if (++wait_count > TX_TIMEOUT || transmit_previous_timeout) { | |||||
transmit_previous_timeout = 1; | |||||
return -1; | |||||
} | |||||
yield(); | |||||
} | |||||
} | |||||
transmit_previous_timeout = 0; | |||||
len = CDC3_TX_SIZE - tx_packet->index; | |||||
if (len > size) len = size; | |||||
dest = tx_packet->buf + tx_packet->index; | |||||
tx_packet->index += len; | |||||
size -= len; | |||||
while (len-- > 0) *dest++ = *src++; | |||||
if (tx_packet->index >= CDC3_TX_SIZE) { | |||||
tx_packet->len = CDC3_TX_SIZE; | |||||
usb_tx(CDC3_TX_ENDPOINT, tx_packet); | |||||
tx_packet = NULL; | |||||
} | |||||
usb_cdc3_transmit_flush_timer = TRANSMIT_FLUSH_TIMEOUT; | |||||
} | |||||
tx_noautoflush = 0; | |||||
return ret; | |||||
} | |||||
int usb_serial3_write_buffer_free(void) | |||||
{ | |||||
uint32_t len; | |||||
tx_noautoflush = 1; | |||||
if (!tx_packet) { | |||||
if (!usb_configuration || | |||||
usb_tx_packet_count(CDC3_TX_ENDPOINT) >= TX_PACKET_LIMIT || | |||||
(tx_packet = usb_malloc()) == NULL) { | |||||
tx_noautoflush = 0; | |||||
return 0; | |||||
} | |||||
} | |||||
len = CDC3_TX_SIZE - tx_packet->index; | |||||
// TODO: Perhaps we need "usb_cdc_transmit_flush_timer = TRANSMIT_FLUSH_TIMEOUT" | |||||
// added here, so the SOF interrupt can't take away the available buffer | |||||
// space we just promised the user could write without blocking? | |||||
// But does this come with other performance downsides? Could it lead to | |||||
// buffer data never actually transmitting in some usage cases? More | |||||
// investigation is needed. | |||||
// https://github.com/PaulStoffregen/cores/issues/10#issuecomment-61514955 | |||||
tx_noautoflush = 0; | |||||
return len; | |||||
} | |||||
void usb_serial3_flush_output(void) | |||||
{ | |||||
if (!usb_configuration) return; | |||||
tx_noautoflush = 1; | |||||
if (tx_packet) { | |||||
usb_cdc3_transmit_flush_timer = 0; | |||||
tx_packet->len = tx_packet->index; | |||||
usb_tx(CDC3_TX_ENDPOINT, tx_packet); | |||||
tx_packet = NULL; | |||||
} else { | |||||
usb_packet_t *tx = usb_malloc(); | |||||
if (tx) { | |||||
usb_cdc3_transmit_flush_timer = 0; | |||||
usb_tx(CDC3_TX_ENDPOINT, tx); | |||||
} else { | |||||
usb_cdc3_transmit_flush_timer = 1; | |||||
} | |||||
} | |||||
tx_noautoflush = 0; | |||||
} | |||||
void usb_serial3_flush_callback(void) | |||||
{ | |||||
if (tx_noautoflush) return; | |||||
if (tx_packet) { | |||||
tx_packet->len = tx_packet->index; | |||||
usb_tx(CDC3_TX_ENDPOINT, tx_packet); | |||||
tx_packet = NULL; | |||||
} else { | |||||
usb_packet_t *tx = usb_malloc(); | |||||
if (tx) { | |||||
usb_tx(CDC3_TX_ENDPOINT, tx); | |||||
} else { | |||||
usb_cdc3_transmit_flush_timer = 1; | |||||
} | |||||
} | |||||
} | |||||
#endif // F_CPU | |||||
#endif // CDC3_STATUS_INTERFACE && CDC3_DATA_INTERFACE |
#include "usb_desc.h" | #include "usb_desc.h" | ||||
#if defined(CDC2_STATUS_INTERFACE) && defined(CDC2_DATA_INTERFACE) | #if defined(CDC2_STATUS_INTERFACE) && defined(CDC2_DATA_INTERFACE) | ||||
#define USB_SERIAL_SUFFIX 2 | |||||
#define SERIAL_CLASS_SUFFIX A | |||||
#include "usb_serial_template.h" | |||||
#include <inttypes.h> | |||||
#define usb_cdc2_line_coding usb_serial2_instance.cdc_line_coding | |||||
#define usb_cdc2_line_rtsdtr_millis usb_serial2_instance.cdc_line_rtsdtr_millis | |||||
#define usb_cdc2_line_rtsdtr usb_serial2_instance.cdc_line_rtsdtr | |||||
#define usb_cdc2_transmit_flush_timer usb_serial2_instance.cdc_transmit_flush_timer | |||||
#endif // CDC_STATUS_INTERFACE && CDC_DATA_INTERFACE | |||||
#if F_CPU >= 20000000 | |||||
#include "core_pins.h" // for millis() | |||||
// C language implementation | |||||
#ifdef __cplusplus | |||||
extern "C" { | |||||
#endif | |||||
int usb_serial2_getchar(void); | |||||
int usb_serial2_peekchar(void); | |||||
int usb_serial2_available(void); | |||||
int usb_serial2_read(void *buffer, uint32_t size); | |||||
void usb_serial2_flush_input(void); | |||||
int usb_serial2_putchar(uint8_t c); | |||||
int usb_serial2_write(const void *buffer, uint32_t size); | |||||
int usb_serial2_write_buffer_free(void); | |||||
void usb_serial2_flush_output(void); | |||||
void usb_serial2_flush_callback(void); | |||||
extern uint32_t usb_cdc2_line_coding[2]; | |||||
extern volatile uint32_t usb_cdc2_line_rtsdtr_millis; | |||||
extern volatile uint32_t systick_millis_count; | |||||
extern volatile uint8_t usb_cdc2_line_rtsdtr; | |||||
extern volatile uint8_t usb_cdc2_transmit_flush_timer; | |||||
extern volatile uint8_t usb_configuration; | |||||
#ifdef __cplusplus | |||||
} | |||||
#endif | |||||
#ifndef USB_SERIAL_DTR | |||||
#define USB_SERIAL_DTR 0x01 | |||||
#endif | |||||
#ifndef USB_SERIAL_RTS | |||||
#define USB_SERIAL_RTS 0x02 | |||||
#endif | |||||
// C++ interface | |||||
#ifdef __cplusplus | |||||
#include "Stream.h" | |||||
class usb_serial2_class : public Stream | |||||
{ | |||||
public: | |||||
constexpr usb_serial2_class() {} | |||||
void begin(long) { | |||||
//uint32_t millis_begin = systick_millis_count; | |||||
//disabled for now - causes more trouble than it solves? | |||||
//while (!(*this)) { | |||||
// wait up to 2.5 seconds for Arduino Serial Monitor | |||||
// Yes, this is a long time, but some Windows systems open | |||||
// the port very slowly. This wait allows programs for | |||||
// Arduino Uno to "just work" (without forcing a reboot when | |||||
// the port is opened), and when no PC is connected the user's | |||||
// sketch still gets to run normally after this wait time. | |||||
//if ((uint32_t)(systick_millis_count - millis_begin) > 2500) break; | |||||
//} | |||||
} | |||||
void end() { /* TODO: flush output and shut down USB port */ }; | |||||
virtual int available() { return usb_serial2_available(); } | |||||
virtual int read() { return usb_serial2_getchar(); } | |||||
virtual int peek() { return usb_serial2_peekchar(); } | |||||
virtual void flush() { usb_serial2_flush_output(); } // TODO: actually wait for data to leave USB... | |||||
virtual void clear(void) { usb_serial2_flush_input(); } | |||||
virtual size_t write(uint8_t c) { return usb_serial2_putchar(c); } | |||||
virtual size_t write(const uint8_t *buffer, size_t size) { return usb_serial2_write(buffer, size); } | |||||
size_t write(unsigned long n) { return write((uint8_t)n); } | |||||
size_t write(long n) { return write((uint8_t)n); } | |||||
size_t write(unsigned int n) { return write((uint8_t)n); } | |||||
size_t write(int n) { return write((uint8_t)n); } | |||||
virtual int availableForWrite() { return usb_serial2_write_buffer_free(); } | |||||
using Print::write; | |||||
void send_now(void) { usb_serial2_flush_output(); } | |||||
uint32_t baud(void) { return usb_cdc2_line_coding[0]; } | |||||
uint8_t stopbits(void) { uint8_t b = usb_cdc2_line_coding[1]; if (!b) b = 1; return b; } | |||||
uint8_t paritytype(void) { return usb_cdc2_line_coding[1] >> 8; } // 0=none, 1=odd, 2=even | |||||
uint8_t numbits(void) { return usb_cdc2_line_coding[1] >> 16; } | |||||
uint8_t dtr(void) { return (usb_cdc2_line_rtsdtr & USB_SERIAL_DTR) ? 1 : 0; } | |||||
uint8_t rts(void) { return (usb_cdc2_line_rtsdtr & USB_SERIAL_RTS) ? 1 : 0; } | |||||
operator bool() { return usb_configuration && (usb_cdc2_line_rtsdtr & USB_SERIAL_DTR) && | |||||
((uint32_t)(systick_millis_count - usb_cdc2_line_rtsdtr_millis) >= 15); | |||||
} | |||||
size_t readBytes(char *buffer, size_t length) { | |||||
size_t count=0; | |||||
unsigned long startMillis = millis(); | |||||
do { | |||||
count += usb_serial2_read(buffer + count, length - count); | |||||
if (count >= length) return count; | |||||
} while(millis() - startMillis < _timeout); | |||||
setReadError(); | |||||
return count; | |||||
} | |||||
}; | |||||
extern usb_serial2_class SerialA; | |||||
extern void serialEventA(void); | |||||
#endif // __cplusplus | |||||
#endif // F_CPU | |||||
#endif // CDC2_STATUS_INTERFACE && CDC2_DATA_INTERFACE | |||||
#endif // USBserial2_h_ | #endif // USBserial2_h_ |
*/ | */ | ||||
#include "usb_dev.h" | #include "usb_dev.h" | ||||
#include "usb_serial2.h" | |||||
#include "core_pins.h" // for yield() | |||||
//#include "HardwareSerial.h" | |||||
#include <string.h> // for memcpy() | |||||
// defined by usb_dev.h -> usb_desc.h | // defined by usb_dev.h -> usb_desc.h | ||||
#if defined(CDC3_STATUS_INTERFACE) && defined(CDC3_DATA_INTERFACE) | |||||
#if defined(CDC2_STATUS_INTERFACE) && defined(CDC2_DATA_INTERFACE) | |||||
#if F_CPU >= 20000000 | #if F_CPU >= 20000000 | ||||
#include "usb_serial_port.h" | |||||
struct usb_serial_port usb_serial3_instance = { | |||||
.cdc_rx_endpoint = CDC3_RX_ENDPOINT, | |||||
.cdc_tx_endpoint = CDC3_TX_ENDPOINT, | |||||
.cdc_tx_size = CDC3_TX_SIZE, | |||||
}; | |||||
uint32_t usb_cdc2_line_coding[2]; | |||||
volatile uint32_t usb_cdc2_line_rtsdtr_millis; | |||||
volatile uint8_t usb_cdc2_line_rtsdtr=0; | |||||
volatile uint8_t usb_cdc2_transmit_flush_timer=0; | |||||
static usb_packet_t *rx_packet=NULL; | |||||
static usb_packet_t *tx_packet=NULL; | |||||
static volatile uint8_t tx_noautoflush=0; | |||||
#define TRANSMIT_FLUSH_TIMEOUT 5 /* in milliseconds */ | |||||
// get the next character, or -1 if nothing received | |||||
int usb_serial2_getchar(void) | |||||
{ | |||||
unsigned int i; | |||||
int c; | |||||
if (!rx_packet) { | |||||
if (!usb_configuration) return -1; | |||||
rx_packet = usb_rx(CDC2_RX_ENDPOINT); | |||||
if (!rx_packet) return -1; | |||||
} | |||||
i = rx_packet->index; | |||||
c = rx_packet->buf[i++]; | |||||
if (i >= rx_packet->len) { | |||||
usb_free(rx_packet); | |||||
rx_packet = NULL; | |||||
} else { | |||||
rx_packet->index = i; | |||||
} | |||||
return c; | |||||
} | |||||
// peek at the next character, or -1 if nothing received | |||||
int usb_serial2_peekchar(void) | |||||
{ | |||||
if (!rx_packet) { | |||||
if (!usb_configuration) return -1; | |||||
rx_packet = usb_rx(CDC2_RX_ENDPOINT); | |||||
if (!rx_packet) return -1; | |||||
} | |||||
if (!rx_packet) return -1; | |||||
return rx_packet->buf[rx_packet->index]; | |||||
} | |||||
// number of bytes available in the receive buffer | |||||
int usb_serial2_available(void) | |||||
{ | |||||
int count; | |||||
count = usb_rx_byte_count(CDC2_RX_ENDPOINT); | |||||
if (rx_packet) count += rx_packet->len - rx_packet->index; | |||||
return count; | |||||
} | |||||
// read a block of bytes to a buffer | |||||
int usb_serial2_read(void *buffer, uint32_t size) | |||||
{ | |||||
uint8_t *p = (uint8_t *)buffer; | |||||
uint32_t qty, count=0; | |||||
while (size) { | |||||
if (!usb_configuration) break; | |||||
if (!rx_packet) { | |||||
rx: | |||||
rx_packet = usb_rx(CDC2_RX_ENDPOINT); | |||||
if (!rx_packet) break; | |||||
if (rx_packet->len == 0) { | |||||
usb_free(rx_packet); | |||||
goto rx; | |||||
} | |||||
} | |||||
qty = rx_packet->len - rx_packet->index; | |||||
if (qty > size) qty = size; | |||||
memcpy(p, rx_packet->buf + rx_packet->index, qty); | |||||
p += qty; | |||||
count += qty; | |||||
size -= qty; | |||||
rx_packet->index += qty; | |||||
if (rx_packet->index >= rx_packet->len) { | |||||
usb_free(rx_packet); | |||||
rx_packet = NULL; | |||||
} | |||||
} | |||||
return count; | |||||
} | |||||
// discard any buffered input | |||||
void usb_serial2_flush_input(void) | |||||
{ | |||||
usb_packet_t *rx; | |||||
if (!usb_configuration) return; | |||||
if (rx_packet) { | |||||
usb_free(rx_packet); | |||||
rx_packet = NULL; | |||||
} | |||||
while (1) { | |||||
rx = usb_rx(CDC2_RX_ENDPOINT); | |||||
if (!rx) break; | |||||
usb_free(rx); | |||||
} | |||||
} | |||||
// Maximum number of transmit packets to queue so we don't starve other endpoints for memory | |||||
#define TX_PACKET_LIMIT 8 | |||||
// When the PC isn't listening, how long do we wait before discarding data? If this is | |||||
// too short, we risk losing data during the stalls that are common with ordinary desktop | |||||
// software. If it's too long, we stall the user's program when no software is running. | |||||
#define TX_TIMEOUT_MSEC 70 | |||||
#if F_CPU == 256000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1706) | |||||
#elif F_CPU == 240000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1600) | |||||
#elif F_CPU == 216000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1440) | |||||
#elif F_CPU == 192000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1280) | |||||
#elif F_CPU == 180000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1200) | |||||
#elif F_CPU == 168000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 1100) | |||||
#elif F_CPU == 144000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 932) | |||||
#elif F_CPU == 120000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 764) | |||||
#elif F_CPU == 96000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 596) | |||||
#elif F_CPU == 72000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 512) | |||||
#elif F_CPU == 48000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 428) | |||||
#elif F_CPU == 24000000 | |||||
#define TX_TIMEOUT (TX_TIMEOUT_MSEC * 262) | |||||
#endif | #endif | ||||
#endif // CDC3_STATUS_INTERFACE && CDC3_DATA_INTERFACE | |||||
// When we've suffered the transmit timeout, don't wait again until the computer | |||||
// begins accepting data. If no software is running to receive, we'll just discard | |||||
// data as rapidly as Serial.print() can generate it, until there's something to | |||||
// actually receive it. | |||||
static uint8_t transmit_previous_timeout=0; | |||||
// transmit a character. 0 returned on success, -1 on error | |||||
int usb_serial2_putchar(uint8_t c) | |||||
{ | |||||
return usb_serial2_write(&c, 1); | |||||
} | |||||
int usb_serial2_write(const void *buffer, uint32_t size) | |||||
{ | |||||
uint32_t ret = size; | |||||
uint32_t len; | |||||
uint32_t wait_count; | |||||
const uint8_t *src = (const uint8_t *)buffer; | |||||
uint8_t *dest; | |||||
tx_noautoflush = 1; | |||||
while (size > 0) { | |||||
if (!tx_packet) { | |||||
wait_count = 0; | |||||
while (1) { | |||||
if (!usb_configuration) { | |||||
tx_noautoflush = 0; | |||||
return -1; | |||||
} | |||||
if (usb_tx_packet_count(CDC2_TX_ENDPOINT) < TX_PACKET_LIMIT) { | |||||
tx_noautoflush = 1; | |||||
tx_packet = usb_malloc(); | |||||
if (tx_packet) break; | |||||
tx_noautoflush = 0; | |||||
} | |||||
if (++wait_count > TX_TIMEOUT || transmit_previous_timeout) { | |||||
transmit_previous_timeout = 1; | |||||
return -1; | |||||
} | |||||
yield(); | |||||
} | |||||
} | |||||
transmit_previous_timeout = 0; | |||||
len = CDC2_TX_SIZE - tx_packet->index; | |||||
if (len > size) len = size; | |||||
dest = tx_packet->buf + tx_packet->index; | |||||
tx_packet->index += len; | |||||
size -= len; | |||||
while (len-- > 0) *dest++ = *src++; | |||||
if (tx_packet->index >= CDC2_TX_SIZE) { | |||||
tx_packet->len = CDC2_TX_SIZE; | |||||
usb_tx(CDC2_TX_ENDPOINT, tx_packet); | |||||
tx_packet = NULL; | |||||
} | |||||
usb_cdc2_transmit_flush_timer = TRANSMIT_FLUSH_TIMEOUT; | |||||
} | |||||
tx_noautoflush = 0; | |||||
return ret; | |||||
} | |||||
int usb_serial2_write_buffer_free(void) | |||||
{ | |||||
uint32_t len; | |||||
tx_noautoflush = 1; | |||||
if (!tx_packet) { | |||||
if (!usb_configuration || | |||||
usb_tx_packet_count(CDC2_TX_ENDPOINT) >= TX_PACKET_LIMIT || | |||||
(tx_packet = usb_malloc()) == NULL) { | |||||
tx_noautoflush = 0; | |||||
return 0; | |||||
} | |||||
} | |||||
len = CDC2_TX_SIZE - tx_packet->index; | |||||
// TODO: Perhaps we need "usb_cdc_transmit_flush_timer = TRANSMIT_FLUSH_TIMEOUT" | |||||
// added here, so the SOF interrupt can't take away the available buffer | |||||
// space we just promised the user could write without blocking? | |||||
// But does this come with other performance downsides? Could it lead to | |||||
// buffer data never actually transmitting in some usage cases? More | |||||
// investigation is needed. | |||||
// https://github.com/PaulStoffregen/cores/issues/10#issuecomment-61514955 | |||||
tx_noautoflush = 0; | |||||
return len; | |||||
} | |||||
void usb_serial2_flush_output(void) | |||||
{ | |||||
if (!usb_configuration) return; | |||||
tx_noautoflush = 1; | |||||
if (tx_packet) { | |||||
usb_cdc2_transmit_flush_timer = 0; | |||||
tx_packet->len = tx_packet->index; | |||||
usb_tx(CDC2_TX_ENDPOINT, tx_packet); | |||||
tx_packet = NULL; | |||||
} else { | |||||
usb_packet_t *tx = usb_malloc(); | |||||
if (tx) { | |||||
usb_cdc2_transmit_flush_timer = 0; | |||||
usb_tx(CDC2_TX_ENDPOINT, tx); | |||||
} else { | |||||
usb_cdc2_transmit_flush_timer = 1; | |||||
} | |||||
} | |||||
tx_noautoflush = 0; | |||||
} | |||||
void usb_serial2_flush_callback(void) | |||||
{ | |||||
if (tx_noautoflush) return; | |||||
if (tx_packet) { | |||||
tx_packet->len = tx_packet->index; | |||||
usb_tx(CDC2_TX_ENDPOINT, tx_packet); | |||||
tx_packet = NULL; | |||||
} else { | |||||
usb_packet_t *tx = usb_malloc(); | |||||
if (tx) { | |||||
usb_tx(CDC2_TX_ENDPOINT, tx); | |||||
} else { | |||||
usb_cdc2_transmit_flush_timer = 1; | |||||
} | |||||
} | |||||
} | |||||
#endif // F_CPU | |||||
#endif // CDC2_STATUS_INTERFACE && CDC2_DATA_INTERFACE |
#include "usb_desc.h" | #include "usb_desc.h" | ||||
#if defined(CDC3_STATUS_INTERFACE) && defined(CDC3_DATA_INTERFACE) | #if defined(CDC3_STATUS_INTERFACE) && defined(CDC3_DATA_INTERFACE) | ||||
#define USB_SERIAL_SUFFIX 3 | |||||
#define SERIAL_CLASS_SUFFIX B | |||||
#include "usb_serial_template.h" | |||||
#include <inttypes.h> | |||||
#define usb_cdc3_line_coding usb_serial3_instance.cdc_line_coding | |||||
#define usb_cdc3_line_rtsdtr_millis usb_serial3_instance.cdc_line_rtsdtr_millis | |||||
#define usb_cdc3_line_rtsdtr usb_serial3_instance.cdc_line_rtsdtr | |||||
#define usb_cdc3_transmit_flush_timer usb_serial3_instance.cdc_transmit_flush_timer | |||||
#endif // CDC_STATUS_INTERFACE && CDC_DATA_INTERFACE | |||||
#if F_CPU >= 20000000 | |||||
#include "core_pins.h" // for millis() | |||||
// C language implementation | |||||
#ifdef __cplusplus | |||||
extern "C" { | |||||
#endif | |||||
int usb_serial3_getchar(void); | |||||
int usb_serial3_peekchar(void); | |||||
int usb_serial3_available(void); | |||||
int usb_serial3_read(void *buffer, uint32_t size); | |||||
void usb_serial3_flush_input(void); | |||||
int usb_serial3_putchar(uint8_t c); | |||||
int usb_serial3_write(const void *buffer, uint32_t size); | |||||
int usb_serial3_write_buffer_free(void); | |||||
void usb_serial3_flush_output(void); | |||||
void usb_serial3_flush_callback(void); | |||||
extern uint32_t usb_cdc3_line_coding[2]; | |||||
extern volatile uint32_t usb_cdc3_line_rtsdtr_millis; | |||||
extern volatile uint32_t systick_millis_count; | |||||
extern volatile uint8_t usb_cdc3_line_rtsdtr; | |||||
extern volatile uint8_t usb_cdc3_transmit_flush_timer; | |||||
extern volatile uint8_t usb_configuration; | |||||
#ifdef __cplusplus | |||||
} | |||||
#endif | |||||
#ifndef USB_SERIAL_DTR | |||||
#define USB_SERIAL_DTR 0x01 | |||||
#endif | |||||
#ifndef USB_SERIAL_RTS | |||||
#define USB_SERIAL_RTS 0x02 | |||||
#endif | |||||
// C++ interface | |||||
#ifdef __cplusplus | |||||
#include "Stream.h" | |||||
class usb_serial3_class : public Stream | |||||
{ | |||||
public: | |||||
constexpr usb_serial3_class() {} | |||||
void begin(long) { | |||||
//uint32_t millis_begin = systick_millis_count; | |||||
//disabled for now - causes more trouble than it solves? | |||||
//while (!(*this)) { | |||||
// wait up to 2.5 seconds for Arduino Serial Monitor | |||||
// Yes, this is a long time, but some Windows systems open | |||||
// the port very slowly. This wait allows programs for | |||||
// Arduino Uno to "just work" (without forcing a reboot when | |||||
// the port is opened), and when no PC is connected the user's | |||||
// sketch still gets to run normally after this wait time. | |||||
//if ((uint32_t)(systick_millis_count - millis_begin) > 2500) break; | |||||
//} | |||||
} | |||||
void end() { /* TODO: flush output and shut down USB port */ }; | |||||
virtual int available() { return usb_serial3_available(); } | |||||
virtual int read() { return usb_serial3_getchar(); } | |||||
virtual int peek() { return usb_serial3_peekchar(); } | |||||
virtual void flush() { usb_serial3_flush_output(); } // TODO: actually wait for data to leave USB... | |||||
virtual void clear(void) { usb_serial3_flush_input(); } | |||||
virtual size_t write(uint8_t c) { return usb_serial3_putchar(c); } | |||||
virtual size_t write(const uint8_t *buffer, size_t size) { return usb_serial3_write(buffer, size); } | |||||
size_t write(unsigned long n) { return write((uint8_t)n); } | |||||
size_t write(long n) { return write((uint8_t)n); } | |||||
size_t write(unsigned int n) { return write((uint8_t)n); } | |||||
size_t write(int n) { return write((uint8_t)n); } | |||||
virtual int availableForWrite() { return usb_serial3_write_buffer_free(); } | |||||
using Print::write; | |||||
void send_now(void) { usb_serial3_flush_output(); } | |||||
uint32_t baud(void) { return usb_cdc3_line_coding[0]; } | |||||
uint8_t stopbits(void) { uint8_t b = usb_cdc3_line_coding[1]; if (!b) b = 1; return b; } | |||||
uint8_t paritytype(void) { return usb_cdc3_line_coding[1] >> 8; } // 0=none, 1=odd, 2=even | |||||
uint8_t numbits(void) { return usb_cdc3_line_coding[1] >> 16; } | |||||
uint8_t dtr(void) { return (usb_cdc3_line_rtsdtr & USB_SERIAL_DTR) ? 1 : 0; } | |||||
uint8_t rts(void) { return (usb_cdc3_line_rtsdtr & USB_SERIAL_RTS) ? 1 : 0; } | |||||
operator bool() { return usb_configuration && (usb_cdc3_line_rtsdtr & USB_SERIAL_DTR) && | |||||
((uint32_t)(systick_millis_count - usb_cdc3_line_rtsdtr_millis) >= 15); | |||||
} | |||||
size_t readBytes(char *buffer, size_t length) { | |||||
size_t count=0; | |||||
unsigned long startMillis = millis(); | |||||
do { | |||||
count += usb_serial3_read(buffer + count, length - count); | |||||
if (count >= length) return count; | |||||
} while(millis() - startMillis < _timeout); | |||||
setReadError(); | |||||
return count; | |||||
} | |||||
}; | |||||
extern usb_serial3_class SerialB; | |||||
extern void serialEventB(void); | |||||
#endif // __cplusplus | |||||
#endif // F_CPU | |||||
#endif // CDC3_STATUS_INTERFACE && CDC3_DATA_INTERFACE | |||||
#endif // USBserial3_h_ | #endif // USBserial3_h_ |