/* * Support for Atmel AT45DB series DataFlash chips. * This file is part of the flashrom project. * * Copyright (C) 2012 Aidan Thornton * Copyright (C) 2013 Stefan Tauner * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; version 2 of the License. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. */ #include #include "flash.h" #include "chipdrivers.h" #include "programmer.h" #include "spi.h" /* Status register bits */ #define AT45DB_READY (1<<7) #define AT45DB_CMP (1<<6) #define AT45DB_PROT (1<<1) #define AT45DB_POWEROF2 (1<<0) /* Opcodes */ #define AT45DB_STATUS 0xD7 /* NB: this is a block erase command on most other chips(!). */ #define AT45DB_DISABLE_PROTECT 0x3D, 0x2A, 0x7F, 0x9A #define AT45DB_READ_ARRAY 0xE8 #define AT45DB_READ_PROTECT 0x32 #define AT45DB_READ_LOCKDOWN 0x35 #define AT45DB_PAGE_ERASE 0x81 #define AT45DB_BLOCK_ERASE 0x50 #define AT45DB_SECTOR_ERASE 0x7C #define AT45DB_CHIP_ERASE 0xC7 #define AT45DB_CHIP_ERASE_ADDR 0x94809A /* Magic address. See usage. */ #define AT45DB_BUFFER1_WRITE 0x84 #define AT45DB_BUFFER1_PAGE_PROGRAM 0x88 /* Buffer 2 is unused yet. #define AT45DB_BUFFER2_WRITE 0x87 #define AT45DB_BUFFER2_PAGE_PROGRAM 0x89 */ static uint8_t at45db_read_status_register(struct flashctx *flash, uint8_t *status) { static const uint8_t cmd[] = { AT45DB_STATUS }; int ret = spi_send_command(flash, sizeof(cmd), 1, cmd, status); if (ret != 0) msg_cerr("Reading the status register failed!\n"); else msg_cspew("Status register: 0x%02x.\n", *status); return ret; } int spi_disable_blockprotect_at45db(struct flashctx *flash) { static const uint8_t cmd[4] = { AT45DB_DISABLE_PROTECT }; /* NB: 4 bytes magic number */ int ret = spi_send_command(flash, sizeof(cmd), 0, cmd, NULL); if (ret != 0) { msg_cerr("Sending disable lockdown failed!\n"); return ret; } uint8_t status; ret = at45db_read_status_register(flash, &status); if (ret != 0 || ((status & AT45DB_PROT) != 0)) { msg_cerr("Disabling lockdown failed!\n"); return 1; } return 0; } static unsigned int at45db_get_sector_count(struct flashctx *flash) { unsigned int i, j; unsigned int cnt = 0; for (i = 0; i < NUM_ERASEFUNCTIONS; i++) { const struct block_eraser *const eraser = &flash->chip->block_erasers[i]; if (eraser->block_erase == SPI_ERASE_AT45DB_SECTOR) { for (j = 0; j < NUM_ERASEREGIONS; j++) { cnt += eraser->eraseblocks[j].count; } } } msg_cspew("%s: number of sectors=%u\n", __func__, cnt); return cnt; } /* Reads and prettyprints protection/lockdown registers. * Some elegance of the printouts had to be cut down a bit to share this code. */ static uint8_t at45db_prettyprint_protection_register(struct flashctx *flash, uint8_t opcode, const char *regname) { const uint8_t cmd[] = { opcode, 0, 0, 0 }; const size_t sec_count = at45db_get_sector_count(flash); if (sec_count < 2) return 0; /* The first two sectors share the first result byte. */ uint8_t buf[at45db_get_sector_count(flash) - 1]; int ret = spi_send_command(flash, sizeof(cmd), sizeof(buf), cmd, buf); if (ret != 0) { msg_cerr("Reading the %s register failed!\n", regname); return ret; } unsigned int i; for (i = 0; i < sizeof(buf); i++) { if (buf[i] != 0x00) break; if (i == sizeof(buf) - 1) { msg_cdbg("No Sector is %sed.\n", regname); return 0; } } /* TODO: print which addresses are mapped to (un)locked sectors. */ msg_cdbg("Sector 0a is %s%sed.\n", ((buf[0] & 0xC0) == 0x00) ? "un" : "", regname); msg_cdbg("Sector 0b is %s%sed.\n", ((buf[0] & 0x30) == 0x00) ? "un" : "", regname); for (i = 1; i < sizeof(buf); i++) msg_cdbg("Sector %2u is %s%sed.\n", i, (buf[i] == 0x00) ? "un" : "", regname); return 0; } /* bit 7: busy flag * bit 6: memory/buffer compare result * bit 5-2: density (encoding see below) * bit 1: protection enabled (soft or hard) * bit 0: "power of 2" page size indicator (e.g. 1 means 256B; 0 means 264B) * * 5-2 encoding: bit 2 is always 1, bits 3-5 encode the density as "2^(bits - 1)" in Mb e.g.: * AT45DB161D 1011 16Mb */ int spi_prettyprint_status_register_at45db(struct flashctx *flash) { uint8_t status; if (at45db_read_status_register(flash, &status) != 0) { return 1; } /* AT45DB321C does not support lockdown or a page size of a power of 2... */ const bool isAT45DB321C = (strcmp(flash->chip->name, "AT45DB321C") == 0); msg_cdbg("Chip status register is 0x%02x\n", status); msg_cdbg("Chip status register: Bit 7 / Ready is %sset\n", (status & AT45DB_READY) ? "" : "not "); msg_cdbg("Chip status register: Bit 6 / Compare match is %sset\n", (status & AT45DB_CMP) ? "" : "not "); spi_prettyprint_status_register_bit(status, 5); spi_prettyprint_status_register_bit(status, 4); spi_prettyprint_status_register_bit(status, 3); spi_prettyprint_status_register_bit(status, 2); const uint8_t dens = (status >> 3) & 0x7; /* Bit 2 is always 1, we use the other bits only */ msg_cdbg("Chip status register: Density is %u Mb\n", 1 << (dens - 1)); msg_cdbg("Chip status register: Bit 1 / Protection is %sset\n", (status & AT45DB_PROT) ? "" : "not "); if (isAT45DB321C) spi_prettyprint_status_register_bit(status, 0); else msg_cdbg("Chip status register: Bit 0 / \"Power of 2\" is %sset\n", (status & AT45DB_POWEROF2) ? "" : "not "); if (status & AT45DB_PROT) at45db_prettyprint_protection_register(flash, AT45DB_READ_PROTECT, "protect"); if (!isAT45DB321C) at45db_prettyprint_protection_register(flash, AT45DB_READ_LOCKDOWN, "lock"); return 0; } /* Probe function for AT45DB* chips that support multiple page sizes. */ int probe_spi_at45db(struct flashctx *flash) { uint8_t status; struct flashchip *chip = flash->chip; if (!probe_spi_rdid(flash)) return 0; /* Some AT45DB* chips support two different page sizes each (e.g. 264 and 256 B). In order to tell which * page size this chip has we need to read the status register. */ if (at45db_read_status_register(flash, &status) != 0) return 0; /* We assume sane power-of-2 page sizes and adjust the chip attributes in case this is not the case. */ if ((status & AT45DB_POWEROF2) == 0) { chip->total_size = (chip->total_size / 32) * 33; chip->page_size = (chip->page_size / 32) * 33; unsigned int i, j; for (i = 0; i < NUM_ERASEFUNCTIONS; i++) { struct block_eraser *eraser = &chip->block_erasers[i]; for (j = 0; j < NUM_ERASEREGIONS; j++) { eraser->eraseblocks[j].size = (eraser->eraseblocks[j].size / 32) * 33; } } } switch (chip->page_size) { case 256: chip->gran = write_gran_256bytes; break; case 264: chip->gran = write_gran_264bytes; break; case 512: chip->gran = write_gran_512bytes; break; case 528: chip->gran = write_gran_528bytes; break; case 1024: chip->gran = write_gran_1024bytes; break; case 1056: chip->gran = write_gran_1056bytes; break; default: msg_cerr("%s: unknown page size %d.\n", __func__, chip->page_size); return 0; } msg_cdbg2("%s: total size %i kB, page size %i B\n", __func__, chip->total_size * 1024, chip->page_size); return 1; } /* In case of non-power-of-two page sizes we need to convert the address flashrom uses to the address the * DataFlash chips use. The latter uses a segmented address space where the page address is encoded in the * more significant bits and the offset within the page is encoded in the less significant bits. The exact * partition depends on the page size. */ static unsigned int at45db_convert_addr(unsigned int addr, unsigned int page_size) { unsigned int page_bits = address_to_bits(page_size - 1); unsigned int at45db_addr = ((addr / page_size) << page_bits) | (addr % page_size); msg_cspew("%s: addr=0x%x, page_size=%u, page_bits=%u -> at45db_addr=0x%x\n", __func__, addr, page_size, page_bits, at45db_addr); return at45db_addr; } int spi_read_at45db(struct flashctx *flash, uint8_t *buf, unsigned int addr, unsigned int len) { const unsigned int page_size = flash->chip->page_size; const unsigned int total_size = flash->chip->total_size * 1024; if ((addr + len) > total_size) { msg_cerr("%s: tried to read beyond flash boundary: addr=%u, len=%u, size=%u\n", __func__, addr, len, total_size); return 1; } /* We have to split this up into chunks to fit within the programmer's read size limit, but those * chunks can cross page boundaries. */ const unsigned int max_data_read = flash->mst->spi.max_data_read; const unsigned int max_chunk = (max_data_read > 0) ? max_data_read : page_size; while (len > 0) { unsigned int chunk = min(max_chunk, len); int ret = spi_nbyte_read(flash, at45db_convert_addr(addr, page_size), buf, chunk); if (ret) { msg_cerr("%s: error sending read command!\n", __func__); return ret; } addr += chunk; buf += chunk; len -= chunk; } return 0; } /* Legacy continuous read, used where spi_read_at45db() is not available. * The first 4 (dummy) bytes read need to be discarded. */ int spi_read_at45db_e8(struct flashctx *flash, uint8_t *buf, unsigned int addr, unsigned int len) { const unsigned int page_size = flash->chip->page_size; const unsigned int total_size = flash->chip->total_size * 1024; if ((addr + len) > total_size) { msg_cerr("%s: tried to read beyond flash boundary: addr=%u, len=%u, size=%u\n", __func__, addr, len, total_size); return 1; } /* We have to split this up into chunks to fit within the programmer's read size limit, but those * chunks can cross page boundaries. */ const unsigned int max_data_read = flash->mst->spi.max_data_read; const unsigned int max_chunk = (max_data_read > 0) ? max_data_read : page_size; while (len > 0) { const unsigned int addr_at45 = at45db_convert_addr(addr, page_size); const unsigned char cmd[] = { AT45DB_READ_ARRAY, (addr_at45 >> 16) & 0xff, (addr_at45 >> 8) & 0xff, (addr_at45 >> 0) & 0xff }; /* We need to leave place for 4 dummy bytes and handle them explicitly. */ unsigned int chunk = min(max_chunk, len + 4); uint8_t tmp[chunk]; int ret = spi_send_command(flash, sizeof(cmd), chunk, cmd, tmp); if (ret) { msg_cerr("%s: error sending read command!\n", __func__); return ret; } /* Copy result without dummy bytes into buf and advance address counter respectively. */ memcpy(buf, tmp + 4, chunk - 4); addr += chunk - 4; buf += chunk - 4; len -= chunk - 4; } return 0; } /* Returns 0 when ready, 1 on errors and timeouts. */ static int at45db_wait_ready (struct flashctx *flash, unsigned int us, unsigned int retries) { while (true) { uint8_t status; int ret = at45db_read_status_register(flash, &status); if ((status & AT45DB_READY) == AT45DB_READY) return 0; if (ret != 0 || retries-- == 0) return 1; programmer_delay(flash, us); } } static int at45db_erase(struct flashctx *flash, uint8_t opcode, unsigned int at45db_addr, unsigned int stepsize, unsigned int retries) { const uint8_t cmd[] = { opcode, (at45db_addr >> 16) & 0xff, (at45db_addr >> 8) & 0xff, (at45db_addr >> 0) & 0xff }; /* Send erase command. */ int ret = spi_send_command(flash, sizeof(cmd), 0, cmd, NULL); if (ret != 0) { msg_cerr("%s: error sending erase command!\n", __func__); return ret; } /* Wait for completion. */ ret = at45db_wait_ready(flash, stepsize, retries); if (ret != 0) msg_cerr("%s: chip did not become ready again after sending the erase command!\n", __func__); return ret; } int spi_erase_at45db_page(struct flashctx *flash, unsigned int addr, unsigned int blocklen) { const unsigned int page_size = flash->chip->page_size; const unsigned int total_size = flash->chip->total_size * 1024; if ((addr % page_size) != 0 || (blocklen % page_size) != 0) { msg_cerr("%s: cannot erase partial pages: addr=%u, blocklen=%u\n", __func__, addr, blocklen); return 1; } if ((addr + blocklen) > total_size) { msg_cerr("%s: tried to erase a block beyond flash boundary: addr=%u, blocklen=%u, size=%u\n", __func__, addr, blocklen, total_size); return 1; } /* Needs typically about 35 ms for completion, so let's wait 100 ms in 500 us steps. */ return at45db_erase(flash, AT45DB_PAGE_ERASE, at45db_convert_addr(addr, page_size), 500, 200); } int spi_erase_at45db_block(struct flashctx *flash, unsigned int addr, unsigned int blocklen) { const unsigned int page_size = flash->chip->page_size; const unsigned int total_size = flash->chip->total_size * 1024; if ((addr % page_size) != 0 || (blocklen % page_size) != 0) { // FIXME: should check blocks not pages msg_cerr("%s: cannot erase partial pages: addr=%u, blocklen=%u\n", __func__, addr, blocklen); return 1; } if ((addr + blocklen) > total_size) { msg_cerr("%s: tried to erase a block beyond flash boundary: addr=%u, blocklen=%u, size=%u\n", __func__, addr, blocklen, total_size); return 1; } /* Needs typically between 20 and 100 ms for completion, so let's wait 300 ms in 1 ms steps. */ return at45db_erase(flash, AT45DB_BLOCK_ERASE, at45db_convert_addr(addr, page_size), 1000, 300); } int spi_erase_at45db_sector(struct flashctx *flash, unsigned int addr, unsigned int blocklen) { const unsigned int page_size = flash->chip->page_size; const unsigned int total_size = flash->chip->total_size * 1024; if ((addr % page_size) != 0 || (blocklen % page_size) != 0) { // FIXME: should check sectors not pages msg_cerr("%s: cannot erase partial pages: addr=%u, blocklen=%u\n", __func__, addr, blocklen); return 1; } if ((addr + blocklen) > total_size) { msg_cerr("%s: tried to erase a sector beyond flash boundary: addr=%u, blocklen=%u, size=%u\n", __func__, addr, blocklen, total_size); return 1; } /* Needs typically about 5 s for completion, so let's wait 20 seconds in 200 ms steps. */ return at45db_erase(flash, AT45DB_SECTOR_ERASE, at45db_convert_addr(addr, page_size), 200000, 100); } int spi_erase_at45db_chip(struct flashctx *flash, unsigned int addr, unsigned int blocklen) { const unsigned int total_size = flash->chip->total_size * 1024; if ((addr + blocklen) > total_size) { msg_cerr("%s: tried to erase beyond flash boundary: addr=%u, blocklen=%u, size=%u\n", __func__, addr, blocklen, total_size); return 1; } /* Needs typically from about 5 to over 60 s for completion, so let's wait 100 s in 500 ms steps. * NB: the address is not a real address but a magic number. This hack allows to share code. */ return at45db_erase(flash, AT45DB_CHIP_ERASE, AT45DB_CHIP_ERASE_ADDR, 500000, 200); } /* This one is really special and works only for AT45CS1282. It uses two different opcodes depending on the * address and has an asymmetric layout. */ int spi_erase_at45cs_sector(struct flashctx *flash, unsigned int addr, unsigned int blocklen) { const unsigned int page_size = flash->c
/*
    ChibiOS - Copyright (C) 2006..2018 Giovanni Di Sirio

    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.
*/

#include "hal.h"
#include "portab.h"

/* Virtual serial port over USB.*/
SerialUSBDriver PORTAB_SDU1;

/*
 * Endpoints to be used for USBD1.
 */
#define USB1_DATA_REQUEST_EP            1
#define USB1_DATA_AVAILABLE_EP          1
#define USB1_INTERRUPT_REQUEST_EP       2

/*
 * USB Device Descriptor.
 */
static const uint8_t vcom_device_descriptor_data[18] = {
  USB_DESC_DEVICE       (0x0110,        /* bcdUSB (1.1).                    */
                         0x02,          /* bDeviceClass (CDC).              */
                         0x00,          /* bDeviceSubClass.                 */
                         0x00,          /* bDeviceProtocol.                 */
                         0x40,          /* bMaxPacketSize.                  */
                         0x0483,        /* idVendor (ST).                   */
                         0x5740,        /* idProduct.                       */
                         0x0200,        /* bcdDevice.                       */
                         1,             /* iManufacturer.                   */
                         2,             /* iProduct.                        */
                         3,             /* iSerialNumber.                   */
                         1)             /* bNumConfigurations.              */
};

/*
 * Device Descriptor wrapper.
 */
static const USBDescriptor vcom_device_descriptor = {
  sizeof vcom_device_descriptor_data,
  vcom_device_descriptor_data
};

/* Configuration Descriptor tree for a CDC.*/
static const uint8_t vcom_configuration_descriptor_data[67] = {
  /* Configuration Descriptor.*/
  USB_DESC_CONFIGURATION(67,            /* wTotalLength.                    */
                         0x02,          /* bNumInterfaces.                  */
                         0x01,          /* bConfigurationValue.             */
                         0,             /* iConfiguration.                  */
                         0xC0,          /* bmAttributes (self powered).     */
                         50),           /* bMaxPower (100mA).               */
  /* Interface Descriptor.*/
  USB_DESC_INTERFACE    (0x00,          /* bInterfaceNumber.                */
                         0x00,          /* bAlternateSetting.               */
                         0x01,          /* bNumEndpoints.                   */
                         0x02,          /* bInterfaceClass (Communications
                                           Interface Class, CDC section
                                           4.2).                            */
                         0x02,          /* bInterfaceSubClass (Abstract
                                         Control Model, CDC section 4.3).   */
                         0x01,          /* bInterfaceProtocol (AT commands,
                                           CDC section 4.4).                */
                         0),            /* iInterface.                      */
  /* Header Functional Descriptor (CDC section 5.2.3).*/
  USB_DESC_BYTE         (5),            /* bLength.                         */
  USB_DESC_BYTE         (0x24),         /* bDescriptorType (CS_INTERFACE).  */
  USB_DESC_BYTE         (0x00),         /* bDescriptorSubtype (Header
                                           Functional Descriptor.           */
  USB_DESC_BCD          (0x0110),       /* bcdCDC.                          */
  /* Call Management Functional Descriptor. */
  USB_DESC_BYTE         (5),            /* bFunctionLength.                 */
  USB_DESC_BYTE         (0x24),         /* bDescriptorType (CS_INTERFACE).  */
  USB_DESC_BYTE         (0x01),         /* bDescriptorSubtype (Call Management
                                           Functional Descriptor).          */
  USB_DESC_BYTE         (0x00),         /* bmCapabilities (D0+D1).          */
  USB_DESC_BYTE         (0x01),         /* bDataInterface.                  */
  /* ACM Functional Descriptor.*/
  USB_DESC_BYTE         (4),            /* bFunctionLength.                 */
  USB_DESC_BYTE         (0x24),         /* bDescriptorType (CS_INTERFACE).  */
  USB_DESC_BYTE         (0x02),         /* bDescriptorSubtype (Abstract
                                           Control Management Descriptor).  */
  USB_DESC_BYTE         (0x02),         /* bmCapabilities.                  */
  /* Union Functional Descriptor.*/
  USB_DESC_BYTE         (5),            /* bFunctionLength.                 */
  USB_DESC_BYTE         (0x24),         /* bDescriptorType (CS_INTERFACE).  */
  USB_DESC_BYTE         (0x06),         /* bDescriptorSubtype (Union
                                           Functional Descriptor).          */
  USB_DESC_BYTE         (0x00),         /* bMasterInterface (Communication
                                           Class Interface).                */
  USB_DESC_BYTE         (0x01),         /* bSlaveInterface0 (Data Class
                                           Interface).                      */
  /* Endpoint 2 Descriptor.*/
  USB_DESC_ENDPOINT     (USB1_INTERRUPT_REQUEST_EP|0x80,
                         0x03,          /* bmAttributes (Interrupt).        */
                         0x0008,        /* wMaxPacketSize.                  */
                         0xFF),         /* bInterval.                       */
  /* Interface Descriptor.*/
  USB_DESC_INTERFACE    (0x01,          /* bInterfaceNumber.                */
                         0x00,          /* bAlternateSetting.               */
                         0x02,          /* bNumEndpoints.                   */
                         0x0A,          /* bInterfaceClass (Data Class
                                           Interface, CDC section 4.5).     */
                         0x00,          /* bInterfaceSubClass (CDC section
                                           4.6).                            */
                         0x00,          /* bInterfaceProtocol (CDC section
                                           4.7).                            */
                         0x00),         /* iInterface.                      */
  /* Endpoint 3 Descriptor.*/
  USB_DESC_ENDPOINT     (USB1_DATA_AVAILABLE_EP,       /* bEndpointAddress.*/
                         0x02,          /* bmAttributes (Bulk).             */
                         0x0040,        /* wMaxPacketSize.                  */
                         0x00),         /* bInterval.                       */
  /* Endpoint 1 Descriptor.*/
  USB_DESC_ENDPOINT     (USB1_DATA_REQUEST_EP|0x80,    /* bEndpointAddress.*/
                         0x02,          /* bmAttributes (Bulk).             */
                         0x0040,        /* wMaxPacketSize.                  */
                         0x00)          /* bInterval.                       */
};

/*
 * Configuration Descriptor wrapper.
 */
static const USBDescriptor vcom_configuration_descriptor = {
  sizeof vcom_configuration_descriptor_data,
  vcom_configuration_descriptor_data
};

/*
 * U.S. English language identifier.
 */
static const uint8_t vcom_string0[] = {
  USB_DESC_BYTE(4),                     /* bLength.                         */
  USB_DESC_BYTE(USB_DESCRIPTOR_STRING), /* bDescriptorType.                 */
  USB_DESC_WORD(0x0409)                 /* wLANGID (U.S. English).          */
};

/*
 * Vendor string.
 */
static const uint8_t vcom_string1[] = {
  USB_DESC_BYTE(38),                    /* bLength.                         */
  USB_DESC_BYTE(USB_DESCRIPTOR_STRING), /* bDescriptorType.                 */
  'S', 0, 'T', 0, 'M', 0, 'i', 0, 'c', 0, 'r', 0, 'o', 0, 'e', 0,
  'l', 0, 'e', 0, 'c', 0, 't', 0, 'r', 0, 'o', 0, 'n', 0, 'i', 0,
  'c', 0, 's', 0
};

/*
 * Device Description string.
 */
static const uint8_t vcom_string2[] = {
  USB_DESC_BYTE(56),                    /* bLength.                         */
  USB_DESC_BYTE(USB_DESCRIPTOR_STRING), /* bDescriptorType.                 */
  'C', 0, 'h', 0, 'i', 0, 'b', 0, 'i', 0, 'O', 0, 'S', 0, '/', 0,
  'R', 0, 'T', 0, ' ', 0, 'V', 0, 'i', 0, 'r', 0, 't', 0, 'u', 0,
  'a', 0, 'l', 0, ' ', 0, 'C', 0, 'O', 0, 'M', 0, ' ', 0, 'P', 0,
  'o', 0, 'r', 0, 't', 0
};

/*
 * Serial Number string.
 */
static const uint8_t vcom_string3[] = {
  USB_DESC_BYTE(8),                     /* bLength.                         */
  USB_DESC_BYTE(USB_DESCRIPTOR_STRING), /* bDescriptorType.                 */
  '0' + CH_KERNEL_MAJOR, 0,
  '0' + CH_KERNEL_MINOR, 0,
  '0' + CH_KERNEL_PATCH, 0
};

/*
 * Strings wrappers array.
 */
static const USBDescriptor vcom_strings[] = {
  {sizeof vcom_string0, vcom_string0},
  {sizeof vcom_string1, vcom_string1},
  {sizeof vcom_string2, vcom_string2},
  {sizeof vcom_string3, vcom_string3}
};

/*
 * Handles the GET_DESCRIPTOR callback. All required descriptors must be
 * handled here.
 */
static const USBDescriptor *get_descriptor(USBDriver *usbp,
                                           uint8_t dtype,
                                           uint8_t dindex,
                                           uint16_t lang) {

  (void)usbp;
  (void)lang;
  switch (dtype) {
  case USB_DESCRIPTOR_DEVICE:
    return &vcom_device_descriptor;
  case USB_DESCRIPTOR_CONFIGURATION:
    return &vcom_configuration_descriptor;
  case USB_DESCRIPTOR_STRING:
    if (dindex < 4)
      return &vcom_strings[dindex];
  }
  return NULL;
}

/**
 * @brief   IN EP1 state.
 */
static USBInEndpointState ep1instate;

/**
 * @brief   OUT EP1 state.
 */
static USBOutEndpointState ep1outstate;

/**
 * @brief   EP1 initialization structure (both IN and OUT).
 */
static const USBEndpointConfig ep1config = {
  USB_EP_MODE_TYPE_BULK,
  NULL,
  sduDataTransmitted,
  sduDataReceived,
  0x0040,
  0x0040,
  &ep1instate,
  &ep1outstate,
  2,
  NULL
};

/**
 * @brief   IN EP2 state.
 */
static USBInEndpointState ep2instate;

/**
 * @brief   EP2 initialization structure (IN only).
 */
static const USBEndpointConfig ep2config = {
  USB_EP_MODE_TYPE_INTR,
  NULL,
  sduInterruptTransmitted,
  NULL,
  0x0010,
  0x0000,
  &ep2instate,
  NULL,
  1,
  NULL
};

/*
 * Handles the USB driver global events.
 */
static void usb_event(USBDriver *usbp, usbevent_t event) {
  extern SerialUSBDriver PORTAB_SDU1;

  switch (event) {
  case USB_EVENT_ADDRESS:
    return;
  case USB_EVENT_CONFIGURED:
    chSysLockFromISR();

    /* Enables the endpoints specified into the configuration.
       Note, this callback is invoked from an ISR so I-Class functions
       must be used.*/
    usbInitEndpointI(usbp, USB1_DATA_REQUEST_EP, &ep1config);
    usbInitEndpointI(usbp, USB1_INTERRUPT_REQUEST_EP, &ep2config);

    /* Resetting the state of the CDC subsystem.*/
    sduConfigureHookI(&PORTAB_SDU1);

    chSysUnlockFromISR();
    return;
  case USB_EVENT_RESET:
    /* Falls into.*/
  case USB_EVENT_UNCONFIGURED:
    /* Falls into.*/
  case USB_EVENT_SUSPEND:
    chSysLockFromISR();

    /* Disconnection event on suspend.*/
    sduSuspendHookI(&PORTAB_SDU1);

    chSysUnlockFromISR();
    return;
  case USB_EVENT_WAKEUP:
    chSysLockFromISR();

    /* Disconnection event on suspend.*/
    sduWakeupHookI(&PORTAB_SDU1);

    chSysUnlockFromISR();
    return;
  case USB_EVENT_STALLED:
    return;
  }
  return;
}

/*
 * Handles the USB driver global events.
 */
static void sof_handler(USBDriver *usbp) {

  (void)usbp;

  osalSysLockFromISR();
  sduSOFHookI(&PORTAB_SDU1);
  osalSysUnlockFromISR();
}

/*
 * USB driver configuration.
 */
const USBConfig usbcfg = {
  usb_event,
  get_descriptor,
  sduRequestsHook,
  sof_handler
};

/*
 * Serial over USB driver configuration.
 */
const SerialUSBConfig serusbcfg = {
  &PORTAB_USB1,
  USB1_DATA_REQUEST_EP,
  USB1_DATA_AVAILABLE_EP,
  USB1_INTERRUPT_REQUEST_EP
};
generated by cgit v1.2.3 (git 2.25.1) at 2026-01-01 23:48:03 +0000