Add files via upload

Author: Serialcomms

lib_usb_cdc_serial_debug/API_usb_serial.c

@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2024 Serialcomms (GitHub).
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+
+#include <stdio.h>
+#include "pico/stdlib.h"
+#include "include/USB_vcp.h"
+#include "API_usb_serial.h"
+#include "include/USB_initialise.h"
+#include "include/USB_com_port_signalling.h"
+
+void usb_start_serial(bool set_cr_lf, bool set_exclusive) {
+
+    usb_device_init();
+
+    usb_insert_device();
+
+    busy_wait_ms(333);
+
+    init_usb_vcp_serial(set_cr_lf, set_exclusive);
+
+}
+
+void usb_stop_serial() {
+  
+  stdio_set_chars_available_callback(NULL, NULL);
+  
+  stdio_set_driver_enabled(&virtual_com_port, false);
+
+  usb_remove_device();
+
+}
+
+void set_com_port_dcd(bool dcd_state) {
+
+  com_port_set_dcd(dcd_state);   
+
+}
+
+void set_com_port_dsr(bool dsr_state) {
+
+  com_port_set_dsr(dsr_state);   
+
+}
+
+void set_com_port_ring(bool ring_state) {
+
+  com_port_set_ring(ring_state);   
+
+}
+
+bool get_com_port_dtr() {
+
+  return com_port_get_dtr();
+
+}
+
+bool get_com_port_rts() {
+
+  return com_port_get_rts();
+
+}
+
+bool get_cdc_configuration_set() {
+
+  return CDC_CONFIGURATION_SET;
+
+}

lib_usb_cdc_serial_debug/API_usb_serial.h

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2024 Serialcomms (GitHub).
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+
+#include "pico/stdlib.h"
+
+extern bool CDC_CONFIGURATION_SET;
+
+void usb_start_serial(bool set_cr_lf, bool set_exclusive);
+void usb_stop_serial();
+
+void set_com_port_dcd(bool dcd_state);
+void set_com_port_dsr(bool dsr_state);
+void set_com_port_ring(bool ring_state);
+
+bool get_com_port_dtr();
+bool get_com_port_rts(); 
+
+bool get_cdc_configuration_set();

lib_usb_cdc_serial_debug/CMakeLists.txt

@@ -0,0 +1,51 @@
+add_library(lib_usb_cdc_serial INTERFACE)
+
+target_sources(lib_usb_cdc_serial INTERFACE
+
+API_usb_serial.c
+USB_EP0_handlers.c 
+USB_EP1_handlers.c 
+USB_EP2_handlers.c 
+USB_buffer_completion.c 
+USB_buffer_control.c 
+USB_build_endpoints.c 
+USB_bus_reset.c
+USB_cdc_line_coding.c 
+USB_cdc_line_control.c 
+USB_com_port_framing.c 
+USB_com_port_signalling.c 
+USB_data_packet.c 
+USB_descriptor_config.c 
+USB_descriptor_device.c 
+USB_endpoints_host.c 
+USB_endpoints_pico.c 
+USB_error.c
+USB_initialise.c 
+USB_interrupts.c
+USB_queue_control.c  
+USB_queue_receive.c 
+USB_queue_transmit.c
+USB_set_configuration.c 
+USB_setup_address.c 
+USB_setup_class_cdc.c
+USB_setup_control.c 
+USB_setup_descriptors.c 
+USB_setup_device.c
+USB_setup_endpoint.c
+USB_setup_interface.c
+USB_setup_packet.c 
+USB_setup_strings.c
+USB_setup_type_class.c 
+USB_setup_type_standard.c
+USB_sie_errors.c 
+USB_sie_status.c 
+USB_vcp.c 
+# debug version only below
+USB_uart_printf.c 
+USB_setup_show.c  
+USB_debug_show.c 
+)
+
+message("--------------------------------------------------------------")
+message("-- Building serialcomms library lib_usb_cdc_serial    (debug) ")
+message("--------------------------------------------------------------")

lib_usb_cdc_serial_debug/USB_EP0_handlers.c

@@ -0,0 +1,110 @@
+/*
+ * Copyright (c) 2024 Serialcomms (GitHub).
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+#include <stdio.h>
+#include "pico/stdlib.h"
+#include "pico/util/queue.h"
+#include "hardware/structs/usb.h" 
+#include "include/USB_buffer_control.h"
+#include "include/USB_endpoints_pico.h"
+#include "include/USB_EP0_handlers.h"
+#include "include/USB_data_packet.h" 
+#include "include/USB_setup_control.h" 
+#include "include/USB_queue_control.h" 
+#include "include/USB_queue_receive.h"
+#include "include/USB_queue_transmit.h"
+#include "include/USB_endpoint_struct.h"
+#include "include/USB_debug_show.h"
+#include "include/USB_uart_printf.h"
+
+void ep0_handler_to_host(uint8_t EP_NUMBER) {
+
+  clear_buffer_status(USB_BUFF_STATUS_EP0_IN_BITS); 
+
+  toggle_next_data_pid_to_host(0);
+
+  uint16_t bytes_remaining = get_queue_level_to_host(0); 
+
+  uart_printf("EP%d handler to Host, clearing buffer status, buffer bytes=%d, queue bytes=%d, last PID=%d\n\r", 
+  0, get_buffer_control_transfer_bytes_to_host(0), get_queue_level_to_host(0), get_last_data_pid_to_host(0));
+
+  if (bytes_remaining) {
+
+    ep0_queue_runner_to_host();
+
+  } else {
+
+    end_pico_to_host_control_transfer();
+  
+  }
+
+}  
+
+static inline void ep0_queue_runner_to_host() {
+
+  bool queue_remove_result;
+  uint8_t source_data_byte;
+  uint16_t source_data_offset = 0;
+  uint8_t *endpoint_buffer = host_endpoint[0].dpram_address;
+
+  uart_printf("%s Queue Length = %d\n\r", __func__, queue_get_level(&host_endpoint[0].data_queue));
+
+  do {
+
+    queue_remove_result = queue_try_remove_to_host(0, &source_data_byte); 
+
+    if (queue_remove_result) endpoint_buffer[source_data_offset++] = source_data_byte;
+    
+  } while (queue_remove_result && source_data_offset < host_endpoint[0].max_packet_size);
+
+  uart_printf("Continue Queued Transfer, data count = %d\n\r", source_data_offset);
+
+  if (source_data_offset) start_async_send_data_packet(0, source_data_offset);
+
+}
+
+// ---------------------------------------------------------------------------------------------------------
+
+void ep0_handler_to_pico(uint8_t EP_NUMBER) {
+
+  clear_buffer_status(USB_BUFF_STATUS_EP0_OUT_BITS); 
+
+  toggle_next_data_pid_to_pico(0);
+
+  pico_endpoint[0].transfer_bytes = get_buffer_control_transfer_bytes_to_pico(0);
+
+  uart_printf("EP%d handler to Pico, clearing buffer status, buffer bytes=%d, queue level=%d, last PID=%d\n\r", 
+  0, 
+  get_buffer_control_transfer_bytes_to_pico(0), 
+  get_queue_level_to_pico(0), 
+  get_last_data_pid_to_pico(0));
+
+  show_dpram_ep0(); 
+
+  if (get_pico_callback_handler(0)) run_pico_callback_handler();
+
+}
+
+static inline void run_pico_callback_handler() {
+
+  uart_printf("Buffer Status, special case for EP0 CDC control transfer data, callback=%08X \n\r", pico_endpoint[0].callback_handler);      
+
+  void* buffer = pico_endpoint[0].dpram_address;
+
+  uint16_t transfer_bytes = pico_endpoint[0].transfer_bytes;
+
+  endpoint_callback_handler pico_callback = get_pico_callback_handler(0);
+
+  pico_callback(buffer, transfer_bytes);
+
+  set_pico_callback_handler(0, NULL);
+
+}
+
+static inline void clear_buffer_status (uint32_t buffer_mask) {
+
+  usb_hardware_clear->buf_status = buffer_mask;
+ 
+}

lib_usb_cdc_serial_debug/USB_EP1_handlers.c

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2024 Serialcomms (GitHub).
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+
+#include <stdio.h>
+#include "pico/stdlib.h"
+
+#include "hardware/structs/usb.h"           // USB hardware struct definitions
+#include "include/USB_endpoint_struct.h"
+#include "include/USB_queue_transmit.h"
+#include "include/USB_buffer_control.h"
+#include "include/USB_queue_control.h"
+#include "include/USB_EP1_handlers.h"
+#include "include/USB_uart_printf.h"
+
+void ep1_handler_to_host () {
+
+    clear_buffer_status(USB_BUFF_STATUS_EP1_IN_BITS); 
+
+    toggle_next_data_pid_to_host(1);
+
+    set_queue_busy_to_host(1, false);
+
+    uart_printf("EP1 handler to Host, clearing buffer status\n\r");
+ 
+}
+
+static inline void clear_buffer_status (uint32_t buffer_mask) {
+
+    usb_hardware_clear->buf_status = buffer_mask;
+  
+}