first commit

COPYING

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org/>

README.md

@@ -0,0 +1,12 @@
+# Greaseweazle
+
+Tools and USB interface for accessing a floppy drive at the raw flux level.
+
+## Redistribution
+
+Most code is public domain; the rest is MIT/BSD or Open Source friendly
+(see the [COPYING](COPYING) file).
+
+The source code, and all binary releases, are freely redistributable
+in any form. Because Greaseweazle includes third-party code, you should
+include or link to the [COPYING](COPYING) file in any redistribution.

firmware/doc/pins.txt

@@ -0,0 +1,66 @@
+
+Debug Console:
+--------------
+USART1: (Rx:DMA1/5, Tx:DMA1/4)
+ PA9   TX
+ PA10  RX
+
+USB:
+----
+ PA11  USB_DM
+ PA12  USB_DP
+GPIO: (GPI_float, GPO_pushpull)
+ PB0 (connect via 1.5kohm to PA12/USB_DP)
+
+Floppy:
+-------
+GPIn: (GPI_float, active low, 5v tolerant)
+ PB13    8: IDX
+ PB4    26: TRK0
+ PB8    28: WRPROT
+GPOut: (GPO_pushpull, active high)
+ PA7     2: DENSEL
+ PA6    12: SEL_A
+ PA5    16: MTR_A
+ PA4    18: DIR
+ PA3    20: STEP
+ PA1    24: DKWE
+ PA0    32: SIDE
+TimerIn: (GPI_float, active low, 5v tolerant)
+ PB6    30: DKRD (Timer4/1, CC1:DMA1/1)
+TimerOut: (AFO_pushpull, active high)
+ PA2    22: DKWD (Timer2/3, UP:DMA1/2)
+
+Unused Pins:
+------------
+All to be pulled high:
+ PA8,13-15
+ PB1-3,5,7,9-12,14-15
+ PC0-15
+
+Floppy bus connections:
+-----------------------
+Inputs: Pull to 5v via 1k.
+Outputs: Drive open-collector 2N3904, 1k base resistor.
+
+IBM/PC 34-pin Floppy Host Interface:
+------------------------------------
+  2: -> DENSEL(5.25: HIGH=360rpm/high-density, LOW=300rpm, low-density)
+  3: missing/key
+  4: n/c
+  6: n/c
+  8: <- INDEX
+ 10: -> MTR_B
+ 12: -> SEL_A
+ 14: -> SEL_B
+ 16: -> MTR_A
+ 18: -> DIR
+ 20: -> STEP
+ 22: -> DKWD
+ 24: -> DKWE
+ 26: <- TRK0
+ 28: <- WRPROT
+ 30: <- DKRD
+ 32: -> SIDE
+ 34: <- DSKCHG / RDY(5.25)
+All odd pins are ground.