Skip to content
Snippets Groups Projects
dfu.h 1.75 KiB
Newer Older
  • Learn to ignore specific revisions
  • /*
     * Fadecandy DFU Bootloader
     * 
     * Copyright (c) 2013 Micah Elizabeth Scott
     * 
     * Permission is hereby granted, free of charge, to any person obtaining a copy of
     * this software and associated documentation files (the "Software"), to deal in
     * the Software without restriction, including without limitation the rights to
     * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
     * the Software, and to permit persons to whom the Software is furnished to do so,
     * subject to the following conditions:
     * 
     * The above copyright notice and this permission notice shall be included in all
     * copies or substantial portions of the Software.
     * 
     * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
     * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
     * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
     * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
     * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
     */
    
    #pragma once
    
    typedef enum {
    	appIDLE = 0,
    	appDETACH,
    	dfuIDLE,
    	dfuDNLOAD_SYNC,
    	dfuDNBUSY,
    	dfuDNLOAD_IDLE,
    	dfuMANIFEST_SYNC,
    	dfuMANIFEST,
    	dfuMANIFEST_WAIT_RESET,
    	dfuUPLOAD_IDLE,
    	dfuERROR
    } dfu_state_t;
    
    typedef enum {
    	OK = 0,
    	errTARGET,
    	errFILE,
    	errWRITE,
    	errERASE,
    	errCHECK_ERASED,
    	errPROG,
    	errVERIFY,
    	errADDRESS,
    	errNOTDONE,
    	errFIRMWARE,
    	errVENDOR,
    	errUSBR,
    	errPOR,
    	errUNKNOWN,
    	errSTALLEDPKT,
    } dfu_status_t;
    
    
    void dfu_init();
    void dfu_download(unsigned blockNum, unsigned length, const uint8_t *data);
    void dfu_getstatus(uint8_t *status);
    void dfu_clrstatus();
    uint8_t dfu_getstate();
    void dfu_abort();