Merge pull request #18 from bitcraze:bq-c1-and-usd-d

Updates for BQ Rev C1 and micro-SD Rev D

src/products/big-quad-deck/datasheet/index.md

@@ -2,7 +2,7 @@
 layout: datasheet-base
 title: BigQuad deck
 sku: 102990227
-version: 1
+version: 2
 status: early-access
 ---
 
@@ -81,23 +81,29 @@ The Loco deck, microSD and Flow (v2) deck all uses the SPI bus. As the BigQuad d
 
 To work around this issue do the following:
 
-* By removing capacitor C1 on the BigQuad deck (see below)
+* By removing capacitor C1 on the BigQuad deck (only valid for Rev C, Rev C1 already has this capacitor removed)
+{% datasheet_img Mechanical drawing; small; center; bigquaddeck-remove-c1.png; %}
 * Not having BQ\_DECK\_ENABLE\_PM defined.
 * Disabling the extRx functionality by commenting out extRxInit() in bigquad.c
 
-{% datasheet_img Mechanical drawing; small; center; bigquaddeck-remove-c1.png; %}
-
-Capacitor C1 is used to filter the current measurement and removing this has the effect that it will not be filtered any more. Still possible to use it if a deck using the SPI is not wanted any more.
-
 To make it work with the Flow (v2) deck more changes/patching are needed:
 
 * The Flow HW ChipSelect (IO3) interfere with BigQuad PWM and needs to be moved. Cut trace and solder patch on Flow deck from IO3 to IO1.
 * Change the CS pin in flowdeck\_v1v2.c (IO3 → IO1)
 
 Next problem is how to mount the deck in a nice way on the quad, we leave that up to you.
 
+
+## Hardware revisions
+
+| Revision | Comment |
+| ------- | ------- |
+| C | Initial release |
+| C1 | Capacitor C1 is not mounted |
+
 ## History
 
 | Version | Comment | Date |
 | ------- | ------- | ---- |
 | 1 | Initial release | 2020-03-25 |
+| 2 | Updated with hardware version C1, added hardware revision section and updated errata | 2022-01-25 |

src/products/sd-card-deck/datasheet/index.md

@@ -2,7 +2,7 @@
 layout: datasheet-base
 title: SD-card deck
 sku: 114990852
-version: 1
+version: 2
 status: active
 ---
 
@@ -43,14 +43,15 @@ soldered to select another IO (IO1-3) for chip select.
 
 ### SPI bus limitations
 
+#### Rev C
+
 The SD-Card is using the SPI bus on the deck port to communicate. This has turned out to
-have some implications for the other decks that use the SPI bus. The effected decks
-are the *Loco positioning deck* and the *Flow v1/v2 deck*. An issue has been open
-about it and currently we have no easy solution. One workaround is to use a “hidden”
+have some implications for the other decks that use the SPI bus which limits the speed of logging. 
+If higher speed is needed one workaround is to use a “hidden”
 SPI on the deck port that is multiplexed with TX1, RX1 and IO_4. This SPI port is called
-SPI3 in the STM32F405 and after this commit there is a possibility to switch to this SPI bus.
+SPI3 in the STM32F405 and it is a possibile to switch to this SPI bus.
 
-The following steps can he used to work around this issue:
+The following steps can be used to work around this issue:
 
 * First thing the SD-card deck needs to be patched. This is a quite hard to cut the
  small lines and solder small patch wires. Easier is to use a sd-card breakout deck
@@ -60,18 +61,30 @@ The following steps can he used to work around this issue:
  * MISO→RX1(PC11)
  * MOSI→IO_4(PC12)
 * Compile the firmware with ```CFLAGS += -DUSDDECK_USE_ALT_PINS_AND_SPI``` in your config.mk file.
-* If you want to use the Loco-deck at the same time, the alternative pins for this must be used.
- This means cutting GS1 and GS2 underneeth the Loco positioing deck and soldering the bridged
- GS3 and GS4. Then add ```CFLAGS += -DLOCODECK_USE_ALT_PINS``` to you ```config.mk``` as well.
+
+#### Rev D
+
+This revsion makes it easier to do the switch to SPI3 as described for Rev C. 
+* On the bottom of the board cut bridges GS4, GS9, GS10 and GS11. 
+ Then solder GS5, GS6, GS7 and GS8 (marked ALT.SPI)
+* Compile the firmware with ```CFLAGS += -DUSDDECK_USE_ALT_PINS_AND_SPI``` in your config.mk file.
+
+#### Together with Loco deck
+If you want to use the Loco-deck at the same time, the alternative pins for this must be used.
+This means cutting GS1 and GS2 underneeth the Loco positioing deck and soldering the bridged
+GS3 and GS4. Then add ```CFLAGS += -DLOCODECK_USE_ALT_PINS``` to you ```config.mk``` as well.
+
 
 ## Hardware revisions
 
 | Revision | Comment |
 | ------- | ------- |
-| D | Initial release |
+| C | Initial release |
+| D | Improved configuration options for pins used to interface micro-SD card |
 
 ## History
 
 | Version | Comment | Date |
 | ------- | ------- | ---- |
 | 1 | Initial release | 2020-04-01 |
+| 2 | Updated with hardware revision D and fixed initial revision to C | 2021-01-25 |