329 lines
9.7 KiB
C++
329 lines
9.7 KiB
C++
/**
|
|
* Marlin 3D Printer Firmware
|
|
* Copyright (c) 2020 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
|
|
*
|
|
* Based on Sprinter and grbl.
|
|
* Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
|
|
*
|
|
* 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, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* 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.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
|
|
#include "../../inc/MarlinConfigPre.h"
|
|
|
|
/**
|
|
* Adjust USB_DEBUG to select debugging verbosity.
|
|
* 0 - no debug messages
|
|
* 1 - basic insertion/removal messages
|
|
* 2 - show USB state transitions
|
|
* 3 - perform block range checking
|
|
* 4 - print each block access
|
|
*/
|
|
#define USB_DEBUG 1
|
|
#define USB_STARTUP_DELAY 0
|
|
|
|
// uncomment to get 'printf' console debugging. NOT FOR UNO!
|
|
//#define HOST_DEBUG(...) {char s[255]; sprintf(s,__VA_ARGS__); SERIAL_ECHOLNPGM("UHS:",s);}
|
|
//#define BS_HOST_DEBUG(...) {char s[255]; sprintf(s,__VA_ARGS__); SERIAL_ECHOLNPGM("UHS:",s);}
|
|
//#define MAX_HOST_DEBUG(...) {char s[255]; sprintf(s,__VA_ARGS__); SERIAL_ECHOLNPGM("UHS:",s);}
|
|
|
|
#if ENABLED(USB_FLASH_DRIVE_SUPPORT)
|
|
|
|
#include "../../MarlinCore.h"
|
|
#include "../../core/serial.h"
|
|
#include "../../module/temperature.h"
|
|
|
|
#if DISABLED(USE_OTG_USB_HOST) && !PINS_EXIST(USB_CS, USB_INTR)
|
|
#error "USB_FLASH_DRIVE_SUPPORT requires USB_CS_PIN and USB_INTR_PIN to be defined."
|
|
#endif
|
|
|
|
#if ENABLED(USE_UHS3_USB)
|
|
#define NO_AUTO_SPEED
|
|
#define UHS_MAX3421E_SPD 8000000 >> SD_SPI_SPEED
|
|
#define UHS_DEVICE_WINDOWS_USB_SPEC_VIOLATION_DESCRIPTOR_DEVICE 1
|
|
#define UHS_HOST_MAX_INTERFACE_DRIVERS 2
|
|
#define MASS_MAX_SUPPORTED_LUN 1
|
|
#define USB_HOST_SERIAL MYSERIAL1
|
|
|
|
// Workaround for certain issues with UHS3
|
|
#define SKIP_PAGE3F // Required for IOGEAR media adapter
|
|
#define USB_NO_TEST_UNIT_READY // Required for removable media adapter
|
|
#define USB_HOST_MANUAL_POLL // Optimization to shut off IRQ automatically
|
|
|
|
// Workarounds to keep Marlin's watchdog timer from barking...
|
|
void marlin_yield() { thermalManager.task(); }
|
|
#define SYSTEM_OR_SPECIAL_YIELD(...) marlin_yield();
|
|
#define delay(x) safe_delay(x)
|
|
|
|
#define LOAD_USB_HOST_SYSTEM
|
|
#define LOAD_USB_HOST_SHIELD
|
|
#define LOAD_UHS_BULK_STORAGE
|
|
|
|
#define MARLIN_UHS_WRITE_SS(v) WRITE(USB_CS_PIN, v)
|
|
#define MARLIN_UHS_READ_IRQ() READ(USB_INTR_PIN)
|
|
|
|
#include "lib-uhs3/UHS_host/UHS_host.h"
|
|
|
|
MAX3421E_HOST usb(USB_CS_PIN, USB_INTR_PIN);
|
|
UHS_Bulk_Storage bulk(&usb);
|
|
|
|
#define UHS_START (usb.Init() == 0)
|
|
#define UHS_STATE(state) UHS_USB_HOST_STATE_##state
|
|
|
|
#elif ENABLED(USE_OTG_USB_HOST)
|
|
|
|
#if HAS_SD_HOST_DRIVE
|
|
#include HAL_PATH(../../HAL, msc_sd.h)
|
|
#endif
|
|
|
|
#include HAL_PATH(../../HAL, usb_host.h)
|
|
|
|
#define UHS_START usb.start()
|
|
#define rREVISION 0
|
|
#define UHS_STATE(state) USB_STATE_##state
|
|
|
|
#else
|
|
|
|
#include "lib-uhs2/Usb.h"
|
|
#include "lib-uhs2/masstorage.h"
|
|
|
|
USB usb;
|
|
BulkOnly bulk(&usb);
|
|
|
|
#define UHS_START usb.start()
|
|
#define UHS_STATE(state) USB_STATE_##state
|
|
|
|
#endif
|
|
|
|
#include "Sd2Card_FlashDrive.h"
|
|
|
|
#include "../../lcd/marlinui.h"
|
|
|
|
static enum {
|
|
UNINITIALIZED,
|
|
DO_STARTUP,
|
|
WAIT_FOR_DEVICE,
|
|
WAIT_FOR_LUN,
|
|
MEDIA_READY,
|
|
MEDIA_ERROR
|
|
} state;
|
|
|
|
#if USB_DEBUG >= 3
|
|
uint32_t lun0_capacity;
|
|
#endif
|
|
|
|
bool DiskIODriver_USBFlash::usbStartup() {
|
|
if (state <= DO_STARTUP) {
|
|
SERIAL_ECHOPGM("Starting USB host...");
|
|
if (!UHS_START) {
|
|
SERIAL_ECHOLNPGM(" failed.");
|
|
LCD_MESSAGE(MSG_MEDIA_USB_FAILED);
|
|
return false;
|
|
}
|
|
|
|
// SPI quick test - check revision register
|
|
switch (usb.regRd(rREVISION)) {
|
|
case 0x01: SERIAL_ECHOLNPGM("rev.01 started"); break;
|
|
case 0x12: SERIAL_ECHOLNPGM("rev.02 started"); break;
|
|
case 0x13: SERIAL_ECHOLNPGM("rev.03 started"); break;
|
|
default: SERIAL_ECHOLNPGM("started. rev unknown."); break;
|
|
}
|
|
state = WAIT_FOR_DEVICE;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
// The USB library needs to be called periodically to detect USB thumbdrive
|
|
// insertion and removals. Call this idle() function periodically to allow
|
|
// the USB library to monitor for such events. This function also takes care
|
|
// of initializing the USB library for the first time.
|
|
|
|
void DiskIODriver_USBFlash::idle() {
|
|
usb.Task();
|
|
|
|
const uint8_t task_state = usb.getUsbTaskState();
|
|
|
|
#if USB_DEBUG >= 2
|
|
if (state > DO_STARTUP) {
|
|
static uint8_t laststate = 232;
|
|
if (task_state != laststate) {
|
|
laststate = task_state;
|
|
#define UHS_USB_DEBUG(x,y) case UHS_STATE(x): SERIAL_ECHOLNPGM(y); break
|
|
switch (task_state) {
|
|
UHS_USB_DEBUG(IDLE, "IDLE");
|
|
UHS_USB_DEBUG(RESET_DEVICE, "RESET_DEVICE");
|
|
UHS_USB_DEBUG(RESET_NOT_COMPLETE, "RESET_NOT_COMPLETE");
|
|
UHS_USB_DEBUG(DEBOUNCE, "DEBOUNCE");
|
|
UHS_USB_DEBUG(DEBOUNCE_NOT_COMPLETE, "DEBOUNCE_NOT_COMPLETE");
|
|
UHS_USB_DEBUG(WAIT_SOF, "WAIT_SOF");
|
|
UHS_USB_DEBUG(ERROR, "ERROR");
|
|
UHS_USB_DEBUG(CONFIGURING, "CONFIGURING");
|
|
UHS_USB_DEBUG(CONFIGURING_DONE, "CONFIGURING_DONE");
|
|
UHS_USB_DEBUG(RUNNING, "RUNNING");
|
|
default:
|
|
SERIAL_ECHOLNPGM("UHS_USB_HOST_STATE: ", task_state);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
#endif
|
|
|
|
static millis_t next_state_ms = millis();
|
|
|
|
#define GOTO_STATE_AFTER_DELAY(STATE, DELAY) do{ state = STATE; next_state_ms = millis() + DELAY; }while(0)
|
|
|
|
if (ELAPSED(millis(), next_state_ms)) {
|
|
GOTO_STATE_AFTER_DELAY(state, 250); // Default delay
|
|
|
|
switch (state) {
|
|
|
|
case UNINITIALIZED:
|
|
#ifndef MANUAL_USB_STARTUP
|
|
GOTO_STATE_AFTER_DELAY( DO_STARTUP, USB_STARTUP_DELAY );
|
|
#endif
|
|
break;
|
|
|
|
case DO_STARTUP: usbStartup(); break;
|
|
|
|
case WAIT_FOR_DEVICE:
|
|
if (task_state == UHS_STATE(RUNNING)) {
|
|
#if USB_DEBUG >= 1
|
|
SERIAL_ECHOLNPGM("USB device inserted");
|
|
#endif
|
|
GOTO_STATE_AFTER_DELAY( WAIT_FOR_LUN, 250 );
|
|
}
|
|
break;
|
|
|
|
case WAIT_FOR_LUN:
|
|
/* USB device is inserted, but if it is an SD card,
|
|
* adapter it may not have an SD card in it yet. */
|
|
if (bulk.LUNIsGood(0)) {
|
|
#if USB_DEBUG >= 1
|
|
SERIAL_ECHOLNPGM("LUN is good");
|
|
#endif
|
|
GOTO_STATE_AFTER_DELAY( MEDIA_READY, 100 );
|
|
}
|
|
else {
|
|
#ifdef USB_HOST_MANUAL_POLL
|
|
// Make sure we catch disconnect events
|
|
usb.busprobe();
|
|
usb.VBUS_changed();
|
|
#endif
|
|
#if USB_DEBUG >= 1
|
|
SERIAL_ECHOLNPGM("Waiting for media");
|
|
#endif
|
|
LCD_MESSAGE(MSG_MEDIA_WAITING);
|
|
GOTO_STATE_AFTER_DELAY(state, 2000);
|
|
}
|
|
break;
|
|
|
|
case MEDIA_READY: break;
|
|
case MEDIA_ERROR: break;
|
|
}
|
|
|
|
if (state > WAIT_FOR_DEVICE && task_state != UHS_STATE(RUNNING)) {
|
|
// Handle device removal events
|
|
#if USB_DEBUG >= 1
|
|
SERIAL_ECHOLNPGM("USB device removed");
|
|
#endif
|
|
if (state != MEDIA_READY)
|
|
LCD_MESSAGE(MSG_MEDIA_USB_REMOVED);
|
|
GOTO_STATE_AFTER_DELAY(WAIT_FOR_DEVICE, 0);
|
|
}
|
|
|
|
else if (state > WAIT_FOR_LUN && !bulk.LUNIsGood(0)) {
|
|
// Handle media removal events
|
|
#if USB_DEBUG >= 1
|
|
SERIAL_ECHOLNPGM("Media removed");
|
|
#endif
|
|
LCD_MESSAGE(MSG_MEDIA_REMOVED);
|
|
GOTO_STATE_AFTER_DELAY(WAIT_FOR_DEVICE, 0);
|
|
}
|
|
|
|
else if (task_state == UHS_STATE(ERROR)) {
|
|
LCD_MESSAGE(MSG_MEDIA_READ_ERROR);
|
|
GOTO_STATE_AFTER_DELAY(MEDIA_ERROR, 0);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Marlin calls this function to check whether an USB drive is inserted.
|
|
// This is equivalent to polling the SD_DETECT when using SD cards.
|
|
bool DiskIODriver_USBFlash::isInserted() {
|
|
return state == MEDIA_READY;
|
|
}
|
|
|
|
bool DiskIODriver_USBFlash::isReady() {
|
|
return state > DO_STARTUP && usb.getUsbTaskState() == UHS_STATE(RUNNING);
|
|
}
|
|
|
|
// Marlin calls this to initialize an SD card once it is inserted.
|
|
bool DiskIODriver_USBFlash::init(const uint8_t, const pin_t) {
|
|
if (!isInserted()) return false;
|
|
|
|
#if USB_DEBUG >= 1
|
|
const uint32_t sectorSize = bulk.GetSectorSize(0);
|
|
if (sectorSize != 512) {
|
|
SERIAL_ECHOLNPGM("Expecting sector size of 512. Got: ", sectorSize);
|
|
return false;
|
|
}
|
|
#endif
|
|
|
|
#if USB_DEBUG >= 3
|
|
lun0_capacity = bulk.GetCapacity(0);
|
|
SERIAL_ECHOLNPGM("LUN Capacity (in blocks): ", lun0_capacity);
|
|
#endif
|
|
return true;
|
|
}
|
|
|
|
// Returns the capacity of the card in blocks.
|
|
uint32_t DiskIODriver_USBFlash::cardSize() {
|
|
if (!isInserted()) return false;
|
|
#if USB_DEBUG < 3
|
|
const uint32_t
|
|
#endif
|
|
lun0_capacity = bulk.GetCapacity(0);
|
|
return lun0_capacity;
|
|
}
|
|
|
|
bool DiskIODriver_USBFlash::readBlock(uint32_t block, uint8_t *dst) {
|
|
if (!isInserted()) return false;
|
|
#if USB_DEBUG >= 3
|
|
if (block >= lun0_capacity) {
|
|
SERIAL_ECHOLNPGM("Attempt to read past end of LUN: ", block);
|
|
return false;
|
|
}
|
|
#if USB_DEBUG >= 4
|
|
SERIAL_ECHOLNPGM("Read block ", block);
|
|
#endif
|
|
#endif
|
|
return bulk.Read(0, block, 512, 1, dst) == 0;
|
|
}
|
|
|
|
bool DiskIODriver_USBFlash::writeBlock(uint32_t block, const uint8_t *src) {
|
|
if (!isInserted()) return false;
|
|
#if USB_DEBUG >= 3
|
|
if (block >= lun0_capacity) {
|
|
SERIAL_ECHOLNPGM("Attempt to write past end of LUN: ", block);
|
|
return false;
|
|
}
|
|
#if USB_DEBUG >= 4
|
|
SERIAL_ECHOLNPGM("Write block ", block);
|
|
#endif
|
|
#endif
|
|
return bulk.Write(0, block, 512, 1, src) == 0;
|
|
}
|
|
|
|
#endif // USB_FLASH_DRIVE_SUPPORT
|