Add support for Sparkfun Artemis Redboard

[Topo-png]

I've attempted to implement the changes required to support the Sparkfun Artemis Reboard. I'm hung up trying to debug the following.

In file included from C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/Usb.h:43,
                 from C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/XBOXONE.h:26,
                 from C:\Users\user1\AppData\Local\Temp\arduino_modified_sketch_523678\XBOXONE.ino:15:
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:126:25: error: type/value mismatch at argument 1 in template parameter list for 'template<class SPI_CLK, class SPI_MOSI, class SPI_MISO, class SPI_SS> class SPi'
 typedef SPi< 5, 7, 6, 13> spi;
                         ^
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:126:25: note:   expected a type, got '5'
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:126:25: error: type/value mismatch at argument 2 in template parameter list for 'template<class SPI_CLK, class SPI_MOSI, class SPI_MISO, class SPI_SS> class SPi'
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:126:25: note:   expected a type, got '7'
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:126:25: error: type/value mismatch at argument 3 in template parameter list for 'template<class SPI_CLK, class SPI_MOSI, class SPI_MISO, class SPI_SS> class SPi'
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:126:25: note:   expected a type, got '6'
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:126:25: error: type/value mismatch at argument 4 in template parameter list for 'template<class SPI_CLK, class SPI_MOSI, class SPI_MISO, class SPI_SS> class SPi'
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:126:25: note:   expected a type, got '13'
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h: In member function 'int8_t MAX3421e<SPI_SS, INTR>::Init()':
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:434:18: error: qualified-id in declaration before '(' token
         spi::init();
                  ^
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h: In member function 'int8_t MAX3421e<SPI_SS, INTR>::Init(int)':

C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/usbhost.h:471:18: error: qualified-id in declaration before '(' token
         spi::init();
                  ^
In file included from C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/Usb.h:44,
                 from C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/XBOXONE.h:26,
                 from C:\Users\user1\AppData\Local\Temp\arduino_modified_sketch_523678\XBOXONE.ino:15:
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/UsbCore.h: At global scope:
C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0/UsbCore.h:212:29: error: expected class-name before '{' token
 class USB : public MAX3421E {
                             ^
Using library SPI at version 1.0 in folder: C:\Users\user1\AppData\Local\Arduino15\packages\SparkFun\hardware\apollo3\1.2.1\libraries\SPI 

Using library USB_Host_Shield_Library_2.0 at version 1.6.0 in folder: C:\Users\1\Arduino\libraries\USB_Host_Shield_Library_2.0 

exit status 1

Error compiling for board SparkFun RedBoard Artemis ATP.

[Topo-png]

It looks to build successfully on my machine @Lauszus. Thanks for the guidance. This PR was my first and also my first real attempt at using Git.

[Lauszus]

All looks good now. Have you confirmed that the library now works with the board?

[Topo-png]

I'm waiting for a new USB host shield to arrive. Examples build properly. I will hopefully be able to report functionality later this week.

[Lauszus]

@Topo-png thanks. I'll squash and merge the commits once you have verified that it is actually working with the board :)

[Topo-png]

I loaded the XBOXONE example to the board for testing.
Serial Log reports back
OSC did not start

I went and reflowed the pins and loaded the board_qc program.
Serial Log reports back
Circuits At Home 2011 USB Host Shield Quality Control Routine Reading REVISION register... Die revision invalid. Value returned: 00 Unrecoverable error - test halted!! 0x55 pattern is transmitted via SPI Press RESET to restart test

[xxxajk]

Use shorter wires for SPI. :-)

[Topo-png]

@xxxajk - this is a shield directly connected to header pins, no long wires other than the PCB traces.

I modified the pins to match what I believe is the correct pinout. Using Pin Out and this image

I used the blink sketch to flash each pin independently to verify the proper pinout (SCK, MOSI, MISO, INT, SS). I also cross-referenced the standard Arduino pinout to the new Redboard pinout. (see above image, small black text offset to the left in the red rectangle).

in ushbost.h
#elif defined(AM_PART_APOLLO3)
typedef SPi< P5, P7, P6, P13 > spi;

in usbcore.h
#elif defined(AM_PART_APOLLO3)
typedef MAX3421e<P13, P12> MAX3421E; // ATP

Board_qc now outputs the following
Circuits At Home 2011 USB Host Shield Quality Control Routine Reading REVISION register... Die revision 03 SPI long test. Transfers 1MB of data. Each dot is 64K Test failed. Value written: 01 read: 00 Unrecoverable error - test halted!! 0x55 pattern is transmitted via SPI Press RESET to restart test

[xxxajk]

Slow down the SPI, going at maximum rated rate with some SPI causes issues. This was noted before on Atmel's SAMD ARM, where it's SPI didn't clock the bit in at the correct point, and would miss or hit it in transition.
What speed are you currently using?

[Topo-png]

I haven't changed any SPI speeds. How do I slow this down?

[xxxajk]

Unfortunately someone (not me) didn't make it a define so... Here's the list.

https://github.com/felis/USB_Host_Shield_2.0/blob/master/usbhost.h#L182
https://github.com/felis/USB_Host_Shield_2.0/blob/master/usbhost.h#L225
https://github.com/felis/USB_Host_Shield_2.0/blob/master/usbhost.h#L283
https://github.com/felis/USB_Host_Shield_2.0/blob/master/usbhost.h#L322

[Topo-png]

Thanks, I reduced those down to 260000 and I still didn't have any luck. The errors take noticeably longer to report so I believe this is working properly.

[xxxajk]

Try the following:
12000000
10000000
8000000

If you can't get it working at less than 8MHz, then something else is wrong.
Running the shield on 3.3v? Because 5V will fry the SPI... Unless the board can take 5v.

[xxxajk]

One other note, is that the official shields, use the ICSP header for SPI. Just sayin'...