From c73d3277fc600ae551edecca8c8cce26c0d4708f Mon Sep 17 00:00:00 2001 From: Till Harbaum Date: Tue, 12 Jan 2016 20:42:20 +0100 Subject: [PATCH] Initial import --- README.md | 226 ++++++++ circuit/lcd2usb.brd | Bin 0 -> 37067 bytes circuit/lcd2usb.sch | Bin 0 -> 295443 bytes circuit/pcb.pdf | Bin 0 -> 45164 bytes circuit/pcb.png | Bin 0 -> 55175 bytes circuit/schematic.pdf | Bin 0 -> 25229 bytes circuit/schematic.png | Bin 0 -> 38919 bytes firmware/COPYING | 341 ++++++++++++ firmware/Makefile | 84 +++ firmware/checksize | 35 ++ firmware/firmware.bin | Bin 0 -> 9901 bytes firmware/firmware.hex | 174 ++++++ firmware/lcd.c | 312 +++++++++++ firmware/lcd.h | 177 ++++++ firmware/main.c | 241 +++++++++ firmware/readme.txt | 28 + firmware/usbconfig.h | 115 ++++ firmware/usbdrv/Changelog.txt | 308 +++++++++++ firmware/usbdrv/CommercialLicense.txt | 166 ++++++ firmware/usbdrv/License.txt | 361 +++++++++++++ firmware/usbdrv/Readme.txt | 172 ++++++ firmware/usbdrv/USB-ID-FAQ.txt | 149 +++++ firmware/usbdrv/USB-IDs-for-free.txt | 148 +++++ firmware/usbdrv/asmcommon.inc | 188 +++++++ firmware/usbdrv/oddebug.c | 50 ++ firmware/usbdrv/oddebug.h | 123 +++++ firmware/usbdrv/usbconfig-prototype.h | 376 +++++++++++++ firmware/usbdrv/usbdrv.c | 625 +++++++++++++++++++++ firmware/usbdrv/usbdrv.h | 735 +++++++++++++++++++++++++ firmware/usbdrv/usbdrvasm.S | 393 ++++++++++++++ firmware/usbdrv/usbdrvasm.asm | 21 + firmware/usbdrv/usbdrvasm12.inc | 393 ++++++++++++++ firmware/usbdrv/usbdrvasm128.inc | 750 ++++++++++++++++++++++++++ firmware/usbdrv/usbdrvasm15.inc | 423 +++++++++++++++ firmware/usbdrv/usbdrvasm16.inc | 346 ++++++++++++ firmware/usbdrv/usbdrvasm165.inc | 453 ++++++++++++++++ firmware/usbdrv/usbdrvasm18-crc.inc | 707 ++++++++++++++++++++++++ firmware/usbdrv/usbdrvasm20.inc | 360 +++++++++++++ firmware/usbdrv/usbportability.h | 144 +++++ images/4x20-front.jpg | Bin 0 -> 11862 bytes images/4x20-rear.jpg | Bin 0 -> 17066 bytes images/avrisp.gif | Bin 0 -> 7096 bytes images/bridge-4x40.jpg | Bin 0 -> 26641 bytes images/cable.gif | Bin 0 -> 2380 bytes images/connectors.gif | Bin 0 -> 3051 bytes images/disp_con1.gif | Bin 0 -> 2683 bytes images/disp_con2.gif | Bin 0 -> 2686 bytes images/disp_con3.gif | Bin 0 -> 3251 bytes images/lcd2usb-front.jpg | Bin 0 -> 10619 bytes images/pcb.gif | Bin 0 -> 57439 bytes images/pcb.jpg | Bin 0 -> 11467 bytes images/prototyp.jpg | Bin 0 -> 23946 bytes images/schematic-small.gif | Bin 0 -> 12540 bytes images/simple.jpg | Bin 0 -> 13905 bytes testapp/Makefile | 14 + testapp/Makefile.cygwin | 15 + testapp/Makefile.macos | 14 + testapp/Makefile.mingw | 15 + testapp/Makefile.xmingw | 19 + testapp/lcd2usb.c | 342 ++++++++++++ testapp/lcd2usb.exe | Bin 0 -> 23490 bytes testapp/readme.txt | 41 ++ win/lcd2usb.inf | 91 ++++ win/libusb0.dll | Bin 0 -> 46592 bytes win/libusb0.sys | Bin 0 -> 33792 bytes 65 files changed, 9675 insertions(+) create mode 100644 README.md create mode 100644 circuit/lcd2usb.brd create mode 100644 circuit/lcd2usb.sch create mode 100644 circuit/pcb.pdf create mode 100644 circuit/pcb.png create mode 100644 circuit/schematic.pdf create mode 100644 circuit/schematic.png create mode 100644 firmware/COPYING create mode 100644 firmware/Makefile create mode 100755 firmware/checksize create mode 100755 firmware/firmware.bin create mode 100644 firmware/firmware.hex create mode 100644 firmware/lcd.c create mode 100644 firmware/lcd.h create mode 100644 firmware/main.c create mode 100644 firmware/readme.txt create mode 100644 firmware/usbconfig.h create mode 100644 firmware/usbdrv/Changelog.txt create mode 100644 firmware/usbdrv/CommercialLicense.txt create mode 100644 firmware/usbdrv/License.txt create mode 100644 firmware/usbdrv/Readme.txt create mode 100644 firmware/usbdrv/USB-ID-FAQ.txt create mode 100644 firmware/usbdrv/USB-IDs-for-free.txt create mode 100644 firmware/usbdrv/asmcommon.inc create mode 100644 firmware/usbdrv/oddebug.c create mode 100644 firmware/usbdrv/oddebug.h create mode 100644 firmware/usbdrv/usbconfig-prototype.h create mode 100644 firmware/usbdrv/usbdrv.c create mode 100644 firmware/usbdrv/usbdrv.h create mode 100644 firmware/usbdrv/usbdrvasm.S create mode 100644 firmware/usbdrv/usbdrvasm.asm create mode 100644 firmware/usbdrv/usbdrvasm12.inc create mode 100644 firmware/usbdrv/usbdrvasm128.inc create mode 100644 firmware/usbdrv/usbdrvasm15.inc create mode 100644 firmware/usbdrv/usbdrvasm16.inc create mode 100644 firmware/usbdrv/usbdrvasm165.inc create mode 100644 firmware/usbdrv/usbdrvasm18-crc.inc create mode 100644 firmware/usbdrv/usbdrvasm20.inc create mode 100644 firmware/usbdrv/usbportability.h create mode 100644 images/4x20-front.jpg create mode 100644 images/4x20-rear.jpg create mode 100644 images/avrisp.gif create mode 100644 images/bridge-4x40.jpg create mode 100644 images/cable.gif create mode 100644 images/connectors.gif create mode 100644 images/disp_con1.gif create mode 100644 images/disp_con2.gif create mode 100644 images/disp_con3.gif create mode 100644 images/lcd2usb-front.jpg create mode 100644 images/pcb.gif create mode 100644 images/pcb.jpg create mode 100644 images/prototyp.jpg create mode 100644 images/schematic-small.gif create mode 100644 images/simple.jpg create mode 100644 testapp/Makefile create mode 100644 testapp/Makefile.cygwin create mode 100644 testapp/Makefile.macos create mode 100644 testapp/Makefile.mingw create mode 100644 testapp/Makefile.xmingw create mode 100644 testapp/lcd2usb.c create mode 100755 testapp/lcd2usb.exe create mode 100644 testapp/readme.txt create mode 100755 win/lcd2usb.inf create mode 100755 win/libusb0.dll create mode 100755 win/libusb0.sys diff --git a/README.md b/README.md new file mode 100644 index 0000000..b99c0d0 --- /dev/null +++ b/README.md @@ -0,0 +1,226 @@ +# LCD2USB + +## Overview + +LCD2USB is a open source/open hardware project. The goal of LCD2USB is to connect HD44780 based text LCD displays to various PCs via USB. LCD2USB was meant to be cheap and to be made of easily available parts. It is therefore based on the [Atmel AVR Mega8 CPU](http://www.atmel.com/dyn/products/product_card.asp?part_id=2004) and does not require any difficult to obtain parts like separate USB controllers and the like. The total cost (without display and pcb) are about 5 to 10 Euros. LCD2USB currently comes with a simple demo application that works under Linux, MacOS X and Windows. + +LCD2USB is currently supported by [lcd4linux](http://ssl.bulix.org/projects/lcd4linux/) (LCD2USB support is built-in), [LCD Smartie](http://lcdsmartie.sourceforge.net/) (requires a [seperate driver](LCD2USB.dll)), and [LCDProc](http://lcdproc.org/) (LCD2USB support is built-in). + +Every now and then i have spare PCBs available. Send me an email if you are interested. + +LCD2USB makes use of several projects to achieve this goal. LCD2USB is based on: + +* [LCD4LINUX, a great framework to use small LCDs with linux](http://ssl.bulix.org/projects/lcd4linux/), +* [AVR-USB, a pure software implementation of USB for the AVR plattform](http://www.obdev.at/products/avrusb/index.html), +* [USBtiny, another software usb implementation for the AVR](http://www.xs4all.nl/~dicks/avr/usbtiny/), and +* [Peter Fleurys LCD routines for the AVR](http://jump.to/fleury) + +## Hardware + +[](images/prototyp.jpg) + +**The prototype board** + +![](images/4x20-front.jpg) | ![](images/4x20-rear.jpg) +---- | ---- +**The final pcb mounted on a 4x20 display** | **The USB connector is mounted on the rear PCB side** + +The hardware of the LCD2USB interface consists of the [Atmel AVR Mega8 CPU](http://www.atmel.com/dyn/products/product_card.asp?part_id=2004), a cheap and easy to obtain microcontroller with 8 KBytes flash (of which ~3k are used in this application) and 2 KBytes RAM. The processor is surrounded by few parts, mainly connectors to interface to the PC and the LCD. + +![](images/lcd2usb-front.jpg) + +A power LED (LED1) indicates that the system is powered via USB. The system clock is derived from a 12Mhz crystal. This frequency is necessary due to the fact that the software USB implementation requires a precise timing with respect to the USB. + +### The USB interface + +The USB interface of the LCD2USB interface is based on a pure software implementation and uses three pins of the AVR (PC0, PC1 and PD2). This software implementation supports low speed USB only which is signalled to the PC by resistor R1\. The current version 1.1 of the LCD2USB operates the USB data lines at 3.6V which complies to the USB spec and increases compatibility over version 1.0. + +The USB connection may be done via a USB B style connector. This is the square connector that is typically used for USB devices (unlike the flat A style connector used at USB hosts). The USB connector is to be **mounted at the solder side** (the rear side of the PCB without the white printing). Mounting it to the component side may damage the LCD2USB or even the PC when plugging it in. Alternally a cable may directly be attached to the component side of the board as depicted in the image below. + +![](images/cable.gif) | ![](images/simple.jpg) +---- | ---- +**Direct attachment of an USB cable** | **The minimum working setup for pre-flashed CPUs** + +The whole device a so called bus powered device. This means that the complete device is powered directly from USB. Therefore the AVR and the LCD are powered from the USB VBUS signal. This signal can deliver max 500mA to a device. The power supply is filtered and buffered by C3 and C6. + +### The LCD interface + +The LCD2USB interface supports several different HD44780 based text displays. It supports single controller displays (tested with 16*2, 20*2 and 20*4) and dual controller displays (tested with 27*4 and 40*4). The LCD2USB interface uses the 4 bit interface provided by the HD44780. + +![](images/connectors.gif) + +Two different connectors (JP1 and JP2) are present to interface to most common HD44780 displays. The extension connector JP6 expands JP2 for the dual controller display connectors as used on e.g. 40*4 displays. See figures for details. Since the power supply of the 40*4 connection varies from the 20*2 connector style, the solder bridges SJ2 and SJ3 allow to adjust the power supply polarity on JP2. The default setting is for the 20*2 style connection. The following image shows how to change the settings for a 4x40 display: + +![](images/bridge-4x40.jpg) + +**Warning:** Using the wrong polarity will most likely destroy the LCD, the interface and may even damage the PCs USB port. Please make sure, that the connector of the display matches the signal layout on the LCD2USB board. You might want to use a USB hub between the LCD2USB and your PC during the first trials. This lowers the risk of damanging the PC if you didn't get the LCD power supply correctly. However, you may still damage the LCD2USB, the LCD and your hub. + +![](images/disp_con1.gif) | ![](images/disp_con2.gif) | ![](images/disp_con3.gif) +---- | ---- | ---- +**Display: 2*16, 4*16, 4*20** | **Display: 2*20, 2*40** | **Display: 4*40 (adjust solder bridge!)** + +#### Power supply considerations + +Special care has to be taken with displays with backlighting. The LCD2USB has been designed to draw at most 75mA which is fine for typical LCDs with LED backlighting. This value is also reported to the host PC via the USB configuration. The LCD2USB interface hardware is able to supply up to 100mA via its software adjustable backlight control. This is a limitation of the transistor T1\. If the backlighting draws more than 100mA, transistor T1 has to be replaced (see the section "part list remarks" below for more details) and special care has to be taken not to overload the USB which can source at most 500mA in total to a bus powered device. An increased backlight current should be reflected in the USB configuration of the device by adjusting the value of USB_CFG_MAX_BUS_POWER in the file usbconfig.h of the firmware sourcecode. You'll then have to recompile the firmware to make it signal its increased power consumption via USB. These firmware changes may not be necessary with all PCs but some may even shut down the power supply for a device that actually draws more current than its USB descriptors indicate. + +### Programming interface (ISP) + +The firmware is uploaded using the standard 10 pin AVR ISP connector (SV1). A separate programming cable is required to load the firmware onto the LCD2USB. A [simple do-it-yourself cable](images/avrisp.gif) will be sufficient. A PC software like e.g. [Ponyprog](http://www.lancos.com/prog.html) or [UISP](http://savannah.nongnu.org/projects/uisp/) will then be used to upload the firware via this cable to the AVR on the LCD2USB device. The programming cable is only required once, since the firmware is permanently stored in the AVRs internal flash memory. + +### The serial interface + +Connector JP3 provides the serial interface of the AVR. This connector is meant for debugging purposes only and must not be directly connected to a PCs RS232 interface. Instead a level shifter (e.g. MAX232) must be inserted. + +### Schematics and pcb layout + +[![](images/schematic-small.gif)](circuit/schematic.pdf) [![](images/pcb-small.gif)](circuit/pcb.pdf) ![](images/pcb.jpg) + +#### NEW: PCB version 1.1 + +The latest PCB version includes the two zener diodes to increase USB compatibility. Furthermore the power supply inductor has turned out not to be neccessary and has thus been removed to make space for the new zener diodes. + +I sometimes have spare PCBs. Send me an email if you want to buy one of them. + +### Part list + +You can get all parts directly via the [lcd2usb part list at Reichelt](http://www.reichelt.de/?ACTION=20;AWKID=50388;PROVID=2084). This list is for the V1.1 pcb and includes the following parts: + +| Part | Qty | Name | [Reichelt Part No.](http://www.reichelt.de) | [Conrad Part No.](http://www.conrad.de) | +| ---- | ---- | ---- | ---- | +| Q1 | 1 | 12Mhz crystal, HC49U package | 12,0000-HC49U-S | 445167 | +| R1 | 1 | 2.2k ohm resistor | 1/4W 2,2k | 403296 | +| R2, R3 | 2 | 68 ohm resistor | 1/4W 68 | 403113 | +| R4 | 1 | 47 ohm resistor | 1/4W 47 | 403091 | +| R5 | 1 | 220 ohm resistor | 1/4W 220 | 403172 | +| R6 | 1 | 4.7k ohm resistor | 1/4W 4,7k | 403334 | +| C1, C2 | 2 | 22pF ceramic capacitor, 2.54mm | KERKO 22P | 457167 | +| C3, C5 | 2 | 100nF capacitor, 5.08mm | X7R-5 100N | 453358 | +| C6, C7 | 2 | 10μF electrolytic capacitor | RAD 10/35 | 472484 | +| T1 | 1 | BC547C transistor | BC 547C | 154989 | +| L1 | 1 | 10μH inductor | SMCC 10μ | 535729 | +| S1, S2 | 2 | push button | TASTER 9305 | 700460 | +| SV1 | 1 | 10 pin ISP connector | WSL 10G | 744026 | +| JP1 | 1 | display connector | BL 1X20G 2,54 | 734993 | +| JP2, JP6 | 1 | display connector | BL 2X10G 2,54 | 741159 | +| -- | 1 | display side connector for JP2/JP6 | SL 2X10G 2,54 | 744026 | +| JP3 | 1 | 4 pin debug connector, display side connector for JP1 | SL 1X36G 2,54 | 744018 | +| LED1 | 1 | LED 3mm green | LED 3MM GN | 184713 | +| -- | 1 | USB-B print connector | USB BW | 743950 | +| IC1 | 1 | Atmega8-16 DIP | ATMEGA 8-16 DIP | 154054 | +| -- | 1 | socket for IC1 | GS 28P-S | 189515 | +| D1, D2 | 2 | 3.6V zener diode | ZF 3,6 | 180050 | + +Additionally required: Display, USB cable + +#### Part list remarks + +The crystal should be in the small HC49U package. You can use a crystal in HC18 package, but you'd then have to mount it from the rear pcb side. + +C1 and C2 should have their pins 2.54mm (1/10 inch) apart, C3 and C5 have their pins 5.08mm (2/10 inch) apart. + +Although T1 is labeled BC547C, a BC547A or BC547B will be fine as well. + +The cathode of LED1 faces the R5 label. The long leg of the LED is thus close to JP1. + +Resistor R4 is the current limiting resistor for backlighting. The 47 ohm in the part list is a useful and secure value for some LCDs with low power LED backlighting. Some displays already include the current limiting resistor and/or require a higher current. The symptom usually is a very dark or even barely visible backlighting with R4 at 47 ohms. You can lower the value of R4 in order to increase the backlight current and thus the brightness. Please consult the datasheet of your display for its backlight power requirements and in order to select the correct current limiting resistors. The BC547 transistor T1 may not be sufficient for displays requiring backlight currents > 100mA. A user has reported success by replacing T1 with a BS170 MOSFET and driving the backlight with 240mA. + +## Uploading the firmware + +If you are familiar with Atmel programming you probably know what you are doing. The Makefile in lcd2usb/firmware/Makefile assumes, that you are using a [simple stk200 compatible printer port adapter](images/avrisp.gif). This is e.g. the same one as sold by [emedia](http://www.emedia.de) for the BlueMP3 device. + +Connect the assembled device (no display required yet) via USB to the PC. It will not be detected yet, since it doesn't contain the firmware. Connect it via the download cable and the programming adapter to the linux pc with installed [uisp tool](http://savannah.nongnu.org/projects/uisp/) and type "make fuse; make flash-nodep" to upload the firmware. + +If the Makefile doesn't work for you you can also flash the device manually using [avrdude](http://www.nongnu.org/avrdude/) and the aforementioned stk200 compatible printer port adapter with the following parameters: + +
avrdude -c stk200 -p atmega8 -U lfuse:w:0x9f:m -U hfuse:w:0xc9:m -U flash:w:firmware-avrusb.hex
+
+ +As of LCD2USB version 1.4, download via usb with the [USBasp tool](http://www.fischl.de/usbasp/) using [avrdude](http://www.nongnu.org/avrdude/) is supported as well. Type "make avrdude-nodep" to upload the firmware this way. + +To manually upload the firmware using the [usbasp](http://www.fischl.de/usbasp/) just use the follwing command: + +
avrdude -c usbasp -p atmega8 -U lfuse:w:0x9f:m -U hfuse:w:0xc9:m -U flash:w:firmware-avrusb.hex
+
+ +If your are familiar with a different AVR programming system you can of course use that one as well. But you'll probably have to do some minor adjustments in the Makefile. + +## Protocol description + +For simplicity reasons, the LCD2USB interface only uses USB control messages. More efficient and faster bulk transfers are only available to high speed devices. A USB control message for a low speed device consists of exactly 8 Bytes. The first byte indicates the control type and has to be set to a fixed value for vendor specific commands like the LCD2USB is using for its own purposes (non vendor specific commands are e.g. used to request the device name and id etc). The remaining seven bytes are the request type (1 byte), a value (2 bytes), an index (2 bytes) and a length field (2 bytes) for data being transmitted with the control transfer. The LCD2USB protocol does not send extra data, thus the last two bytes should be 0 for compatibility reasons. The remaining four bytes (two bytes value and two bytes index) are left for the data transfer. These are used to transmit up to four data bytes per transfer. Four HD44780 command bytes or four HD44780 data bytes can thus be transferred during one USB transaction. + +### Details for the request byte + +
Bit   7 6 5 4 3 2 1 0
+Name  C C C T T R L L
+
+ +
CCC = command type
+  0 (000) = echo
+  1 (001) = command
+  2 (010) = data
+  3 (011) = set
+  4 (100) = get
+  5 (101) = reserved for future use
+  6 (110) = reserved for future use
+  7 (111) = reserved for future use
+
+ +
TT = target id
+R = reserved for future use, set to 0
+LL = number of bytes in transfer - 1
+
+ +The target id has different meaning for the different requests. For command and data transfers it is a two bit bitmap indicating which of the two possible controllers supported by the LCD2USB interface is addressed. Both controllers may be addressed at the same time (e.g. to setup user defined characters). + +For set and get operations the target id specifies the value to set or get. Currently supported values are: + +
set 0 - set brightness
+set 1 - set contrast
+get 0 - get firmware version (msb = major version, lsb = minor version)
+get 1 - get button bitmap
+get 2 - get detected controllers
+
+ +See the testapp source code delivered with the LCD2USB firmware archive for further details. + +## Software + +The LCD2USB interface was originally developed for use with [lcd4linux](http://ssl.bulix.org/projects/lcd4linux/). In the meantime [LCD Smartie](http://lcdsmartie.sourceforge.net/) and [LCDProc](http://lcdproc.org/) have been extended to support the LCD2USB as well. The LCD2USB software archives contain a little demo application that can be used as a basis for further LCD2USB ports. Currently Linux, MacOS X and Windows are supported by this application. + +### Using LCD2USB under Windows + +Harald Körfgen wrote a LCD Smartie plugin for LCD2USB finally allowing the LCD2USB to be used under Windows as well. Here's what he writes about his plugin: + +[LCD2USB-smartie.zip](LCD2USB-smartie.zip) contains all the necessary source files requried to compile the driver with Microsoft ® Windows Server® 2003 R2 Platform SDK, Microsoft Visual C++ 2005 Express Edition and LibUsb-Win32\. [LCD2USB.dll](LCD2USB.dll) is the resulting file. + +In order to use the driver libusb-win32 has also to be installed and the [LCD2USB.dll](LCD2USB.dll) has to be placed in the "displays" directory of LCD Smartie and it will be auto-detected and automatically be used. He has only tested his driver with a 20x4 display yet, so feedback is welcome. + +## Troubleshooting + +Problem: The device seems to work fine, it is detected correctly by Linux, but i get various error messages when accessing it from the test application. + +Solution: Make sure that you run the test application as the root user since the standard user may lack the rights to access all aspects of the lcd2usb hardware. + +Problem: The device is not properly detected. Linux reports an error like "device not accepting address" in the system log but the LCD displays the init message (LCD2USB VXX.XX). + +Solution: The USB interface is not working at all. Your AVR is very likely running at the wrong speed. Please make sure that the fuses are set correctly. If this doesn't help, the zener diodes may be too slow (see next problem). + +Problem: The device is not properly detected. Linux reports an an error like "device descriptor read/all, error -71" in the system log. + +Solution: The device is working partly and the USB transfers are unreliable. This was often caused by "slow" high current zener diodes which i had on the Reichelt part list some time ago. These slow diodes are easily recognized as they have thicker wires than the other parts. You can just try to remove the zener diodes and the device will work if your host PC copes with 5V on the USB data lines (most PCs do, especially older ones). Also using a USB hub between a device without zener diodes and the PC may lead to a working setup even if the PC does not accept 5V on the USB data lines. Otherwise you need faster diodes as a replacement like the one available from reichelt under part no "ZF 3,6". These are also part of the current part list and are known to work. + +## Links + +* [LCD4LINUX, lcd interfacing for linux](http://ssl.bulix.org/projects/lcd4linux/) +* [AVR-USB, software USB for the AVR plattform](http://www.obdev.at/products/avrusb/index.html) +* [USBtiny, another software usb implementation for the AVR](http://www.xs4all.nl/~dicks/avr/usbtiny/) +* [LCD routines for the AVR plattform](http://jump.to/fleury) +* [USB user space library libusb](http://libusb.sourceforge.net/) +* [Win32 port of libusb](http://libusb-win32.sourceforge.net/) +* [LCD Smartie, the Windows pendant of lcd4linux](http://lcdsmartie.sourceforge.net/) +* [Later version of LCDproc include LCD2USB support](http://lcdproc.org/) + +## User contributions + +* [Gallery of LCD2USB assembly](http://gallery.port23.de/v/bastard/wrap/lcd/?g2_page=4&g2_navId=x4b94fc39) +* [Support for 12 button matrix keyboard on lcd2usb](http://lists.omnipotent.net/pipermail/lcdproc/2010-February/013267.html) diff --git a/circuit/lcd2usb.brd b/circuit/lcd2usb.brd new file mode 100644 index 0000000000000000000000000000000000000000..134ebb3acad13f95b4ac2dc2eeffd939f2fa833d GIT binary patch literal 37067 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 Ad;kCd literal 0 HcmV?d00001 diff --git a/circuit/lcd2usb.sch b/circuit/lcd2usb.sch new file mode 100644 index 0000000000000000000000000000000000000000..c1583d1a22a1eface387476bbe806703ec07ff8f GIT binary patch literal 295443 zcmeF43!EKQmF}xM0Rn^&l5|LTgcw2yk3gqS5(2{@B;g$(h7eIOyfG*QOak&g$V&ud z7*s@ti--<`h{z~13?iVSqM~vIAA=4eGKk1v1`!aGuDkww*H^X9?$ccmWE8LU`*l|K zS6{8Y_gZT|t4`JMbKaaCwoR4|9zJ-T?C-z4#)X$GI%(F$*Sv3o?1^JPdDDtLFZ$Nt zwX;*lf9$%A_WbmBhj(ThWGi<$=c|MFxaiwMGymTaS(bNXS$6fuI6nR6Ge+IA=Pyn_ z|IH(_VI9Le2HTl%EI9F`_@9y4;LgrLToI1>C!W0gm>ⅅe!SZD)|9#M11hz!L9sh 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
  • rZf`>_D3JDc2!W-0{P@Lwb=#z5!Rh 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 l+FD$6iS`*~jV_*^ZH& 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%0D4TxC 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 M!$7@M)$Zm00MSZF=>Px# literal 0 HcmV?d00001 diff --git a/firmware/COPYING b/firmware/COPYING new file mode 100644 index 0000000..a52b16e --- /dev/null +++ b/firmware/COPYING @@ -0,0 +1,341 @@ + + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) 19yy + + 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 2 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, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) 19yy name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. diff --git a/firmware/Makefile b/firmware/Makefile new file mode 100644 index 0000000..41ec976 --- /dev/null +++ b/firmware/Makefile @@ -0,0 +1,84 @@ +# Name: Makefile +# Project: Remote Sensor +# Author: Christian Starkjohann, modified for LCD2USB by Till Harbaum +# Creation Date: 2005-03-20 +# Tabsize: 4 +# Copyright: (c) 2005 by OBJECTIVE DEVELOPMENT Software GmbH +# License: Proprietary, free under certain conditions. See Documentation. +# This Revision: $Id: Makefile.avrusb,v 1.1 2007/01/14 12:12:27 harbaum Exp $ + +# DEFINES += -DBWCT_COMPAT +# DEFINES += -DDEBUG_LEVEL=1 +DEFINES += -DF_CPU=12000000 +COMPILE = avr-gcc -Wall -O2 -Iusbdrv -I. -mmcu=atmega8 $(DEFINES) + +OBJECTS = usbdrv/usbdrv.o usbdrv/usbdrvasm.o usbdrv/oddebug.o main.o lcd.o + + +# symbolic targets: +all: firmware.hex + +.c.o: + $(COMPILE) -c $< -o $@ + +.S.o: + $(COMPILE) -x assembler-with-cpp -c $< -o $@ +# "-x assembler-with-cpp" should not be necessary since this is the default +# file type for the .S (with capital S) extension. However, upper case +# characters are not always preserved on Windows. To ensure WinAVR +# compatibility define the file type manually. + +.c.s: + $(COMPILE) -S $< -o $@ + +flash: all + avrdude -c usbasp -p atmega8 -U lfuse:w:0x9f:m -U hfuse:w:0xc9:m -U flash:w:firmware.hex + +flash-nodep: + avrdude -c usbasp -p atmega8 -U lfuse:w:0x9f:m -U hfuse:w:0xc9:m -U flash:w:firmware.hex + +# Fuse high byte: +# 0xc9 = 1 1 0 0 1 0 0 1 <-- BOOTRST (boot reset vector at 0x0000) +# ^ ^ ^ ^ ^ ^ ^------ BOOTSZ0 +# | | | | | +-------- BOOTSZ1 +# | | | | + --------- EESAVE (don't preserve EEPROM over chip erase) +# | | | +-------------- CKOPT (full output swing) +# | | +---------------- SPIEN (allow serial programming) +# | +------------------ WDTON (WDT not always on) +# +-------------------- RSTDISBL (reset pin is enabled) +# Fuse low byte: +# 0x9f = 1 0 0 1 1 1 1 1 +# ^ ^ \ / \--+--/ +# | | | +------- CKSEL 3..0 (external >8M crystal) +# | | +--------------- SUT 1..0 (crystal osc, BOD enabled) +# | +------------------ BODEN (BrownOut Detector enabled) +# +-------------------- BODLEVEL (2.7V) +fuse: + $(UISP) --wr_fuse_h=0xc9 --wr_fuse_l=0x9f + + +clean: + rm -f firmware.lst firmware.obj firmware.cof firmware.list firmware.map firmware.eep.hex firmware.bin *.o usbdrv/*.o firmware.s usbdrv/oddebug.s usbdrv/usbdrv.s + +# file targets: +firmware.bin: $(OBJECTS) + $(COMPILE) -o firmware.bin $(OBJECTS) + +firmware.hex: firmware.bin + rm -f firmware.hex firmware.eep.hex + avr-objcopy -j .text -j .data -O ihex firmware.bin firmware.hex + ./checksize firmware.bin 8192 960 +# do the checksize script as our last action to allow successful compilation +# on Windows with WinAVR where the Unix commands will fail. + +avrdude: firmware.hex + avrdude -c usbasp -p atmega8 -U lfuse:w:0x9f:m -U hfuse:w:0xc9:m -U flash:w:firmware.hex + +avrdude-nodep: + avrdude -c usbasp -p atmega8 -U lfuse:w:0x9f:m -U hfuse:w:0xc9:m -U flash:w:firmware.hex + +disasm: firmware.bin + avr-objdump -d firmware.bin + +cpp: + $(COMPILE) -E main.c diff --git a/firmware/checksize b/firmware/checksize new file mode 100755 index 0000000..96f2563 --- /dev/null +++ b/firmware/checksize @@ -0,0 +1,35 @@ +#!/bin/sh +# Name: checksize +# Project: AVR Make system +# Author: Christian Starkjohann +# Creation Date: 2004-12-29 +# Tabsize: 4 +# Copyright: (c) 2005 OBJECTIVE DEVELOPMENT Software GmbH. +# Revision: $Id: checksize,v 1.1.1.1 2007/01/14 11:37:56 harbaum Exp $ + +error=0 +codelimit=2048 # default value +datalimit=96 # default value; leave 32 bytes for stack + +if [ $# -gt 1 ]; then + codelimit="$2" +fi +if [ $# -gt 2 ]; then + datalimit="$3" +fi + +set -- `avr-size -d "$1" | awk '/[0-9]/ {print $1 + $2, $2 + $3, $2}'` +if [ $1 -gt $codelimit ]; then + echo "*** code size $1 exceeds limit of $codelimit" + error=1 +else + echo "ROM: $1 bytes (data=$3)" +fi +if [ $2 -gt $datalimit ]; then + echo "*** data size $2 exceeds limit of $datalimit" + error=1 +else + echo "RAM: $2 bytes" +fi + +exit $error diff --git a/firmware/firmware.bin b/firmware/firmware.bin new file mode 100755 index 0000000000000000000000000000000000000000..a61f64a16e2b9b57517514c79974bd0e52afbd89 GIT binary patch literal 9901 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 Hlga-Av&h{} literal 0 HcmV?d00001 diff --git a/firmware/firmware.hex b/firmware/firmware.hex new file mode 100644 index 0000000..06aface --- /dev/null +++ b/firmware/firmware.hex @@ -0,0 +1,174 @@ +:1000000049C0C1C162C061C060C05FC05EC05DC0A8 +:100010005CC05BC05AC059C058C057C056C055C01C +:1000200054C053C052C0040309041A0354006900A9 +:100030006C006C00200048006100720062006100EA +:1000400075006D0024034C0043004400320055004D +:1000500053004200200049006E00740065007200E9 +:10006000660061006300650012011001FF000008D6 +:10007000030430C60901010200010902190001014F +:10008000008025090400000100000000070581032D +:1000900008000A0011241FBECFE5D4E0DEBFCDBFAB +:1000A00010E0A0E6B0E0EAEAFAE002C005900D92A6 +:1000B000A038B107D9F710E0A0E8B0E001C01D9268 +:1000C000AC3BB107E1F7EBD2EFC49ACF85B78360C1 +:1000D00085BF8BB780648BBF8BE4809392008AE5E9 +:1000E0008093910008951F93CF93DF939091A20086 +:1000F000935097FD09C020919F0080919E008D3202 +:1001000009F44CC01092A2008091600084FF39C0B5 +:10011000609161006F3FA9F1693008F06AC01092E8 +:1001200061008091860098E8892780938600662385 +:1001300009F47AC02091A0003091A1008091800044 +:1001400086FF69C0962FF901A7E8B0E084918D93EE +:1001500031969150D9F76150C901860F911D6F5F9B +:1001600001969093A1008093A0007727162F87E82F +:1001700090E005D11C5F1C3008F45BC01CE01093BC +:10018000600094E102C0915021F083B38370D9F3F1 +:10019000BAC01092A30010929D00B5C0983009F02B +:1001A000B1CFC2EBD0E0C21BD10983EC80938600B3 +:1001B0008AE5809360001092800088818076E9F55E +:1001C0009A8110928F0089818823D9F5109290002E +:1001D0008FE890E022E09093A1008093A0008F81AF +:1001E000882321F48E81821708F4282F2093610040 +:1001F00089CF6850609361008091860098E88927D4 +:100200008093860068E02091A0003091A100809149 +:10021000800086FD97CF962FF901A7E8B0E0819185 +:100220008D939150E1F797CF60E087E890E0A7D0F9 +:1002300014E08FEF80936100A2CFCE017FD2282FF0 +:10024000CECF853071F0863091F0883031F1893031 +:1002500061F18A3031F18B30F1F18FE890E020E0EC +:10026000BACF9093A3008FE890E020E0B4CF8B81C9 +:10027000813049F18230F9F0833029F020E080E4C8 +:1002800080938000ACCF992351F586E290E0909363 +:10029000A1008093A00024E0F2CF85EA90E021E065 +:1002A0009ACF8FE890E021E096CF9093A5008FE859 +:1002B00090E020E090CF8AE790E09093A1008093B7 +:1002C000A00029E1DCCF88E690E09093A100809324 +:1002D000A00022E1D4CF8BE480939200BECF913076 +:1002E00051F0923059F684E490E09093A10080930D +:1002F000A00024E2C4CF8AE290E09093A100809312 +:10030000A0002AE1BCCFDF91CF911F9108951F93E8 +:10031000DC01162F8091910084FF0FC08091920024 +:1003200098E8892780939200912FE3E9F0E08D917E +:10033000819391501916DCF304C08AE580939100F3 +:10034000F3CF612F83E990E01AD01C5F10939100E6 +:100350001F910895A82FB92F80E090E041E050EA66 +:10036000609530E009C02D9182279795879510F010 +:1003700084279527305EC8F36F5FA8F30895EADFFE +:100380008D939D930895CF93CFB7CF93C395989BAB +:10039000E9F7989B09C0989B07C0989B05C0989B5C +:1003A00003C0989B01C0A3C0DF93C0919F00DD27CD +:1003B000CA55DF4F989B02C0DF91EBCF2F930F936D +:1003C0001F9303B32FEF00FB20F94F933F9313B319 +:1003D0004FEF012700FB21F93BE031C04E7F012F99 +:1003E00013B3216028C0102F4D7F2260000003B39B +:1003F00029C04B7F2460012F000013B32BC013B31F +:10040000477F28602AC04F7E03B320612CC04F7DF8 +:1004100013B320622FC04F7B03B3206432C0422746 +:1004200003B349934FEF0000102710FB20F913B3DB +:100430001370C9F1297F91F2012700FB21F903B361 +:10044000237F89F2315058F1102710FB22F913B3A2 +:10045000277E79F2012700FB23F92F7C81F203B379 +:10046000102710FB24F92F7971F200C013B3012774 +:1004700000FB25F92F7359F200C003B3102710FBBE +:1004800026F9223040F200C013B3012700FB27F900 +:10049000243028F64F77206813B30000F9CF10E41A +:1004A0001ABF002719C03B503195C31BD04010E440 +:1004B0001ABF0881033CF9F00B34E9F020919D004C +:1004C0001981110F1213EDCF4A81441F093641F1F2 +:1004D0000D3211F0013E29F70093A4003F914F9196 +:1004E0001F910F912F91DF91CAB7C6FD4FCFCF91CA +:1004F000CFBFCF9118952091A400222379F31091BA +:10050000A200112369F534306AF13093A2002093E0 +:100510009E0010919F003BE0311B30939F0022C052 +:100520000091A2000130E4F40AE54F7049F43091E3 +:10053000600034FD19C000936000C6E8D0E018C028 +:100540003091910034FD10C000939100C2E9D0E0D9 +:100550000FC02795A8F45150A9F4220F0000F9CF3D +:100560004AE503C042ED01C0432FC4E1D0E032E0D0 +:1005700014B31360A89A14BB05B320E413E05F938F +:10058000012756E005BB279520F4515021F4220F96 +:10059000F9CF012756E000003B5A05BBD0F2279562 +:1005A00028F4515029F4220F0000F9CF012756E01A +:1005B000279505BB20F4515021F4220FF9CF0127D4 +:1005C00056E02991332305BB21F60C7F1091A3003F +:1005D000110FC651D04005BB11F010939D0010E4DF +:1005E0001ABF016014B31C7F402F4C7F5F9100C085 +:1005F00000C005BB14BB45BB71CF20E030E0D90182 +:100600003FD2802D823481F082E4D901082E40D27D +:100610008FEF21E030E0D901082E3AD242E050E0DD +:10062000DA01082E35D204C021E030E042E050E08B +:1006300087B3866087BB81EE8FBD89E08EBD89B7A9 +:10064000837C89BFD9011CD2802D99279BBD8ABD8F +:10065000DA0116D2802D992799BD88BD0895982F6B +:1006600021E030E0D9010CD2802D981719F0D90182 +:10067000092E0ED2892F99279BBD8ABD0895982FE8 +:1006800022E030E0D901FCD1802D981719F0D90172 +:10069000092EFED1892F992799BD88BD089588E13B +:1006A00090E02EE00FB6F894A89581BD0FBE21BD55 +:1006B00088EF81BB12BA15BA8FEF84BB80E49CE946 +:1006C0000197F1F78CEF84BB01DD97DFA598AD9A18 +:1006D000B898C09A81E086D1882329F08091810062 +:1006E00081608093810082E07DD1882321F1809117 +:1006F000810082608093810080FD16C081FD0DC065 +:10070000992780FF06C081FF04C069E770E083E09D +:1007100057D17894A895E7DCFDCF60E770E082E0E0 +:100720004FD180918100ECCF62E670E081E048D14A +:1007300080918100E3CF80918100DECFFF920F9303 +:100740001F93CF93DF93EC0182E890E09093A10098 +:100750008093A000898193E0F92EF822F394869586 +:1007600086958695982F9370869586958230F9F0B8 +:10077000833040F0833009F443C0843091F180E04D +:1007800090E069C0882321F18130C9F70091810090 +:100790000923A9F3FF2099F310E0FE01E10FF11DF9 +:1007A0006281802FF2D01F5FF116B9F7E8CF009178 +:1007B0008100092321F3FF2011F310E0FE01E10F76 +:1007C000F11D6281802FEDD01F5FF116B9F7D7CFF1 +:1007D0008A81809382008B818093830082E090E005 +:1007E0003AC0913029F19130D0F0923041F68091A9 +:1007F0008100809382001092830082E090E02BC001 +:10080000992341F0913009F0BACF8A8138DF80E036 +:1008100090E021C08A8123DF80E090E01CC081E06D +:100820008093820089E08093830082E090E013C08F +:1008300083B3B09B0EC090E08295869587708095BB +:100840008170982B909382001092830082E090E058 +:1008500002C092E0F1CFDF91CF911F910F91FF90F5 +:1008600008959927AC014170507080FDAB9A9C01AE +:100870002270307081FDAC9A00C04111AB98232BDF +:1008800009F0AC980895FF920F931F93F82E062F4E +:10089000442311F0939A01C09398AA9881B3806F72 +:1008A00081BB12B31F70802F807F812B82BB8F2D65 +:1008B000D8DF0295007F012B02BB8F2DD2DF106F96 +:1008C00012BB1F910F91FF900895982F662359F145 +:1008D000939AAA9A81B38F7081BB82B3806F82BBD7 +:1008E000892F9927BC016170707080FDAB9AAC01B3 +:1008F0004270507081FDAC9A00C080B36111AB981A +:100900004115510509F0AC9800C06111AB9A411531 +:10091000510509F0AC9A00C020B36111AB98452B8A +:1009200021F0AC9802C09398D4CF807F22952F708D +:10093000822B99270895FF920F931F93CF93DF93F4 +:1009400099278C0101701070EC01C270D07004C046 +:10095000FF24209791F00CC001151105C9F360E048 +:1009600081E0B3DFF82EFF1CFF24FF1C209729F045 +:1009700060E082E0AADF87FDEFCFFF2069F7DF911B +:10098000CF911F910F91FF9008950F931F93182FF0 +:10099000062FD1DF40E0602F812F75DF1F910F916F +:1009A00008950F931F93182F062FC5DF41E0602F86 +:1009B000812F69DF1F910F91089561E0E6DF0895AF +:1009C0001F93CF93DF93182FEB016881662331F0DB +:1009D0002196812FE6DF68816623D1F7DF91CF91E1 +:1009E0001F9108951F93CF93DF93182F81B3806FCA +:1009F00081BB8B9AA29AA39AA49A80E89BEB019759 +:100A0000F1F782B38F70806382BB812F2ADF80E889 +:100A10009AE30197F1F7812F24DFC0ECD0E0CE01FB +:100A20000197F1F7812F1DDFCE010197F1F7919822 +:100A3000812F17DFCE010197F1F760E0812F45DFAD +:100A400087FD18C068E2812FA0DF2197F1F760E0F1 +:100A5000812F3BDF87FD0EC068E0812F96DF812F5D +:100A6000ACDF66E0812F91DF6CE0812F8EDF81E0CB +:100A700090E002C080E090E0DF91CF911F91089557 +:100A8000E199FECFBFBBAEBBE09A11960DB20895BF +:100A9000E199FECFBFBBAEBB0DBA11960FB6F8946D +:0A0AA000E29AE19A0FBE0895FFCF1D +:100AAA005AFF4C4344325553422056312E303900B6 +:100ABA00326E64206374726C0020626F7468210065 +:00000001FF diff --git a/firmware/lcd.c b/firmware/lcd.c new file mode 100644 index 0000000..e6e4be5 --- /dev/null +++ b/firmware/lcd.c @@ -0,0 +1,312 @@ +/**************************************************************************** + Title : HD44780U LCD library / stripped down version for lcd@usb + Author: Peter Fleury http://jump.to/fleury + lcd@usb modifications by Till Harbaum + File: $Id: lcd.c,v 1.2 2007/01/14 12:12:27 harbaum Exp $ + Software: AVR-GCC 3.3 + Target: any AVR device, memory mapped mode only for AT90S4414/8515/Mega + + DESCRIPTION + Basic routines for interfacing a HD44780U-based text lcd display + + Originally based on Volker Oth's lcd library, + changed lcd_init(), added additional constants for lcd_command(), + added 4-bit I/O mode, improved and optimized code. + + Memory mapped mode compatible with Kanda STK200, but supports also + generation of R/W signal through A8 address line. + + Major changes for LCD2USB: Removed many functions not needed in + LCD2USB. Added support for a second controller. + + USAGE + See the C include lcd.h file for a description of each function + +*****************************************************************************/ +#include +#include +#include +#include + +#include "lcd.h" + +/* +** constants/macros +*/ +#define DDR(x) (*(&x - 1)) /* address of data direction register of port x */ +#define PIN(x) (*(&x - 2)) /* address of input register of port x */ + +#define lcd_e_delay() __asm__ __volatile__( "rjmp 1f\n 1:" ); +#define lcd_e0_high() LCD_E_PORT |= _BV(LCD_E0_PIN); +#define lcd_e0_low() LCD_E_PORT &= ~_BV(LCD_E0_PIN); +#define lcd_e1_high() LCD_E_PORT |= _BV(LCD_E1_PIN); +#define lcd_e1_low() LCD_E_PORT &= ~_BV(LCD_E1_PIN); +#define lcd_rw_high() LCD_RW_PORT |= _BV(LCD_RW_PIN) +#define lcd_rw_low() LCD_RW_PORT &= ~_BV(LCD_RW_PIN) +#define lcd_rs_high() LCD_RS_PORT |= _BV(LCD_RS_PIN) +#define lcd_rs_low() LCD_RS_PORT &= ~_BV(LCD_RS_PIN) + +/* we don't really know anything about the display attached, */ +/* so assume that it's a display with two lines */ +#define LCD_FUNCTION_DEFAULT LCD_FUNCTION_4BIT_2LINES + +/* +** function prototypes +*/ +static void lcd_e_toggle(uint8_t ctrl); + +/* +** local functions +*/ + + +/************************************************************************* + delay loop for small accurate delays: 16-bit counter, 4 cycles/loop +*************************************************************************/ +static inline void _delayFourCycles(unsigned int __count) +{ + if ( __count == 0 ) + __asm__ __volatile__( "rjmp 1f\n 1:" ); // 2 cycles + else + __asm__ __volatile__ ( + "1: sbiw %0,1" "\n\t" + "brne 1b" // 4 cycles/loop + : "=w" (__count) + : "0" (__count) + ); +} + + +/************************************************************************* +delay for a minimum of microseconds +the number of loops is calculated at compile-time from MCU clock frequency +*************************************************************************/ +#define delay(us) _delayFourCycles( ( ( 1*(XTAL/4000) )*us)/1000 ) + + +/* toggle Enable Pin to initiate write */ +static void lcd_e_toggle(uint8_t ctrl) +{ + if(ctrl & LCD_CTRL_0) lcd_e0_high(); + if(ctrl & LCD_CTRL_1) lcd_e1_high(); + + lcd_e_delay(); + + if(ctrl & LCD_CTRL_0) lcd_e0_low(); + if(ctrl & LCD_CTRL_1) lcd_e1_low(); +} + + +/************************************************************************* +Low-level function to write byte to LCD controller +Input: data byte to write to LCD + rs 1: write data + 0: write instruction +Returns: none +*************************************************************************/ +static void lcd_write(uint8_t ctrl, uint8_t data, uint8_t rs) +{ + unsigned char dataBits ; + + + if (rs) lcd_rs_high(); /* write data (RS=1, RW=0) */ + else lcd_rs_low(); /* write instruction (RS=0, RW=0) */ + lcd_rw_low(); + + /* configure data pins as output */ + DDR(LCD_DATA_PORT) |= 0xF0; + + /* output high nibble first */ + dataBits = LCD_DATA_PORT & 0x0F; + LCD_DATA_PORT = dataBits |(data&0xF0); + lcd_e_toggle(ctrl); + + /* output low nibble */ + LCD_DATA_PORT = dataBits | (data<<4); + lcd_e_toggle(ctrl); + + /* all data pins high (inactive) */ + LCD_DATA_PORT = dataBits | 0xF0; +} + +/************************************************************************* +Low-level function to read byte from LCD controller +Input: rs 1: read data + 0: read busy flag / address counter +Returns: byte read from LCD controller +*************************************************************************/ +static uint8_t lcd_read(uint8_t ctrl, uint8_t rs) +{ + uint8_t data; + + if (rs) lcd_rs_high(); /* RS=1: read data */ + else lcd_rs_low(); /* RS=0: read busy flag */ + lcd_rw_high(); /* RW=1 read mode */ + + DDR(LCD_DATA_PORT) &= 0x0F; /* configure data pins as input */ + LCD_DATA_PORT |= 0xF0; /* enable pullups to get a busy */ + /* on unconnected display */ + + if(ctrl & LCD_CTRL_0) lcd_e0_high(); + if(ctrl & LCD_CTRL_1) lcd_e1_high(); + lcd_e_delay(); + data = PIN(LCD_DATA_PORT) & 0xF0; /* read high nibble first */ + if(ctrl & LCD_CTRL_0) lcd_e0_low(); + if(ctrl & LCD_CTRL_1) lcd_e1_low(); + + lcd_e_delay(); /* Enable 500ns low */ + + if(ctrl & LCD_CTRL_0) lcd_e0_high(); + if(ctrl & LCD_CTRL_1) lcd_e1_high(); + lcd_e_delay(); + data |= PIN(LCD_DATA_PORT) >> 4; /* read low nibble */ + if(ctrl & LCD_CTRL_0) lcd_e0_low(); + if(ctrl & LCD_CTRL_1) lcd_e1_low(); + + return data; +} + + +/************************************************************************* +loops while lcd is busy, returns address counter +*************************************************************************/ +static void lcd_waitbusy(uint8_t ctrl) +{ +#if 1 + uint8_t busy; + + do { + busy = 0; + + /* check all controllers separately */ + if(ctrl & LCD_CTRL_0) + if((lcd_read(LCD_CTRL_0, 0)) & (1<> 4); + lcd_e_toggle(ctrl); + delay(64); /* some displays need this additional delay */ + + /* from now the LCD only accepts 4 bit I/O, we can use lcd_command() */ + + /* try to find out of there's a controller and return 0 if not */ + + /* display must not be busy anymore */ + if((lcd_read(ctrl, 0)) & (1< http://jump.to/fleury + File: $Id: lcd.h,v 1.1.1.1 2007/01/14 11:37:56 harbaum Exp $ + Software: AVR-GCC 3.3 + Hardware: any AVR device, memory mapped mode only for AT90S4414/8515/Mega +***************************************************************************/ + +/** + @defgroup pfleury_lcd LCD library + @code #include @endcode + + @brief Basic routines for interfacing a HD44780U-based text LCD display + + Originally based on Volker Oth's LCD library, + changed lcd_init(), added additional constants for lcd_command(), + added 4-bit I/O mode, improved and optimized code. + + Memory mapped mode compatible with Kanda STK200, but supports also + generation of R/W signal through A8 address line. + + @author Peter Fleury pfleury@gmx.ch http://jump.to/fleury + + @see The chapter Interfacing a HD44780 Based LCD to an AVR + on my home page. + +*/ + +/*@{*/ + +#if (__GNUC__ * 100 + __GNUC_MINOR__) < 303 +#error "This library requires AVR-GCC 3.3 or later, update to newer AVR-GCC compiler !" +#endif + +#include +#include + +/** + * @name Definitions for MCU Clock Frequency + * Adapt the MCU clock frequency in Hz to your target. + */ +#define XTAL 12000000 /**< clock frequency in Hz, used to calculate delay timer */ + +/** + * @name Definitions for 4-bit IO mode + * Change LCD_PORT if you want to use a different port for the LCD pins. + * + * The four LCD data lines and the three control lines RS, RW, E can be on the + * same port or on different ports. + * Change LCD_RS_PORT, LCD_RW_PORT, LCD_E_PORT if you want the control lines on + * different ports. + * + * Normally the four data lines should be mapped to bit 0..3 on one port, but it + * is possible to connect these data lines in different order or even on different + * ports by adapting the LCD_DATAx_PORT and LCD_DATAx_PIN definitions. + * + */ +#define LCD_DATA_PORT PORTD /**< port for the LCD lines */ +#define LCD_RS_PORT PORTD /**< port for RS line */ +#define LCD_RS_PIN 3 /**< pin for RS line */ +#define LCD_RW_PORT PORTC /**< port for RW line */ +#define LCD_RW_PIN 2 /**< pin for RW line */ +#define LCD_E_PORT PORTC /**< port for Enable line */ +#define LCD_E0_PIN 3 /**< pin for Enable line 0 */ +#define LCD_E1_PIN 4 /**< pin for Enable line 1 */ + +#define LCD_CTRL_0 (1<<0) +#define LCD_CTRL_1 (1<<1) + +/** + * @name Definitions for LCD command instructions + * The constants define the various LCD controller instructions which can be passed to the + * function lcd_command(), see HD44780 data sheet for a complete description. + */ + +/* instruction register bit positions, see HD44780U data sheet */ +#define LCD_CLR 0 /* DB0: clear display */ +#define LCD_HOME 1 /* DB1: return to home position */ +#define LCD_ENTRY_MODE 2 /* DB2: set entry mode */ +#define LCD_ENTRY_INC 1 /* DB1: 1=increment, 0=decrement */ +#define LCD_ENTRY_SHIFT 0 /* DB2: 1=display shift on */ +#define LCD_ON 3 /* DB3: turn lcd/cursor on */ +#define LCD_ON_DISPLAY 2 /* DB2: turn display on */ +#define LCD_ON_CURSOR 1 /* DB1: turn cursor on */ +#define LCD_ON_BLINK 0 /* DB0: blinking cursor ? */ +#define LCD_MOVE 4 /* DB4: move cursor/display */ +#define LCD_MOVE_DISP 3 /* DB3: move display (0-> cursor) ? */ +#define LCD_MOVE_RIGHT 2 /* DB2: move right (0-> left) ? */ +#define LCD_FUNCTION 5 /* DB5: function set */ +#define LCD_FUNCTION_8BIT 4 /* DB4: set 8BIT mode (0->4BIT mode) */ +#define LCD_FUNCTION_2LINES 3 /* DB3: two lines (0->one line) */ +#define LCD_FUNCTION_10DOTS 2 /* DB2: 5x10 font (0->5x7 font) */ +#define LCD_CGRAM 6 /* DB6: set CG RAM address */ +#define LCD_DDRAM 7 /* DB7: set DD RAM address */ +#define LCD_BUSY 7 /* DB7: LCD is busy */ + +/* set entry mode: display shift on/off, dec/inc cursor move direction */ +#define LCD_ENTRY_DEC 0x04 /* display shift off, dec cursor move dir */ +#define LCD_ENTRY_DEC_SHIFT 0x05 /* display shift on, dec cursor move dir */ +#define LCD_ENTRY_INC_ 0x06 /* display shift off, inc cursor move dir */ +#define LCD_ENTRY_INC_SHIFT 0x07 /* display shift on, inc cursor move dir */ + +/* display on/off, cursor on/off, blinking char at cursor position */ +#define LCD_DISP_OFF 0x08 /* display off */ +#define LCD_DISP_ON 0x0C /* display on, cursor off */ +#define LCD_DISP_ON_BLINK 0x0D /* display on, cursor off, blink char */ +#define LCD_DISP_ON_CURSOR 0x0E /* display on, cursor on */ +#define LCD_DISP_ON_CURSOR_BLINK 0x0F /* display on, cursor on, blink char */ + +/* move cursor/shift display */ +#define LCD_MOVE_CURSOR_LEFT 0x10 /* move cursor left (decrement) */ +#define LCD_MOVE_CURSOR_RIGHT 0x14 /* move cursor right (increment) */ +#define LCD_MOVE_DISP_LEFT 0x18 /* shift display left */ +#define LCD_MOVE_DISP_RIGHT 0x1C /* shift display right */ + +/* function set: set interface data length and number of display lines */ +#define LCD_FUNCTION_4BIT_1LINE 0x20 /* 4-bit interface, single line, 5x7 dots */ +#define LCD_FUNCTION_4BIT_2LINES 0x28 /* 4-bit interface, dual line, 5x7 dots */ +#define LCD_FUNCTION_8BIT_1LINE 0x30 /* 8-bit interface, single line, 5x7 dots */ +#define LCD_FUNCTION_8BIT_2LINES 0x38 /* 8-bit interface, dual line, 5x7 dots */ + + +#define LCD_MODE_DEFAULT ((1< + * License: GPL + * This Revision: $Id: main.c,v 1.2 2007/01/14 12:12:27 harbaum Exp $ + */ + +#include +#include +#include +#include +#include + +#include + +#include "lcd.h" + +// use avrusb library +#include "usbdrv.h" +#include "oddebug.h" + +#define VERSION_MAJOR 1 +#define VERSION_MINOR 9 +#define VERSION_STR "1.09" +// change USB_CFG_DEVICE_VERSION in usbconfig.h as well + +// EEMEM wird bei aktuellen Versionen der avr-lib in eeprom.h definiert +// hier: definiere falls noch nicht bekannt ("alte" avr-libc) +#ifndef EEMEM +// alle Textstellen EEMEM im Quellcode durch __attribute__ ... ersetzen +#define EEMEM __attribute__ ((section (".eeprom"))) +#endif + +/* bitmask of detected lcd controllers */ +uchar controller = 0; + +/* ------------------------------------------------------------------------- */ +/* PWM units are used for contrast and backlight brightness */ + +/* contrast and brightness are stored in eeprom */ +uchar eeprom_valid EEMEM; +uchar eeprom_contrast EEMEM; +uchar eeprom_brightness EEMEM; + +void pwm_init(void) { + + /* check if eeprom is valid and set default values if not */ + /* initial values: full contrast and full brightness */ + if(eeprom_read_byte(&eeprom_valid) != 0x42) { + + /* write magic "eeprom is valid" marker 0x42 and default values */ + eeprom_write_byte(&eeprom_valid, 0x42); + eeprom_write_byte(&eeprom_contrast, 0xff); + eeprom_write_byte(&eeprom_brightness, 0xff); + } + + /* PortB: set DDB1 and DDB2 => PORTB1 and PORTB2 are output */ + DDRB |= _BV(1) | _BV(2); + + /* Set Timer1: + - Fast PWM,8bit => Mode 5 (WGM13=0,WGM12=1,WGM11=0,WGM10=1) + - Output-Mode: lower voltage is higher contrast + => Set OC1A on Compare Match, clear OC1A at BOTTOM, (inverting mode) + COM1A1=1,COM1A0=1 + higher voltage is higher brightness + => Clear OC1B on Compare Match, set OC1B at BOTTOM, (non-inverting mode) + COM1B1=1,COM1B0=0 + - Timer runs at inernal clock with no prescaling => CS12=0,CS11=0,CS10=1 + */ + TCCR1A = _BV(COM1A1) | _BV(COM1A0) | _BV(COM1B1) | _BV(WGM10); + TCCR1B = _BV(WGM12) | _BV(CS10); + + TIMSK &=( (~_BV(2)) & (~_BV(3)) & (~_BV(4)) & (~_BV(5))); + + OCR1A = eeprom_read_byte(&eeprom_contrast); + OCR1B = eeprom_read_byte(&eeprom_brightness); +} + +void set_contrast(uchar value) { + /* store value in eeprom if it actually changed */ + if(value != eeprom_read_byte(&eeprom_contrast)) + eeprom_write_byte(&eeprom_contrast, value); + + OCR1A = value; // lower voltage is higher contrast +} + +void set_brightness(uchar value) { + /* store value in eeprom if it actually changed */ + if(value != eeprom_read_byte(&eeprom_brightness)) + eeprom_write_byte(&eeprom_brightness, value); + + OCR1B = value; // higher voltage is higher brightness +} + +/* ------------------------------------------------------------------------- */ + +uchar usbFunctionSetup(uchar data[8]) { + static uchar replyBuf[4]; + usbMsgPtr = replyBuf; + uchar len = (data[1] & 3)+1; // 1 .. 4 bytes + uchar target = (data[1] >> 3) & 3; // target 0 .. 3 + uchar i; + + // request byte: + + // 7 6 5 4 3 2 1 0 + // C C C T T R L L + + // TT = target bit map + // R = reserved for future use, set to 0 + // LL = number of bytes in transfer - 1 + + switch(data[1] >> 5) { + + case 0: // echo (for transfer reliability testing) + replyBuf[0] = data[2]; + replyBuf[1] = data[3]; + return 2; + break; + + case 1: // command + target &= controller; // mask installed controllers + + if(target) // at least one controller should be used ... + for(i=0;i when compiling with IAR. + - Introduced USB_CFG_DESCR_PROPS_* in usbconfig.h to configure how each + USB descriptor should be handled. It is now possible to provide descriptor + data in Flash, RAM or dynamically at runtime. + - STALL is now a status in usbTxLen* instead of a message. We can now conform + to the spec and leave the stall status pending until it is cleared. + - Made usbTxPacketCnt1 and usbTxPacketCnt3 public. This allows the + application code to reset data toggling on interrupt pipes. + +* Release 2006-07-18 + + - Added an #if !defined __ASSEMBLER__ to the warning in usbdrv.h. This fixes + an assembler error. + - usbDeviceDisconnect() takes pull-up resistor to high impedance now. + +* Release 2007-02-01 + + - Merged in some code size improvements from usbtiny (thanks to Dick + Streefland for these optimizations!) + - Special alignment requirement for usbRxBuf not required any more. Thanks + again to Dick Streefland for this hint! + - Reverted to "#warning" instead of unused static variables -- new versions + of IAR CC should handle this directive. + - Changed Open Source license to GNU GPL v2 in order to make linking against + other free libraries easier. We no longer require publication of the + circuit diagrams, but we STRONGLY encourage it. If you improve the driver + itself, PLEASE grant us a royalty free license to your changes for our + commercial license. + +* Release 2007-03-29 + + - New configuration option "USB_PUBLIC" in usbconfig.h. + - Set USB version number to 1.10 instead of 1.01. + - Code used USB_CFG_DESCR_PROPS_STRING_DEVICE and + USB_CFG_DESCR_PROPS_STRING_PRODUCT inconsistently. Changed all occurrences + to USB_CFG_DESCR_PROPS_STRING_PRODUCT. + - New assembler module for 16.5 MHz RC oscillator clock with PLL in receiver + code. + - New assembler module for 16 MHz crystal. + - usbdrvasm.S contains common code only, clock-specific parts have been moved + to usbdrvasm12.S, usbdrvasm16.S and usbdrvasm165.S respectively. + +* Release 2007-06-25 + + - 16 MHz module: Do SE0 check in stuffed bits as well. + +* Release 2007-07-07 + + - Define hi8(x) for IAR compiler to limit result to 8 bits. This is necessary + for negative values. + - Added 15 MHz module contributed by V. Bosch. + - Interrupt vector name can now be configured. This is useful if somebody + wants to use a different hardware interrupt than INT0. + +* Release 2007-08-07 + + - Moved handleIn3 routine in usbdrvasm16.S so that relative jump range is + not exceeded. + - More config options: USB_RX_USER_HOOK(), USB_INITIAL_DATATOKEN, + USB_COUNT_SOF + - USB_INTR_PENDING can now be a memory address, not just I/O + +* Release 2007-09-19 + + - Split out common parts of assembler modules into separate include file + - Made endpoint numbers configurable so that given interface definitions + can be matched. See USB_CFG_EP3_NUMBER in usbconfig-prototype.h. + - Store endpoint number for interrupt/bulk-out so that usbFunctionWriteOut() + can handle any number of endpoints. + - Define usbDeviceConnect() and usbDeviceDisconnect() even if no + USB_CFG_PULLUP_IOPORTNAME is defined. Directly set D+ and D- to 0 in this + case. + +* Release 2007-12-01 + + - Optimize usbDeviceConnect() and usbDeviceDisconnect() for less code size + when USB_CFG_PULLUP_IOPORTNAME is not defined. + +* Release 2007-12-13 + + - Renamed all include-only assembler modules from *.S to *.inc so that + people don't add them to their project sources. + - Distribute leap bits in tx loop more evenly for 16 MHz module. + - Use "macro" and "endm" instead of ".macro" and ".endm" for IAR + - Avoid compiler warnings for constant expr range by casting some values in + USB descriptors. + +* Release 2008-01-21 + + - Fixed bug in 15 and 16 MHz module where the new address set with + SET_ADDRESS was already accepted at the next NAK or ACK we send, not at + the next data packet we send. This caused problems when the host polled + too fast. Thanks to Alexander Neumann for his help and patience debugging + this issue! + +* Release 2008-02-05 + + - Fixed bug in 16.5 MHz module where a register was used in the interrupt + handler before it was pushed. This bug was introduced with version + 2007-09-19 when common parts were moved to a separate file. + - Optimized CRC routine (thanks to Reimar Doeffinger). + +* Release 2008-02-16 + + - Removed outdated IAR compatibility stuff (code sections). + - Added hook macros for USB_RESET_HOOK() and USB_SET_ADDRESS_HOOK(). + - Added optional routine usbMeasureFrameLength() for calibration of the + internal RC oscillator. + +* Release 2008-02-28 + + - USB_INITIAL_DATATOKEN defaults to USBPID_DATA1 now, which means that we + start with sending USBPID_DATA0. + - Changed defaults in usbconfig-prototype.h + - Added free USB VID/PID pair for MIDI class devices + - Restructured AVR-USB as separate package, not part of PowerSwitch any more. + +* Release 2008-04-18 + + - Restructured usbdrv.c so that it is easier to read and understand. + - Better code optimization with gcc 4. + - If a second interrupt in endpoint is enabled, also add it to config + descriptor. + - Added config option for long transfers (above 254 bytes), see + USB_CFG_LONG_TRANSFERS in usbconfig.h. + - Added 20 MHz module contributed by Jeroen Benschop. + +* Release 2008-05-13 + + - Fixed bug in libs-host/hiddata.c function usbhidGetReport(): length + was not incremented, pointer to length was incremented instead. + - Added code to command line tool(s) which claims an interface. This code + is disabled by default, but may be necessary on newer Linux kernels. + - Added usbconfig.h option "USB_CFG_CHECK_DATA_TOGGLING". + - New header "usbportability.h" prepares ports to other development + environments. + - Long transfers (above 254 bytes) did not work when usbFunctionRead() was + used to supply the data. Fixed this bug. [Thanks to Alexander Neumann!] + - In hiddata.c (example code for sending/receiving data over HID), use + USB_RECIP_DEVICE instead of USB_RECIP_INTERFACE for control transfers so + that we need not claim the interface. + - in usbPoll() loop 20 times polling for RESET state instead of 10 times. + This accounts for the higher clock rates we now support. + - Added a module for 12.8 MHz RC oscillator with PLL in receiver loop. + - Added hook to SOF code so that oscillator can be tuned to USB frame clock. + - Added timeout to waitForJ loop. Helps preventing unexpected hangs. + - Added example code for oscillator tuning to libs-device (thanks to + Henrik Haftmann for the idea to this routine). + - Implemented option USB_CFG_SUPPRESS_INTR_CODE. + +* Release 2008-10-22 + + - Fixed libs-device/osctune.h: OSCCAL is memory address on ATMega88 and + similar, not offset of 0x20 needs to be added. + - Allow distribution under GPLv3 for those who have to link against other + code distributed under GPLv3. + +* Release 2008-11-26 + + - Removed libusb-win32 dependency for hid-data example in Makefile.windows. + It was never required and confused many people. + - Added extern uchar usbRxToken to usbdrv.h. + - Integrated a module with CRC checks at 18 MHz by Lukas Schrittwieser. + +* Release 2009-03-23 + + - Hid-mouse example used settings from hid-data example, fixed that. + - Renamed project to V-USB due to a trademark issue with Atmel(r). + - Changed CommercialLicense.txt and USBID-License.txt to make the + background of USB ID registration clearer. + +* Release 2009-04-15 + + - Changed CommercialLicense.txt to reflect the new range of PIDs from + Jason Kotzin. + - Removed USBID-License.txt in favor of USB-IDs-for-free.txt and + USB-ID-FAQ.txt + - Fixed a bug in the 12.8 MHz module: End Of Packet decection was made in + the center between bit 0 and 1 of each byte. This is where the data lines + are expected to change and the sampled data may therefore be nonsense. + We therefore check EOP ONLY if bits 0 AND 1 have both been read as 0 on D-. + - Fixed a bitstuffing problem in the 16 MHz module: If bit 6 was stuffed, + the unstuffing code in the receiver routine was 1 cycle too long. If + multiple bytes had the unstuffing in bit 6, the error summed up until the + receiver was out of sync. + - Included option for faster CRC routine. + Thanks to Slawomir Fras (BoskiDialer) for this code! + - Updated bits in Configuration Descriptor's bmAttributes according to + USB 1.1 (in particular bit 7, it is a must-be-set bit now). + +* Release 2009-08-22 + + - Moved first DBG1() after odDebugInit() in all examples. + - Use vector INT0_vect instead of SIG_INTERRUPT0 if defined. This makes + V-USB compatible with the new "p" suffix devices (e.g. ATMega328p). + - USB_CFG_CLOCK_KHZ setting is now required in usbconfig.h (no default any + more). + - New option USB_CFG_DRIVER_FLASH_PAGE allows boot loaders on devices with + more than 64 kB flash. + - Built-in configuration descriptor allows custom definition for second + endpoint now. + +* Release 2010-07-15 diff --git a/firmware/usbdrv/CommercialLicense.txt b/firmware/usbdrv/CommercialLicense.txt new file mode 100644 index 0000000..11d07d9 --- /dev/null +++ b/firmware/usbdrv/CommercialLicense.txt @@ -0,0 +1,166 @@ +V-USB Driver Software License Agreement +Version 2009-08-03 + +THIS LICENSE AGREEMENT GRANTS YOU CERTAIN RIGHTS IN A SOFTWARE. YOU CAN +ENTER INTO THIS AGREEMENT AND ACQUIRE THE RIGHTS OUTLINED BELOW BY PAYING +THE AMOUNT ACCORDING TO SECTION 4 ("PAYMENT") TO OBJECTIVE DEVELOPMENT. + + +1 DEFINITIONS + +1.1 "OBJECTIVE DEVELOPMENT" shall mean OBJECTIVE DEVELOPMENT Software GmbH, +Grosse Schiffgasse 1A/7, 1020 Wien, AUSTRIA. + +1.2 "You" shall mean the Licensee. + +1.3 "V-USB" shall mean all files included in the package distributed under +the name "vusb" by OBJECTIVE DEVELOPMENT (http://www.obdev.at/vusb/) +unless otherwise noted. This includes the firmware-only USB device +implementation for Atmel AVR microcontrollers, some simple device examples +and host side software examples and libraries. + + +2 LICENSE GRANTS + +2.1 Source Code. OBJECTIVE DEVELOPMENT shall furnish you with the source +code of V-USB. + +2.2 Distribution and Use. OBJECTIVE DEVELOPMENT grants you the +non-exclusive right to use, copy and distribute V-USB with your hardware +product(s), restricted by the limitations in section 3 below. + +2.3 Modifications. OBJECTIVE DEVELOPMENT grants you the right to modify +the source code and your copy of V-USB according to your needs. + +2.4 USB IDs. OBJECTIVE DEVELOPMENT furnishes you with one or two USB +Product ID(s), sent to you in e-mail. These Product IDs are reserved +exclusively for you. OBJECTIVE DEVELOPMENT has obtained USB Product ID +ranges under the Vendor ID 5824 from Wouter van Ooijen (Van Ooijen +Technische Informatica, www.voti.nl) and under the Vendor ID 8352 from +Jason Kotzin (Clay Logic, www.claylogic.com). Both owners of the Vendor IDs +have obtained these IDs from the USB Implementers Forum, Inc. +(www.usb.org). OBJECTIVE DEVELOPMENT disclaims all liability which might +arise from the assignment of USB IDs. + +2.5 USB Certification. Although not part of this agreement, we want to make +it clear that you cannot become USB certified when you use V-USB or a USB +Product ID assigned by OBJECTIVE DEVELOPMENT. AVR microcontrollers don't +meet the electrical specifications required by the USB specification and +the USB Implementers Forum certifies only members who bought a Vendor ID of +their own. + + +3 LICENSE RESTRICTIONS + +3.1 Number of Units. Only one of the following three definitions is +applicable. Which one is determined by the amount you pay to OBJECTIVE +DEVELOPMENT, see section 4 ("Payment") below. + +Hobby License: You may use V-USB according to section 2 above in no more +than 5 hardware units. These units must not be sold for profit. + +Entry Level License: You may use V-USB according to section 2 above in no +more than 150 hardware units. + +Professional License: You may use V-USB according to section 2 above in +any number of hardware units, except for large scale production ("unlimited +fair use"). Quantities below 10,000 units are not considered large scale +production. If your reach quantities which are obviously large scale +production, you must pay a license fee of 0.10 EUR per unit for all units +above 10,000. + +3.2 Rental. You may not rent, lease, or lend V-USB or otherwise encumber +any copy of V-USB, or any of the rights granted herein. + +3.3 Transfer. You may not transfer your rights under this Agreement to +another party without OBJECTIVE DEVELOPMENT's prior written consent. If +such consent is obtained, you may permanently transfer this License to +another party. The recipient of such transfer must agree to all terms and +conditions of this Agreement. + +3.4 Reservation of Rights. OBJECTIVE DEVELOPMENT retains all rights not +expressly granted. + +3.5 Non-Exclusive Rights. Your license rights under this Agreement are +non-exclusive. + +3.6 Third Party Rights. This Agreement cannot grant you rights controlled +by third parties. In particular, you are not allowed to use the USB logo or +other trademarks owned by the USB Implementers Forum, Inc. without their +consent. Since such consent depends on USB certification, it should be +noted that V-USB will not pass certification because it does not +implement checksum verification and the microcontroller ports do not meet +the electrical specifications. + + +4 PAYMENT + +The payment amount depends on the variation of this agreement (according to +section 3.1) into which you want to enter. Concrete prices are listed on +OBJECTIVE DEVELOPMENT's web site, usually at +http://www.obdev.at/vusb/license.html. You agree to pay the amount listed +there to OBJECTIVE DEVELOPMENT or OBJECTIVE DEVELOPMENT's payment processor +or reseller. + + +5 COPYRIGHT AND OWNERSHIP + +V-USB is protected by copyright laws and international copyright +treaties, as well as other intellectual property laws and treaties. V-USB +is licensed, not sold. + + +6 TERM AND TERMINATION + +6.1 Term. This Agreement shall continue indefinitely. However, OBJECTIVE +DEVELOPMENT may terminate this Agreement and revoke the granted license and +USB-IDs if you fail to comply with any of its terms and conditions. + +6.2 Survival of Terms. All provisions regarding secrecy, confidentiality +and limitation of liability shall survive termination of this agreement. + + +7 DISCLAIMER OF WARRANTY AND LIABILITY + +LIMITED WARRANTY. V-USB IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY +KIND. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, OBJECTIVE +DEVELOPMENT AND ITS SUPPLIERS HEREBY DISCLAIM ALL WARRANTIES, EITHER +EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND +NON-INFRINGEMENT, WITH REGARD TO V-USB, AND THE PROVISION OF OR FAILURE +TO PROVIDE SUPPORT SERVICES. THIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL +RIGHTS. YOU MAY HAVE OTHERS, WHICH VARY FROM STATE/JURISDICTION TO +STATE/JURISDICTION. + +LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, +IN NO EVENT SHALL OBJECTIVE DEVELOPMENT OR ITS SUPPLIERS BE LIABLE FOR ANY +SPECIAL, INCIDENTAL, INDIRECT, OR CONSEQUENTIAL DAMAGES WHATSOEVER +(INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, +BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY +LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE V-USB OR THE +PROVISION OF OR FAILURE TO PROVIDE SUPPORT SERVICES, EVEN IF OBJECTIVE +DEVELOPMENT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN ANY +CASE, OBJECTIVE DEVELOPMENT'S ENTIRE LIABILITY UNDER ANY PROVISION OF THIS +AGREEMENT SHALL BE LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU FOR V-USB. + + +8 MISCELLANEOUS TERMS + +8.1 Marketing. OBJECTIVE DEVELOPMENT has the right to mention for marketing +purposes that you entered into this agreement. + +8.2 Entire Agreement. This document represents the entire agreement between +OBJECTIVE DEVELOPMENT and you. It may only be modified in writing signed by +an authorized representative of both, OBJECTIVE DEVELOPMENT and you. + +8.3 Severability. In case a provision of these terms and conditions should +be or become partly or entirely invalid, ineffective, or not executable, +the validity of all other provisions shall not be affected. + +8.4 Applicable Law. This agreement is governed by the laws of the Republic +of Austria. + +8.5 Responsible Courts. The responsible courts in Vienna/Austria will have +exclusive jurisdiction regarding all disputes in connection with this +agreement. + diff --git a/firmware/usbdrv/License.txt b/firmware/usbdrv/License.txt new file mode 100644 index 0000000..4460cfb --- /dev/null +++ b/firmware/usbdrv/License.txt @@ -0,0 +1,361 @@ +OBJECTIVE DEVELOPMENT GmbH's V-USB driver software is distributed under the +terms and conditions of the GNU GPL version 2 or the GNU GPL version 3. It is +your choice whether you apply the terms of version 2 or version 3. The full +text of GPLv2 is included below. In addition to the requirements in the GPL, +we STRONGLY ENCOURAGE you to do the following: + +(1) Publish your entire project on a web site and drop us a note with the URL. +Use the form at http://www.obdev.at/vusb/feedback.html for your submission. + +(2) Adhere to minimum publication standards. Please include AT LEAST: + - a circuit diagram in PDF, PNG or GIF format + - full source code for the host software + - a Readme.txt file in ASCII format which describes the purpose of the + project and what can be found in which directories and which files + - a reference to http://www.obdev.at/vusb/ + +(3) If you improve the driver firmware itself, please give us a free license +to your modifications for our commercial license offerings. + + + + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + 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 2 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, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. diff --git a/firmware/usbdrv/Readme.txt b/firmware/usbdrv/Readme.txt new file mode 100644 index 0000000..970dc66 --- /dev/null +++ b/firmware/usbdrv/Readme.txt @@ -0,0 +1,172 @@ +This is the Readme file to Objective Development's firmware-only USB driver +for Atmel AVR microcontrollers. For more information please visit +http://www.obdev.at/vusb/ + +This directory contains the USB firmware only. Copy it as-is to your own +project and add all .c and .S files to your project (these files are marked +with an asterisk in the list below). Then copy usbconfig-prototype.h as +usbconfig.h to your project and edit it according to your configuration. + + +TECHNICAL DOCUMENTATION +======================= +The technical documentation (API) for the firmware driver is contained in the +file "usbdrv.h". Please read all of it carefully! Configuration options are +documented in "usbconfig-prototype.h". + +The driver consists of the following files: + Readme.txt ............. The file you are currently reading. + Changelog.txt .......... Release notes for all versions of the driver. + usbdrv.h ............... Driver interface definitions and technical docs. +* usbdrv.c ............... High level language part of the driver. Link this + module to your code! +* usbdrvasm.S ............ Assembler part of the driver. This module is mostly + a stub and includes one of the usbdrvasm*.S files + depending on processor clock. Link this module to + your code! + usbdrvasm*.inc ......... Assembler routines for particular clock frequencies. + Included by usbdrvasm.S, don't link it directly! + asmcommon.inc .......... Common assembler routines. Included by + usbdrvasm*.inc, don't link it directly! + usbconfig-prototype.h .. Prototype for your own usbdrv.h file. +* oddebug.c .............. Debug functions. Only used when DEBUG_LEVEL is + defined to a value greater than 0. Link this module + to your code! + oddebug.h .............. Interface definitions of the debug module. + usbportability.h ....... Header with compiler-dependent stuff. + usbdrvasm.asm .......... Compatibility stub for IAR-C-compiler. Use this + module instead of usbdrvasm.S when you assembler + with IAR's tools. + License.txt ............ Open Source license for this driver. + CommercialLicense.txt .. Optional commercial license for this driver. + USB-ID-FAQ.txt ......... General infos about USB Product- and Vendor-IDs. + USB-IDs-for-free.txt ... List and terms of use for free shared PIDs. + +(*) ... These files should be linked to your project. + + +CPU CORE CLOCK FREQUENCY +======================== +We supply assembler modules for clock frequencies of 12 MHz, 12.8 MHz, 15 MHz, +16 MHz, 16.5 MHz 18 MHz and 20 MHz. Other clock rates are not supported. The +actual clock rate must be configured in usbconfig.h. + +12 MHz Clock +This is the traditional clock rate of V-USB because it's the lowest clock +rate where the timing constraints of the USB spec can be met. + +15 MHz Clock +Similar to 12 MHz, but some NOPs inserted. On the other hand, the higher clock +rate allows for some loops which make the resulting code size somewhat smaller +than the 12 MHz version. + +16 MHz Clock +This clock rate has been added for users of the Arduino board and other +ready-made boards which come with a fixed 16 MHz crystal. It's also an option +if you need the slightly higher clock rate for performance reasons. Since +16 MHz is not divisible by the USB low speed bit clock of 1.5 MHz, the code +is somewhat tricky and has to insert a leap cycle every third byte. + +12.8 MHz and 16.5 MHz Clock +The assembler modules for these clock rates differ from the other modules +because they have been built for an RC oscillator with only 1% precision. The +receiver code inserts leap cycles to compensate for clock deviations. 1% is +also the precision which can be achieved by calibrating the internal RC +oscillator of the AVR. Please note that only AVRs with internal 64 MHz PLL +oscillator can reach 16.5 MHz with the RC oscillator. This includes the very +popular ATTiny25, ATTiny45, ATTiny85 series as well as the ATTiny26. Almost +all AVRs can reach 12.8 MHz, although this is outside the specified range. + +See the EasyLogger example at http://www.obdev.at/vusb/easylogger.html for +code which calibrates the RC oscillator based on the USB frame clock. + +18 MHz Clock +This module is closer to the USB specification because it performs an on the +fly CRC check for incoming packets. Packets with invalid checksum are +discarded as required by the spec. If you also implement checks for data +PID toggling on application level (see option USB_CFG_CHECK_DATA_TOGGLING +in usbconfig.h for more info), this ensures data integrity. Due to the CRC +tables and alignment requirements, this code is bigger than modules for other +clock rates. To activate this module, you must define USB_CFG_CHECK_CRC to 1 +and USB_CFG_CLOCK_KHZ to 18000 in usbconfig.h. + +20 MHz Clock +This module is for people who won't do it with less than the maximum. Since +20 MHz is not divisible by the USB low speed bit clock of 1.5 MHz, the code +uses similar tricks as the 16 MHz module to insert leap cycles. + + +USB IDENTIFIERS +=============== +Every USB device needs a vendor- and a product-identifier (VID and PID). VIDs +are obtained from usb.org for a price of 1,500 USD. Once you have a VID, you +can assign PIDs at will. + +Since an entry level cost of 1,500 USD is too high for most small companies +and hobbyists, we provide some VID/PID pairs for free. See the file +USB-IDs-for-free.txt for details. + +Objective Development also has some license offerings which include product +IDs. See http://www.obdev.at/vusb/ for details. + + +DEVELOPMENT SYSTEM +================== +This driver has been developed and optimized for the GNU compiler version 3 +and 4. We recommend that you use the GNU compiler suite because it is freely +available. V-USB has also been ported to the IAR compiler and assembler. It +has been tested with IAR 4.10B/W32 and 4.12A/W32 on an ATmega8 with the +"small" and "tiny" memory model. Not every release is tested with IAR CC and +the driver may therefore fail to compile with IAR. Please note that gcc is +more efficient for usbdrv.c because this module has been deliberately +optimized for gcc. + +Gcc version 3 produces smaller code than version 4 due to new optimizing +capabilities which don't always improve things on 8 bit CPUs. The code size +generated by gcc 4 can be reduced with the compiler options +-fno-move-loop-invariants, -fno-tree-scev-cprop and +-fno-inline-small-functions in addition to -Os. On devices with more than +8k of flash memory, we also recommend the linker option --relax (written as +-Wl,--relax for gcc) to convert absolute calls into relative where possible. + +For more information about optimizing options see: + + http://www.tty1.net/blog/2008-04-29-avr-gcc-optimisations_en.html + +These optimizations are good for gcc 4.x. Version 3.x of gcc does not support +most of these options and produces good code anyway. + + +USING V-USB FOR FREE +==================== +The AVR firmware driver is published under the GNU General Public License +Version 2 (GPL2) and the GNU General Public License Version 3 (GPL3). It is +your choice whether you apply the terms of version 2 or version 3. + +If you decide for the free GPL2 or GPL3, we STRONGLY ENCOURAGE you to do the +following things IN ADDITION to the obligations from the GPL: + +(1) Publish your entire project on a web site and drop us a note with the URL. +Use the form at http://www.obdev.at/vusb/feedback.html for your submission. +If you don't have a web site, you can publish the project in obdev's +documentation wiki at +http://www.obdev.at/goto.php?t=vusb-wiki&p=hosted-projects. + +(2) Adhere to minimum publication standards. Please include AT LEAST: + - a circuit diagram in PDF, PNG or GIF format + - full source code for the host software + - a Readme.txt file in ASCII format which describes the purpose of the + project and what can be found in which directories and which files + - a reference to http://www.obdev.at/vusb/ + +(3) If you improve the driver firmware itself, please give us a free license +to your modifications for our commercial license offerings. + + +COMMERCIAL LICENSES FOR V-USB +============================= +If you don't want to publish your source code under the terms of the GPL, +you can simply pay money for V-USB. As an additional benefit you get +USB PIDs for free, reserved exclusively to you. See the file +"CommercialLicense.txt" for details. + diff --git a/firmware/usbdrv/USB-ID-FAQ.txt b/firmware/usbdrv/USB-ID-FAQ.txt new file mode 100644 index 0000000..d1de8fb --- /dev/null +++ b/firmware/usbdrv/USB-ID-FAQ.txt @@ -0,0 +1,149 @@ +Version 2009-08-22 + +========================== +WHY DO WE NEED THESE IDs? +========================== + +USB is more than a low level protocol for data transport. It also defines a +common set of requests which must be understood by all devices. And as part +of these common requests, the specification defines data structures, the +USB Descriptors, which are used to describe the properties of the device. + +From the perspective of an operating system, it is therefore possible to find +out basic properties of a device (such as e.g. the manufacturer and the name +of the device) without a device-specific driver. This is essential because +the operating system can choose a driver to load based on this information +(Plug-And-Play). + +Among the most important properties in the Device Descriptor are the USB +Vendor- and Product-ID. Both are 16 bit integers. The most simple form of +driver matching is based on these IDs. The driver announces the Vendor- and +Product-IDs of the devices it can handle and the operating system loads the +appropriate driver when the device is connected. + +It is obvious that this technique only works if the pair Vendor- plus +Product-ID is unique: Only devices which require the same driver can have the +same pair of IDs. + + +===================================================== +HOW DOES THE USB STANDARD ENSURE THAT IDs ARE UNIQUE? +===================================================== + +Since it is so important that USB IDs are unique, the USB Implementers Forum, +Inc. (usb.org) needs a way to enforce this legally. It is not forbidden by +law to build a device and assign it any random numbers as IDs. Usb.org +therefore needs an agreement to regulate the use of USB IDs. The agreement +binds only parties who agreed to it, of course. Everybody else is free to use +any numbers for their IDs. + +So how can usb.org ensure that every manufacturer of USB devices enters into +an agreement with them? They do it via trademark licensing. Usb.org has +registered the trademark "USB", all associated logos and related terms. If +you want to put an USB logo on your product or claim that it is USB +compliant, you must license these trademarks from usb.org. And this is where +you enter into an agreement. See the "USB-IF Trademark License Agreement and +Usage Guidelines for the USB-IF Logo" at +http://www.usb.org/developers/logo_license/. + +Licensing the USB trademarks requires that you buy a USB Vendor-ID from +usb.org (one-time fee of ca. 2,000 USD), that you become a member of usb.org +(yearly fee of ca. 4,000 USD) and that you meet all the technical +specifications from the USB spec. + +This means that most hobbyists and small companies will never be able to +become USB compliant, just because membership is so expensive. And you can't +be compliant with a driver based on V-USB anyway, because the AVR's port pins +don't meet the electrical specifications for USB. So, in principle, all +hobbyists and small companies are free to choose any random numbers for their +IDs. They have nothing to lose... + +There is one exception worth noting, though: If you use a sub-component which +implements USB, the vendor of the sub-components may guarantee USB +compliance. This might apply to some or all of FTDI's solutions. + + +======================================================================= +WHY SHOULD YOU OBTAIN USB IDs EVEN IF YOU DON'T LICENSE USB TRADEMARKS? +======================================================================= + +You have learned in the previous section that you are free to choose any +numbers for your IDs anyway. So why not do exactly this? There is still the +technical issue. If you choose IDs which are already in use by somebody else, +operating systems will load the wrong drivers and your device won't work. +Even if you choose IDs which are not currently in use, they may be in use in +the next version of the operating system or even after an automatic update. + +So what you need is a pair of Vendor- and Product-IDs for which you have the +guarantee that no USB compliant product uses them. This implies that no +operating system will ever ship with drivers responsible for these IDs. + + +============================================== +HOW DOES OBJECTIVE DEVELOPMENT HANDLE USB IDs? +============================================== + +Objective Development gives away pairs of USB-IDs with their V-USB licenses. +In order to ensure that these IDs are unique, Objective Development has an +agreement with the company/person who has bought the USB Vendor-ID from +usb.org. This agreement ensures that a range of USB Product-IDs is reserved +for assignment by Objective Development and that the owner of the Vendor-ID +won't give it to anybody else. + +This means that you have to trust three parties to ensure uniqueness of +your IDs: + + - Objective Development, that they don't give the same PID to more than + one person. + - The owner of the Vendor-ID that they don't assign PIDs from the range + assigned to Objective Development to anybody else. + - Usb.org that they don't assign the same Vendor-ID a second time. + + +================================== +WHO IS THE OWNER OF THE VENDOR-ID? +================================== + +Objective Development has obtained ranges of USB Product-IDs under two +Vendor-IDs: Under Vendor-ID 5824 from Wouter van Ooijen (Van Ooijen +Technische Informatica, www.voti.nl) and under Vendor-ID 8352 from Jason +Kotzin (Clay Logic, www.claylogic.com). Both VID owners have received their +Vendor-ID directly from usb.org. + + +========================================================================= +CAN I USE USB-IDs FROM OBJECTIVE DEVELOPMENT WITH OTHER DRIVERS/HARDWARE? +========================================================================= + +The short answer is: Yes. All you get is a guarantee that the IDs are never +assigned to anybody else. What more do you need? + + +============================ +WHAT ABOUT SHARED ID PAIRS? +============================ + +Objective Development has reserved some PID/VID pairs for shared use. You +have no guarantee of uniqueness for them, except that no USB compliant device +uses them. In order to avoid technical problems, we must ensure that all +devices with the same pair of IDs use the same driver on kernel level. For +details, see the file USB-IDs-for-free.txt. + + +====================================================== +I HAVE HEARD THAT SUB-LICENSING OF USB-IDs IS ILLEGAL? +====================================================== + +A 16 bit integer number cannot be protected by copyright laws. It is not +sufficiently complex. And since none of the parties involved entered into the +USB-IF Trademark License Agreement, we are not bound by this agreement. So +there is no reason why it should be illegal to sub-license USB-IDs. + + +============================================= +WHO IS LIABLE IF THERE ARE INCOMPATIBILITIES? +============================================= + +Objective Development disclaims all liabilities which might arise from the +assignment of IDs. If you guarantee product features to your customers +without proper disclaimer, YOU are liable for that. diff --git a/firmware/usbdrv/USB-IDs-for-free.txt b/firmware/usbdrv/USB-IDs-for-free.txt new file mode 100644 index 0000000..2f4d59a --- /dev/null +++ b/firmware/usbdrv/USB-IDs-for-free.txt @@ -0,0 +1,148 @@ +Version 2009-08-22 + +=========================== +FREE USB-IDs FOR SHARED USE +=========================== + +Objective Development has reserved a set of USB Product-IDs for use according +to the guidelines outlined below. For more information about the concept of +USB IDs please see the file USB-ID-FAQ.txt. Objective Development guarantees +that the IDs listed below are not used by any USB compliant devices. + + +==================== +MECHANISM OF SHARING +==================== + +From a technical point of view, two different devices can share the same USB +Vendor- and Product-ID if they require the same driver on operating system +level. We make use of this fact by assigning separate IDs for various device +classes. On application layer, devices must be distinguished by their textual +name or serial number. We offer separate sets of IDs for discrimination by +textual name and for serial number. + +Examples for shared use of USB IDs are included with V-USB in the "examples" +subdirectory. + + +====================================== +IDs FOR DISCRIMINATION BY TEXTUAL NAME +====================================== + +If you use one of the IDs listed below, your device and host-side software +must conform to these rules: + +(1) The USB device MUST provide a textual representation of the manufacturer +and product identification. The manufacturer identification MUST be available +at least in USB language 0x0409 (English/US). + +(2) The textual manufacturer identification MUST contain either an Internet +domain name (e.g. "mycompany.com") registered and owned by you, or an e-mail +address under your control (e.g. "myname@gmx.net"). You can embed the domain +name or e-mail address in any string you like, e.g. "Objective Development +http://www.obdev.at/vusb/". + +(3) You are responsible for retaining ownership of the domain or e-mail +address for as long as any of your products are in use. + +(4) You may choose any string for the textual product identification, as long +as this string is unique within the scope of your textual manufacturer +identification. + +(5) Application side device look-up MUST be based on the textual manufacturer +and product identification in addition to VID/PID matching. The driver +matching MUST be a comparison of the entire strings, NOT a sub-string match. + +(6) For devices which implement a particular USB device class (e.g. HID), the +operating system's default class driver MUST be used. If an operating system +driver for Vendor Class devices is needed, this driver must be libusb or +libusb-win32 (see http://libusb.org/ and +http://libusb-win32.sourceforge.net/). + +Table if IDs for discrimination by textual name: + +PID dec (hex) | VID dec (hex) | Description of use +==============+===============+============================================ +1500 (0x05dc) | 5824 (0x16c0) | For Vendor Class devices with libusb +--------------+---------------+-------------------------------------------- +1503 (0x05df) | 5824 (0x16c0) | For generic HID class devices (which are + | | NOT mice, keyboards or joysticks) +--------------+---------------+-------------------------------------------- +1505 (0x05e1) | 5824 (0x16c0) | For CDC-ACM class devices (modems) +--------------+---------------+-------------------------------------------- +1508 (0x05e4) | 5824 (0x16c0) | For MIDI class devices +--------------+---------------+-------------------------------------------- + +Note that Windows caches the textual product- and vendor-description for +mice, keyboards and joysticks. Name-bsed discrimination is therefore not +recommended for these device classes. + + +======================================= +IDs FOR DISCRIMINATION BY SERIAL NUMBER +======================================= + +If you use one of the IDs listed below, your device and host-side software +must conform to these rules: + +(1) The USB device MUST provide a textual representation of the serial +number. The serial number string MUST be available at least in USB language +0x0409 (English/US). + +(2) The serial number MUST start with either an Internet domain name (e.g. +"mycompany.com") registered and owned by you, or an e-mail address under your +control (e.g. "myname@gmx.net"), both terminated with a colon (":") character. +You MAY append any string you like for further discrimination of your devices. + +(3) You are responsible for retaining ownership of the domain or e-mail +address for as long as any of your products are in use. + +(5) Application side device look-up MUST be based on the serial number string +in addition to VID/PID matching. The matching must start at the first +character of the serial number string and include the colon character +terminating your domain or e-mail address. It MAY stop anywhere after that. + +(6) For devices which implement a particular USB device class (e.g. HID), the +operating system's default class driver MUST be used. If an operating system +driver for Vendor Class devices is needed, this driver must be libusb or +libusb-win32 (see http://libusb.org/ and +http://libusb-win32.sourceforge.net/). + +Table if IDs for discrimination by serial number string: + +PID dec (hex) | VID dec (hex) | Description of use +===============+===============+=========================================== +10200 (0x27d8) | 5824 (0x16c0) | For Vendor Class devices with libusb +---------------+---------------+------------------------------------------- +10201 (0x27d9) | 5824 (0x16c0) | For generic HID class devices (which are + | | NOT mice, keyboards or joysticks) +---------------+---------------+------------------------------------------- +10202 (0x27da) | 5824 (0x16c0) | For USB Mice +---------------+---------------+------------------------------------------- +10203 (0x27db) | 5824 (0x16c0) | For USB Keyboards +---------------+---------------+------------------------------------------- +10204 (0x27db) | 5824 (0x16c0) | For USB Joysticks +---------------+---------------+------------------------------------------- +10205 (0x27dc) | 5824 (0x16c0) | For CDC-ACM class devices (modems) +---------------+---------------+------------------------------------------- +10206 (0x27dd) | 5824 (0x16c0) | For MIDI class devices +---------------+---------------+------------------------------------------- + + +================= +ORIGIN OF USB-IDs +================= + +OBJECTIVE DEVELOPMENT Software GmbH has obtained all VID/PID pairs listed +here from Wouter van Ooijen (see www.voti.nl) for exclusive disposition. +Wouter van Ooijen has obtained the VID from the USB Implementers Forum, Inc. +(see www.usb.org). The VID is registered for the company name "Van Ooijen +Technische Informatica". + + +========== +DISCLAIMER +========== + +OBJECTIVE DEVELOPMENT Software GmbH disclaims all liability for any +problems which are caused by the shared use of these VID/PID pairs. diff --git a/firmware/usbdrv/asmcommon.inc b/firmware/usbdrv/asmcommon.inc new file mode 100644 index 0000000..07d692b --- /dev/null +++ b/firmware/usbdrv/asmcommon.inc @@ -0,0 +1,188 @@ +/* Name: asmcommon.inc + * Project: V-USB, virtual USB port for Atmel's(r) AVR(r) microcontrollers + * Author: Christian Starkjohann + * Creation Date: 2007-11-05 + * Tabsize: 4 + * Copyright: (c) 2007 by OBJECTIVE DEVELOPMENT Software GmbH + * License: GNU GPL v2 (see License.txt), GNU GPL v3 or proprietary (CommercialLicense.txt) + * Revision: $Id$ + */ + +/* Do not link this file! Link usbdrvasm.S instead, which includes the + * appropriate implementation! + */ + +/* +General Description: +This file contains assembler code which is shared among the USB driver +implementations for different CPU cocks. Since the code must be inserted +in the middle of the module, it's split out into this file and #included. + +Jump destinations called from outside: + sofError: Called when no start sequence was found. + se0: Called when a package has been successfully received. + overflow: Called when receive buffer overflows. + doReturn: Called after sending data. + +Outside jump destinations used by this module: + waitForJ: Called to receive an already arriving packet. + sendAckAndReti: + sendNakAndReti: + sendCntAndReti: + usbSendAndReti: + +The following macros must be defined before this file is included: + .macro POP_STANDARD + .endm + .macro POP_RETI + .endm +*/ + +#define token x1 + +overflow: + ldi x2, 1< 0 + +#warning "Never compile production devices with debugging enabled" + +static void uartPutc(char c) +{ + while(!(ODDBG_USR & (1 << ODDBG_UDRE))); /* wait for data register empty */ + ODDBG_UDR = c; +} + +static uchar hexAscii(uchar h) +{ + h &= 0xf; + if(h >= 10) + h += 'a' - (uchar)10 - '0'; + h += '0'; + return h; +} + +static void printHex(uchar c) +{ + uartPutc(hexAscii(c >> 4)); + uartPutc(hexAscii(c)); +} + +void odDebug(uchar prefix, uchar *data, uchar len) +{ + printHex(prefix); + uartPutc(':'); + while(len--){ + uartPutc(' '); + printHex(*data++); + } + uartPutc('\r'); + uartPutc('\n'); +} + +#endif diff --git a/firmware/usbdrv/oddebug.h b/firmware/usbdrv/oddebug.h new file mode 100644 index 0000000..d61309d --- /dev/null +++ b/firmware/usbdrv/oddebug.h @@ -0,0 +1,123 @@ +/* Name: oddebug.h + * Project: AVR library + * Author: Christian Starkjohann + * Creation Date: 2005-01-16 + * Tabsize: 4 + * Copyright: (c) 2005 by OBJECTIVE DEVELOPMENT Software GmbH + * License: GNU GPL v2 (see License.txt), GNU GPL v3 or proprietary (CommercialLicense.txt) + * This Revision: $Id: oddebug.h 692 2008-11-07 15:07:40Z cs $ + */ + +#ifndef __oddebug_h_included__ +#define __oddebug_h_included__ + +/* +General Description: +This module implements a function for debug logs on the serial line of the +AVR microcontroller. Debugging can be configured with the define +'DEBUG_LEVEL'. If this macro is not defined or defined to 0, all debugging +calls are no-ops. If it is 1, DBG1 logs will appear, but not DBG2. If it is +2, DBG1 and DBG2 logs will be printed. + +A debug log consists of a label ('prefix') to indicate which debug log created +the output and a memory block to dump in hex ('data' and 'len'). +*/ + + +#ifndef F_CPU +# define F_CPU 12000000 /* 12 MHz */ +#endif + +/* make sure we have the UART defines: */ +#include "usbportability.h" + +#ifndef uchar +# define uchar unsigned char +#endif + +#if DEBUG_LEVEL > 0 && !(defined TXEN || defined TXEN0) /* no UART in device */ +# warning "Debugging disabled because device has no UART" +# undef DEBUG_LEVEL +#endif + +#ifndef DEBUG_LEVEL +# define DEBUG_LEVEL 0 +#endif + +/* ------------------------------------------------------------------------- */ + +#if DEBUG_LEVEL > 0 +# define DBG1(prefix, data, len) odDebug(prefix, data, len) +#else +# define DBG1(prefix, data, len) +#endif + +#if DEBUG_LEVEL > 1 +# define DBG2(prefix, data, len) odDebug(prefix, data, len) +#else +# define DBG2(prefix, data, len) +#endif + +/* ------------------------------------------------------------------------- */ + +#if DEBUG_LEVEL > 0 +extern void odDebug(uchar prefix, uchar *data, uchar len); + +/* Try to find our control registers; ATMEL likes to rename these */ + +#if defined UBRR +# define ODDBG_UBRR UBRR +#elif defined UBRRL +# define ODDBG_UBRR UBRRL +#elif defined UBRR0 +# define ODDBG_UBRR UBRR0 +#elif defined UBRR0L +# define ODDBG_UBRR UBRR0L +#endif + +#if defined UCR +# define ODDBG_UCR UCR +#elif defined UCSRB +# define ODDBG_UCR UCSRB +#elif defined UCSR0B +# define ODDBG_UCR UCSR0B +#endif + +#if defined TXEN +# define ODDBG_TXEN TXEN +#else +# define ODDBG_TXEN TXEN0 +#endif + +#if defined USR +# define ODDBG_USR USR +#elif defined UCSRA +# define ODDBG_USR UCSRA +#elif defined UCSR0A +# define ODDBG_USR UCSR0A +#endif + +#if defined UDRE +# define ODDBG_UDRE UDRE +#else +# define ODDBG_UDRE UDRE0 +#endif + +#if defined UDR +# define ODDBG_UDR UDR +#elif defined UDR0 +# define ODDBG_UDR UDR0 +#endif + +static inline void odDebugInit(void) +{ + ODDBG_UCR |= (1<len & 0x10){ /* packet buffer was empty */ + txStatus->buffer[0] ^= USBPID_DATA0 ^ USBPID_DATA1; /* toggle token */ + }else{ + txStatus->len = USBPID_NAK; /* avoid sending outdated (overwritten) interrupt data */ + } + p = txStatus->buffer + 1; + i = len; + do{ /* if len == 0, we still copy 1 byte, but that's no problem */ + *p++ = *data++; + }while(--i > 0); /* loop control at the end is 2 bytes shorter than at beginning */ + usbCrc16Append(&txStatus->buffer[1], len); + txStatus->len = len + 4; /* len must be given including sync byte */ + DBG2(0x21 + (((int)txStatus >> 3) & 3), txStatus->buffer, len + 3); +} + +USB_PUBLIC void usbSetInterrupt(uchar *data, uchar len) +{ + usbGenericSetInterrupt(data, len, &usbTxStatus1); +} +#endif + +#if USB_CFG_HAVE_INTRIN_ENDPOINT3 +USB_PUBLIC void usbSetInterrupt3(uchar *data, uchar len) +{ + usbGenericSetInterrupt(data, len, &usbTxStatus3); +} +#endif +#endif /* USB_CFG_SUPPRESS_INTR_CODE */ + +/* ------------------ utilities for code following below ------------------- */ + +/* Use defines for the switch statement so that we can choose between an + * if()else if() and a switch/case based implementation. switch() is more + * efficient for a LARGE set of sequential choices, if() is better in all other + * cases. + */ +#if USB_CFG_USE_SWITCH_STATEMENT +# define SWITCH_START(cmd) switch(cmd){{ +# define SWITCH_CASE(value) }break; case (value):{ +# define SWITCH_CASE2(v1,v2) }break; case (v1): case(v2):{ +# define SWITCH_CASE3(v1,v2,v3) }break; case (v1): case(v2): case(v3):{ +# define SWITCH_DEFAULT }break; default:{ +# define SWITCH_END }} +#else +# define SWITCH_START(cmd) {uchar _cmd = cmd; if(0){ +# define SWITCH_CASE(value) }else if(_cmd == (value)){ +# define SWITCH_CASE2(v1,v2) }else if(_cmd == (v1) || _cmd == (v2)){ +# define SWITCH_CASE3(v1,v2,v3) }else if(_cmd == (v1) || _cmd == (v2) || (_cmd == v3)){ +# define SWITCH_DEFAULT }else{ +# define SWITCH_END }} +#endif + +#ifndef USB_RX_USER_HOOK +#define USB_RX_USER_HOOK(data, len) +#endif +#ifndef USB_SET_ADDRESS_HOOK +#define USB_SET_ADDRESS_HOOK() +#endif + +/* ------------------------------------------------------------------------- */ + +/* We use if() instead of #if in the macro below because #if can't be used + * in macros and the compiler optimizes constant conditions anyway. + * This may cause problems with undefined symbols if compiled without + * optimizing! + */ +#define GET_DESCRIPTOR(cfgProp, staticName) \ + if(cfgProp){ \ + if((cfgProp) & USB_PROP_IS_RAM) \ + flags = 0; \ + if((cfgProp) & USB_PROP_IS_DYNAMIC){ \ + len = usbFunctionDescriptor(rq); \ + }else{ \ + len = USB_PROP_LENGTH(cfgProp); \ + usbMsgPtr = (uchar *)(staticName); \ + } \ + } + +/* usbDriverDescriptor() is similar to usbFunctionDescriptor(), but used + * internally for all types of descriptors. + */ +static inline usbMsgLen_t usbDriverDescriptor(usbRequest_t *rq) +{ +usbMsgLen_t len = 0; +uchar flags = USB_FLG_MSGPTR_IS_ROM; + + SWITCH_START(rq->wValue.bytes[1]) + SWITCH_CASE(USBDESCR_DEVICE) /* 1 */ + GET_DESCRIPTOR(USB_CFG_DESCR_PROPS_DEVICE, usbDescriptorDevice) + SWITCH_CASE(USBDESCR_CONFIG) /* 2 */ + GET_DESCRIPTOR(USB_CFG_DESCR_PROPS_CONFIGURATION, usbDescriptorConfiguration) + SWITCH_CASE(USBDESCR_STRING) /* 3 */ +#if USB_CFG_DESCR_PROPS_STRINGS & USB_PROP_IS_DYNAMIC + if(USB_CFG_DESCR_PROPS_STRINGS & USB_PROP_IS_RAM) + flags = 0; + len = usbFunctionDescriptor(rq); +#else /* USB_CFG_DESCR_PROPS_STRINGS & USB_PROP_IS_DYNAMIC */ + SWITCH_START(rq->wValue.bytes[0]) + SWITCH_CASE(0) + GET_DESCRIPTOR(USB_CFG_DESCR_PROPS_STRING_0, usbDescriptorString0) + SWITCH_CASE(1) + GET_DESCRIPTOR(USB_CFG_DESCR_PROPS_STRING_VENDOR, usbDescriptorStringVendor) + SWITCH_CASE(2) + GET_DESCRIPTOR(USB_CFG_DESCR_PROPS_STRING_PRODUCT, usbDescriptorStringDevice) + SWITCH_CASE(3) + GET_DESCRIPTOR(USB_CFG_DESCR_PROPS_STRING_SERIAL_NUMBER, usbDescriptorStringSerialNumber) + SWITCH_DEFAULT + if(USB_CFG_DESCR_PROPS_UNKNOWN & USB_PROP_IS_DYNAMIC){ + len = usbFunctionDescriptor(rq); + } + SWITCH_END +#endif /* USB_CFG_DESCR_PROPS_STRINGS & USB_PROP_IS_DYNAMIC */ +#if USB_CFG_DESCR_PROPS_HID_REPORT /* only support HID descriptors if enabled */ + SWITCH_CASE(USBDESCR_HID) /* 0x21 */ + GET_DESCRIPTOR(USB_CFG_DESCR_PROPS_HID, usbDescriptorConfiguration + 18) + SWITCH_CASE(USBDESCR_HID_REPORT)/* 0x22 */ + GET_DESCRIPTOR(USB_CFG_DESCR_PROPS_HID_REPORT, usbDescriptorHidReport) +#endif + SWITCH_DEFAULT + if(USB_CFG_DESCR_PROPS_UNKNOWN & USB_PROP_IS_DYNAMIC){ + len = usbFunctionDescriptor(rq); + } + SWITCH_END + usbMsgFlags = flags; + return len; +} + +/* ------------------------------------------------------------------------- */ + +/* usbDriverSetup() is similar to usbFunctionSetup(), but it's used for + * standard requests instead of class and custom requests. + */ +static inline usbMsgLen_t usbDriverSetup(usbRequest_t *rq) +{ +uchar len = 0, *dataPtr = usbTxBuf + 9; /* there are 2 bytes free space at the end of the buffer */ +uchar value = rq->wValue.bytes[0]; +#if USB_CFG_IMPLEMENT_HALT +uchar index = rq->wIndex.bytes[0]; +#endif + + dataPtr[0] = 0; /* default reply common to USBRQ_GET_STATUS and USBRQ_GET_INTERFACE */ + SWITCH_START(rq->bRequest) + SWITCH_CASE(USBRQ_GET_STATUS) /* 0 */ + uchar recipient = rq->bmRequestType & USBRQ_RCPT_MASK; /* assign arith ops to variables to enforce byte size */ + if(USB_CFG_IS_SELF_POWERED && recipient == USBRQ_RCPT_DEVICE) + dataPtr[0] = USB_CFG_IS_SELF_POWERED; +#if USB_CFG_IMPLEMENT_HALT + if(recipient == USBRQ_RCPT_ENDPOINT && index == 0x81) /* request status for endpoint 1 */ + dataPtr[0] = usbTxLen1 == USBPID_STALL; +#endif + dataPtr[1] = 0; + len = 2; +#if USB_CFG_IMPLEMENT_HALT + SWITCH_CASE2(USBRQ_CLEAR_FEATURE, USBRQ_SET_FEATURE) /* 1, 3 */ + if(value == 0 && index == 0x81){ /* feature 0 == HALT for endpoint == 1 */ + usbTxLen1 = rq->bRequest == USBRQ_CLEAR_FEATURE ? USBPID_NAK : USBPID_STALL; + usbResetDataToggling(); + } +#endif + SWITCH_CASE(USBRQ_SET_ADDRESS) /* 5 */ + usbNewDeviceAddr = value; + USB_SET_ADDRESS_HOOK(); + SWITCH_CASE(USBRQ_GET_DESCRIPTOR) /* 6 */ + len = usbDriverDescriptor(rq); + goto skipMsgPtrAssignment; + SWITCH_CASE(USBRQ_GET_CONFIGURATION) /* 8 */ + dataPtr = &usbConfiguration; /* send current configuration value */ + len = 1; + SWITCH_CASE(USBRQ_SET_CONFIGURATION) /* 9 */ + usbConfiguration = value; + usbResetStall(); + SWITCH_CASE(USBRQ_GET_INTERFACE) /* 10 */ + len = 1; +#if USB_CFG_HAVE_INTRIN_ENDPOINT && !USB_CFG_SUPPRESS_INTR_CODE + SWITCH_CASE(USBRQ_SET_INTERFACE) /* 11 */ + usbResetDataToggling(); + usbResetStall(); +#endif + SWITCH_DEFAULT /* 7=SET_DESCRIPTOR, 12=SYNC_FRAME */ + /* Should we add an optional hook here? */ + SWITCH_END + usbMsgPtr = dataPtr; +skipMsgPtrAssignment: + return len; +} + +/* ------------------------------------------------------------------------- */ + +/* usbProcessRx() is called for every message received by the interrupt + * routine. It distinguishes between SETUP and DATA packets and processes + * them accordingly. + */ +static inline void usbProcessRx(uchar *data, uchar len) +{ +usbRequest_t *rq = (void *)data; + +/* usbRxToken can be: + * 0x2d 00101101 (USBPID_SETUP for setup data) + * 0xe1 11100001 (USBPID_OUT: data phase of setup transfer) + * 0...0x0f for OUT on endpoint X + */ + DBG2(0x10 + (usbRxToken & 0xf), data, len + 2); /* SETUP=1d, SETUP-DATA=11, OUTx=1x */ + USB_RX_USER_HOOK(data, len) +#if USB_CFG_IMPLEMENT_FN_WRITEOUT + if(usbRxToken < 0x10){ /* OUT to endpoint != 0: endpoint number in usbRxToken */ + usbFunctionWriteOut(data, len); + return; + } +#endif + if(usbRxToken == (uchar)USBPID_SETUP){ + if(len != 8) /* Setup size must be always 8 bytes. Ignore otherwise. */ + return; + usbMsgLen_t replyLen; + usbTxBuf[0] = USBPID_DATA0; /* initialize data toggling */ + usbTxLen = USBPID_NAK; /* abort pending transmit */ + usbMsgFlags = 0; + uchar type = rq->bmRequestType & USBRQ_TYPE_MASK; + if(type != USBRQ_TYPE_STANDARD){ /* standard requests are handled by driver */ + replyLen = usbFunctionSetup(data); + }else{ + replyLen = usbDriverSetup(rq); + } +#if USB_CFG_IMPLEMENT_FN_READ || USB_CFG_IMPLEMENT_FN_WRITE + if(replyLen == USB_NO_MSG){ /* use user-supplied read/write function */ + /* do some conditioning on replyLen, but on IN transfers only */ + if((rq->bmRequestType & USBRQ_DIR_MASK) != USBRQ_DIR_HOST_TO_DEVICE){ + if(sizeof(replyLen) < sizeof(rq->wLength.word)){ /* help compiler with optimizing */ + replyLen = rq->wLength.bytes[0]; + }else{ + replyLen = rq->wLength.word; + } + } + usbMsgFlags = USB_FLG_USE_USER_RW; + }else /* The 'else' prevents that we limit a replyLen of USB_NO_MSG to the maximum transfer len. */ +#endif + if(sizeof(replyLen) < sizeof(rq->wLength.word)){ /* help compiler with optimizing */ + if(!rq->wLength.bytes[1] && replyLen > rq->wLength.bytes[0]) /* limit length to max */ + replyLen = rq->wLength.bytes[0]; + }else{ + if(replyLen > rq->wLength.word) /* limit length to max */ + replyLen = rq->wLength.word; + } + usbMsgLen = replyLen; + }else{ /* usbRxToken must be USBPID_OUT, which means data phase of setup (control-out) */ +#if USB_CFG_IMPLEMENT_FN_WRITE + if(usbMsgFlags & USB_FLG_USE_USER_RW){ + uchar rval = usbFunctionWrite(data, len); + if(rval == 0xff){ /* an error occurred */ + usbTxLen = USBPID_STALL; + }else if(rval != 0){ /* This was the final package */ + usbMsgLen = 0; /* answer with a zero-sized data packet */ + } + } +#endif + } +} + +/* ------------------------------------------------------------------------- */ + +/* This function is similar to usbFunctionRead(), but it's also called for + * data handled automatically by the driver (e.g. descriptor reads). + */ +static uchar usbDeviceRead(uchar *data, uchar len) +{ + if(len > 0){ /* don't bother app with 0 sized reads */ +#if USB_CFG_IMPLEMENT_FN_READ + if(usbMsgFlags & USB_FLG_USE_USER_RW){ + len = usbFunctionRead(data, len); + }else +#endif + { + uchar i = len, *r = usbMsgPtr; + if(usbMsgFlags & USB_FLG_MSGPTR_IS_ROM){ /* ROM data */ + do{ + uchar c = USB_READ_FLASH(r); /* assign to char size variable to enforce byte ops */ + *data++ = c; + r++; + }while(--i); + }else{ /* RAM data */ + do{ + *data++ = *r++; + }while(--i); + } + usbMsgPtr = r; + } + } + return len; +} + +/* ------------------------------------------------------------------------- */ + +/* usbBuildTxBlock() is called when we have data to transmit and the + * interrupt routine's transmit buffer is empty. + */ +static inline void usbBuildTxBlock(void) +{ +usbMsgLen_t wantLen; +uchar len; + + wantLen = usbMsgLen; + if(wantLen > 8) + wantLen = 8; + usbMsgLen -= wantLen; + usbTxBuf[0] ^= USBPID_DATA0 ^ USBPID_DATA1; /* DATA toggling */ + len = usbDeviceRead(usbTxBuf + 1, wantLen); + if(len <= 8){ /* valid data packet */ + usbCrc16Append(&usbTxBuf[1], len); + len += 4; /* length including sync byte */ + if(len < 12) /* a partial package identifies end of message */ + usbMsgLen = USB_NO_MSG; + }else{ + len = USBPID_STALL; /* stall the endpoint */ + usbMsgLen = USB_NO_MSG; + } + usbTxLen = len; + DBG2(0x20, usbTxBuf, len-1); +} + +/* ------------------------------------------------------------------------- */ + +static inline void usbHandleResetHook(uchar notResetState) +{ +#ifdef USB_RESET_HOOK +static uchar wasReset; +uchar isReset = !notResetState; + + if(wasReset != isReset){ + USB_RESET_HOOK(isReset); + wasReset = isReset; + } +#endif +} + +/* ------------------------------------------------------------------------- */ + +USB_PUBLIC void usbPoll(void) +{ +schar len; +uchar i; + + len = usbRxLen - 3; + if(len >= 0){ +/* We could check CRC16 here -- but ACK has already been sent anyway. If you + * need data integrity checks with this driver, check the CRC in your app + * code and report errors back to the host. Since the ACK was already sent, + * retries must be handled on application level. + * unsigned crc = usbCrc16(buffer + 1, usbRxLen - 3); + */ + usbProcessRx(usbRxBuf + USB_BUFSIZE + 1 - usbInputBufOffset, len); +#if USB_CFG_HAVE_FLOWCONTROL + if(usbRxLen > 0) /* only mark as available if not inactivated */ + usbRxLen = 0; +#else + usbRxLen = 0; /* mark rx buffer as available */ +#endif + } + if(usbTxLen & 0x10){ /* transmit system idle */ + if(usbMsgLen != USB_NO_MSG){ /* transmit data pending? */ + usbBuildTxBlock(); + } + } + for(i = 20; i > 0; i--){ + uchar usbLineStatus = USBIN & USBMASK; + if(usbLineStatus != 0) /* SE0 has ended */ + goto isNotReset; + } + /* RESET condition, called multiple times during reset */ + usbNewDeviceAddr = 0; + usbDeviceAddr = 0; + usbResetStall(); + DBG1(0xff, 0, 0); +isNotReset: + usbHandleResetHook(i); +} + +/* ------------------------------------------------------------------------- */ + +USB_PUBLIC void usbInit(void) +{ +#if USB_INTR_CFG_SET != 0 + USB_INTR_CFG |= USB_INTR_CFG_SET; +#endif +#if USB_INTR_CFG_CLR != 0 + USB_INTR_CFG &= ~(USB_INTR_CFG_CLR); +#endif + USB_INTR_ENABLE |= (1 << USB_INTR_ENABLE_BIT); + usbResetDataToggling(); +#if USB_CFG_HAVE_INTRIN_ENDPOINT && !USB_CFG_SUPPRESS_INTR_CODE + usbTxLen1 = USBPID_NAK; +#if USB_CFG_HAVE_INTRIN_ENDPOINT3 + usbTxLen3 = USBPID_NAK; +#endif +#endif +} + +/* ------------------------------------------------------------------------- */ diff --git a/firmware/usbdrv/usbdrv.h b/firmware/usbdrv/usbdrv.h new file mode 100644 index 0000000..3a78f30 --- /dev/null +++ b/firmware/usbdrv/usbdrv.h @@ -0,0 +1,735 @@ +/* Name: usbdrv.h + * Project: V-USB, virtual USB port for Atmel's(r) AVR(r) microcontrollers + * Author: Christian Starkjohann + * Creation Date: 2004-12-29 + * Tabsize: 4 + * Copyright: (c) 2005 by OBJECTIVE DEVELOPMENT Software GmbH + * License: GNU GPL v2 (see License.txt), GNU GPL v3 or proprietary (CommercialLicense.txt) + * This Revision: $Id: usbdrv.h 793 2010-07-15 15:58:11Z cs $ + */ + +#ifndef __usbdrv_h_included__ +#define __usbdrv_h_included__ +#include "usbconfig.h" +#include "usbportability.h" + +/* +Hardware Prerequisites: +======================= +USB lines D+ and D- MUST be wired to the same I/O port. We recommend that D+ +triggers the interrupt (best achieved by using INT0 for D+), but it is also +possible to trigger the interrupt from D-. If D- is used, interrupts are also +triggered by SOF packets. D- requires a pull-up of 1.5k to +3.5V (and the +device must be powered at 3.5V) to identify as low-speed USB device. A +pull-down or pull-up of 1M SHOULD be connected from D+ to +3.5V to prevent +interference when no USB master is connected. If you use Zener diodes to limit +the voltage on D+ and D-, you MUST use a pull-down resistor, not a pull-up. +We use D+ as interrupt source and not D- because it does not trigger on +keep-alive and RESET states. If you want to count keep-alive events with +USB_COUNT_SOF, you MUST use D- as an interrupt source. + +As a compile time option, the 1.5k pull-up resistor on D- can be made +switchable to allow the device to disconnect at will. See the definition of +usbDeviceConnect() and usbDeviceDisconnect() further down in this file. + +Please adapt the values in usbconfig.h according to your hardware! + +The device MUST be clocked at exactly 12 MHz, 15 MHz, 16 MHz or 20 MHz +or at 12.8 MHz resp. 16.5 MHz +/- 1%. See usbconfig-prototype.h for details. + + +Limitations: +============ +Robustness with respect to communication errors: +The driver assumes error-free communication. It DOES check for errors in +the PID, but does NOT check bit stuffing errors, SE0 in middle of a byte, +token CRC (5 bit) and data CRC (16 bit). CRC checks can not be performed due +to timing constraints: We must start sending a reply within 7 bit times. +Bit stuffing and misplaced SE0 would have to be checked in real-time, but CPU +performance does not permit that. The driver does not check Data0/Data1 +toggling, but application software can implement the check. + +Input characteristics: +Since no differential receiver circuit is used, electrical interference +robustness may suffer. The driver samples only one of the data lines with +an ordinary I/O pin's input characteristics. However, since this is only a +low speed USB implementation and the specification allows for 8 times the +bit rate over the same hardware, we should be on the safe side. Even the spec +requires detection of asymmetric states at high bit rate for SE0 detection. + +Number of endpoints: +The driver supports the following endpoints: + +- Endpoint 0, the default control endpoint. +- Any number of interrupt- or bulk-out endpoints. The data is sent to + usbFunctionWriteOut() and USB_CFG_IMPLEMENT_FN_WRITEOUT must be defined + to 1 to activate this feature. The endpoint number can be found in the + global variable 'usbRxToken'. +- One default interrupt- or bulk-in endpoint. This endpoint is used for + interrupt- or bulk-in transfers which are not handled by any other endpoint. + You must define USB_CFG_HAVE_INTRIN_ENDPOINT in order to activate this + feature and call usbSetInterrupt() to send interrupt/bulk data. +- One additional interrupt- or bulk-in endpoint. This was endpoint 3 in + previous versions of this driver but can now be configured to any endpoint + number. You must define USB_CFG_HAVE_INTRIN_ENDPOINT3 in order to activate + this feature and call usbSetInterrupt3() to send interrupt/bulk data. The + endpoint number can be set with USB_CFG_EP3_NUMBER. + +Please note that the USB standard forbids bulk endpoints for low speed devices! +Most operating systems allow them anyway, but the AVR will spend 90% of the CPU +time in the USB interrupt polling for bulk data. + +Maximum data payload: +Data payload of control in and out transfers may be up to 254 bytes. In order +to accept payload data of out transfers, you need to implement +'usbFunctionWrite()'. + +USB Suspend Mode supply current: +The USB standard limits power consumption to 500uA when the bus is in suspend +mode. This is not a problem for self-powered devices since they don't need +bus power anyway. Bus-powered devices can achieve this only by putting the +CPU in sleep mode. The driver does not implement suspend handling by itself. +However, the application may implement activity monitoring and wakeup from +sleep. The host sends regular SE0 states on the bus to keep it active. These +SE0 states can be detected by using D- as the interrupt source. Define +USB_COUNT_SOF to 1 and use the global variable usbSofCount to check for bus +activity. + +Operation without an USB master: +The driver behaves neutral without connection to an USB master if D- reads +as 1. To avoid spurious interrupts, we recommend a high impedance (e.g. 1M) +pull-down or pull-up resistor on D+ (interrupt). If Zener diodes are used, +use a pull-down. If D- becomes statically 0, the driver may block in the +interrupt routine. + +Interrupt latency: +The application must ensure that the USB interrupt is not disabled for more +than 25 cycles (this is for 12 MHz, faster clocks allow longer latency). +This implies that all interrupt routines must either have the "ISR_NOBLOCK" +attribute set (see "avr/interrupt.h") or be written in assembler with "sei" +as the first instruction. + +Maximum interrupt duration / CPU cycle consumption: +The driver handles all USB communication during the interrupt service +routine. The routine will not return before an entire USB message is received +and the reply is sent. This may be up to ca. 1200 cycles @ 12 MHz (= 100us) if +the host conforms to the standard. The driver will consume CPU cycles for all +USB messages, even if they address another (low-speed) device on the same bus. + +*/ + +/* ------------------------------------------------------------------------- */ +/* --------------------------- Module Interface ---------------------------- */ +/* ------------------------------------------------------------------------- */ + +#define USBDRV_VERSION 20100715 +/* This define uniquely identifies a driver version. It is a decimal number + * constructed from the driver's release date in the form YYYYMMDD. If the + * driver's behavior or interface changes, you can use this constant to + * distinguish versions. If it is not defined, the driver's release date is + * older than 2006-01-25. + */ + + +#ifndef USB_PUBLIC +#define USB_PUBLIC +#endif +/* USB_PUBLIC is used as declaration attribute for all functions exported by + * the USB driver. The default is no attribute (see above). You may define it + * to static either in usbconfig.h or from the command line if you include + * usbdrv.c instead of linking against it. Including the C module of the driver + * directly in your code saves a couple of bytes in flash memory. + */ + +#ifndef __ASSEMBLER__ +#ifndef uchar +#define uchar unsigned char +#endif +#ifndef schar +#define schar signed char +#endif +/* shortcuts for well defined 8 bit integer types */ + +#if USB_CFG_LONG_TRANSFERS /* if more than 254 bytes transfer size required */ +# define usbMsgLen_t unsigned +#else +# define usbMsgLen_t uchar +#endif +/* usbMsgLen_t is the data type used for transfer lengths. By default, it is + * defined to uchar, allowing a maximum of 254 bytes (255 is reserved for + * USB_NO_MSG below). If the usbconfig.h defines USB_CFG_LONG_TRANSFERS to 1, + * a 16 bit data type is used, allowing up to 16384 bytes (the rest is used + * for flags in the descriptor configuration). + */ +#define USB_NO_MSG ((usbMsgLen_t)-1) /* constant meaning "no message" */ + +struct usbRequest; /* forward declaration */ + +USB_PUBLIC void usbInit(void); +/* This function must be called before interrupts are enabled and the main + * loop is entered. We exepct that the PORT and DDR bits for D+ and D- have + * not been changed from their default status (which is 0). If you have changed + * them, set both back to 0 (configure them as input with no internal pull-up). + */ +USB_PUBLIC void usbPoll(void); +/* This function must be called at regular intervals from the main loop. + * Maximum delay between calls is somewhat less than 50ms (USB timeout for + * accepting a Setup message). Otherwise the device will not be recognized. + * Please note that debug outputs through the UART take ~ 0.5ms per byte + * at 19200 bps. + */ +extern uchar *usbMsgPtr; +/* This variable may be used to pass transmit data to the driver from the + * implementation of usbFunctionWrite(). It is also used internally by the + * driver for standard control requests. + */ +USB_PUBLIC usbMsgLen_t usbFunctionSetup(uchar data[8]); +/* This function is called when the driver receives a SETUP transaction from + * the host which is not answered by the driver itself (in practice: class and + * vendor requests). All control transfers start with a SETUP transaction where + * the host communicates the parameters of the following (optional) data + * transfer. The SETUP data is available in the 'data' parameter which can + * (and should) be casted to 'usbRequest_t *' for a more user-friendly access + * to parameters. + * + * If the SETUP indicates a control-in transfer, you should provide the + * requested data to the driver. There are two ways to transfer this data: + * (1) Set the global pointer 'usbMsgPtr' to the base of the static RAM data + * block and return the length of the data in 'usbFunctionSetup()'. The driver + * will handle the rest. Or (2) return USB_NO_MSG in 'usbFunctionSetup()'. The + * driver will then call 'usbFunctionRead()' when data is needed. See the + * documentation for usbFunctionRead() for details. + * + * If the SETUP indicates a control-out transfer, the only way to receive the + * data from the host is through the 'usbFunctionWrite()' call. If you + * implement this function, you must return USB_NO_MSG in 'usbFunctionSetup()' + * to indicate that 'usbFunctionWrite()' should be used. See the documentation + * of this function for more information. If you just want to ignore the data + * sent by the host, return 0 in 'usbFunctionSetup()'. + * + * Note that calls to the functions usbFunctionRead() and usbFunctionWrite() + * are only done if enabled by the configuration in usbconfig.h. + */ +USB_PUBLIC usbMsgLen_t usbFunctionDescriptor(struct usbRequest *rq); +/* You need to implement this function ONLY if you provide USB descriptors at + * runtime (which is an expert feature). It is very similar to + * usbFunctionSetup() above, but it is called only to request USB descriptor + * data. See the documentation of usbFunctionSetup() above for more info. + */ +#if USB_CFG_HAVE_INTRIN_ENDPOINT +USB_PUBLIC void usbSetInterrupt(uchar *data, uchar len); +/* This function sets the message which will be sent during the next interrupt + * IN transfer. The message is copied to an internal buffer and must not exceed + * a length of 8 bytes. The message may be 0 bytes long just to indicate the + * interrupt status to the host. + * If you need to transfer more bytes, use a control read after the interrupt. + */ +#define usbInterruptIsReady() (usbTxLen1 & 0x10) +/* This macro indicates whether the last interrupt message has already been + * sent. If you set a new interrupt message before the old was sent, the + * message already buffered will be lost. + */ +#if USB_CFG_HAVE_INTRIN_ENDPOINT3 +USB_PUBLIC void usbSetInterrupt3(uchar *data, uchar len); +#define usbInterruptIsReady3() (usbTxLen3 & 0x10) +/* Same as above for endpoint 3 */ +#endif +#endif /* USB_CFG_HAVE_INTRIN_ENDPOINT */ +#if USB_CFG_HID_REPORT_DESCRIPTOR_LENGTH /* simplified interface for backward compatibility */ +#define usbHidReportDescriptor usbDescriptorHidReport +/* should be declared as: PROGMEM char usbHidReportDescriptor[]; */ +/* If you implement an HID device, you need to provide a report descriptor. + * The HID report descriptor syntax is a bit complex. If you understand how + * report descriptors are constructed, we recommend that you use the HID + * Descriptor Tool from usb.org, see http://www.usb.org/developers/hidpage/. + * Otherwise you should probably start with a working example. + */ +#endif /* USB_CFG_HID_REPORT_DESCRIPTOR_LENGTH */ +#if USB_CFG_IMPLEMENT_FN_WRITE +USB_PUBLIC uchar usbFunctionWrite(uchar *data, uchar len); +/* This function is called by the driver to provide a control transfer's + * payload data (control-out). It is called in chunks of up to 8 bytes. The + * total count provided in the current control transfer can be obtained from + * the 'length' property in the setup data. If an error occurred during + * processing, return 0xff (== -1). The driver will answer the entire transfer + * with a STALL token in this case. If you have received the entire payload + * successfully, return 1. If you expect more data, return 0. If you don't + * know whether the host will send more data (you should know, the total is + * provided in the usbFunctionSetup() call!), return 1. + * NOTE: If you return 0xff for STALL, 'usbFunctionWrite()' may still be called + * for the remaining data. You must continue to return 0xff for STALL in these + * calls. + * In order to get usbFunctionWrite() called, define USB_CFG_IMPLEMENT_FN_WRITE + * to 1 in usbconfig.h and return 0xff in usbFunctionSetup().. + */ +#endif /* USB_CFG_IMPLEMENT_FN_WRITE */ +#if USB_CFG_IMPLEMENT_FN_READ +USB_PUBLIC uchar usbFunctionRead(uchar *data, uchar len); +/* This function is called by the driver to ask the application for a control + * transfer's payload data (control-in). It is called in chunks of up to 8 + * bytes each. You should copy the data to the location given by 'data' and + * return the actual number of bytes copied. If you return less than requested, + * the control-in transfer is terminated. If you return 0xff, the driver aborts + * the transfer with a STALL token. + * In order to get usbFunctionRead() called, define USB_CFG_IMPLEMENT_FN_READ + * to 1 in usbconfig.h and return 0xff in usbFunctionSetup().. + */ +#endif /* USB_CFG_IMPLEMENT_FN_READ */ + +extern uchar usbRxToken; /* may be used in usbFunctionWriteOut() below */ +#if USB_CFG_IMPLEMENT_FN_WRITEOUT +USB_PUBLIC void usbFunctionWriteOut(uchar *data, uchar len); +/* This function is called by the driver when data is received on an interrupt- + * or bulk-out endpoint. The endpoint number can be found in the global + * variable usbRxToken. You must define USB_CFG_IMPLEMENT_FN_WRITEOUT to 1 in + * usbconfig.h to get this function called. + */ +#endif /* USB_CFG_IMPLEMENT_FN_WRITEOUT */ +#ifdef USB_CFG_PULLUP_IOPORTNAME +#define usbDeviceConnect() ((USB_PULLUP_DDR |= (1<device, 1=device->host + * t ..... type: 0=standard, 1=class, 2=vendor, 3=reserved + * r ..... recipient: 0=device, 1=interface, 2=endpoint, 3=other + */ + +/* USB setup recipient values */ +#define USBRQ_RCPT_MASK 0x1f +#define USBRQ_RCPT_DEVICE 0 +#define USBRQ_RCPT_INTERFACE 1 +#define USBRQ_RCPT_ENDPOINT 2 + +/* USB request type values */ +#define USBRQ_TYPE_MASK 0x60 +#define USBRQ_TYPE_STANDARD (0<<5) +#define USBRQ_TYPE_CLASS (1<<5) +#define USBRQ_TYPE_VENDOR (2<<5) + +/* USB direction values: */ +#define USBRQ_DIR_MASK 0x80 +#define USBRQ_DIR_HOST_TO_DEVICE (0<<7) +#define USBRQ_DIR_DEVICE_TO_HOST (1<<7) + +/* USB Standard Requests */ +#define USBRQ_GET_STATUS 0 +#define USBRQ_CLEAR_FEATURE 1 +#define USBRQ_SET_FEATURE 3 +#define USBRQ_SET_ADDRESS 5 +#define USBRQ_GET_DESCRIPTOR 6 +#define USBRQ_SET_DESCRIPTOR 7 +#define USBRQ_GET_CONFIGURATION 8 +#define USBRQ_SET_CONFIGURATION 9 +#define USBRQ_GET_INTERFACE 10 +#define USBRQ_SET_INTERFACE 11 +#define USBRQ_SYNCH_FRAME 12 + +/* USB descriptor constants */ +#define USBDESCR_DEVICE 1 +#define USBDESCR_CONFIG 2 +#define USBDESCR_STRING 3 +#define USBDESCR_INTERFACE 4 +#define USBDESCR_ENDPOINT 5 +#define USBDESCR_HID 0x21 +#define USBDESCR_HID_REPORT 0x22 +#define USBDESCR_HID_PHYS 0x23 + +//#define USBATTR_BUSPOWER 0x80 // USB 1.1 does not define this value any more +#define USBATTR_SELFPOWER 0x40 +#define USBATTR_REMOTEWAKE 0x20 + +/* USB HID Requests */ +#define USBRQ_HID_GET_REPORT 0x01 +#define USBRQ_HID_GET_IDLE 0x02 +#define USBRQ_HID_GET_PROTOCOL 0x03 +#define USBRQ_HID_SET_REPORT 0x09 +#define USBRQ_HID_SET_IDLE 0x0a +#define USBRQ_HID_SET_PROTOCOL 0x0b + +/* ------------------------------------------------------------------------- */ + +#endif /* __usbdrv_h_included__ */ diff --git a/firmware/usbdrv/usbdrvasm.S b/firmware/usbdrv/usbdrvasm.S new file mode 100644 index 0000000..45fcf18 --- /dev/null +++ b/firmware/usbdrv/usbdrvasm.S @@ -0,0 +1,393 @@ +/* Name: usbdrvasm.S + * Project: V-USB, virtual USB port for Atmel's(r) AVR(r) microcontrollers + * Author: Christian Starkjohann + * Creation Date: 2007-06-13 + * Tabsize: 4 + * Copyright: (c) 2007 by OBJECTIVE DEVELOPMENT Software GmbH + * License: GNU GPL v2 (see License.txt), GNU GPL v3 or proprietary (CommercialLicense.txt) + * Revision: $Id: usbdrvasm.S 785 2010-05-30 17:57:07Z cs $ + */ + +/* +General Description: +This module is the assembler part of the USB driver. This file contains +general code (preprocessor acrobatics and CRC computation) and then includes +the file appropriate for the given clock rate. +*/ + +#define __SFR_OFFSET 0 /* used by avr-libc's register definitions */ +#include "usbportability.h" +#include "usbdrv.h" /* for common defs */ + +/* register names */ +#define x1 r16 +#define x2 r17 +#define shift r18 +#define cnt r19 +#define x3 r20 +#define x4 r21 +#define x5 r22 +#define bitcnt x5 +#define phase x4 +#define leap x4 + +/* Some assembler dependent definitions and declarations: */ + +#ifdef __IAR_SYSTEMS_ASM__ + extern usbRxBuf, usbDeviceAddr, usbNewDeviceAddr, usbInputBufOffset + extern usbCurrentTok, usbRxLen, usbRxToken, usbTxLen + extern usbTxBuf, usbTxStatus1, usbTxStatus3 +# if USB_COUNT_SOF + extern usbSofCount +# endif + public usbCrc16 + public usbCrc16Append + + COMMON INTVEC +# ifndef USB_INTR_VECTOR + ORG INT0_vect +# else /* USB_INTR_VECTOR */ + ORG USB_INTR_VECTOR +# undef USB_INTR_VECTOR +# endif /* USB_INTR_VECTOR */ +# define USB_INTR_VECTOR usbInterruptHandler + rjmp USB_INTR_VECTOR + RSEG CODE + +#else /* __IAR_SYSTEMS_ASM__ */ + +# ifndef USB_INTR_VECTOR /* default to hardware interrupt INT0 */ +# ifdef INT0_vect +# define USB_INTR_VECTOR INT0_vect // this is the "new" define for the vector +# else +# define USB_INTR_VECTOR SIG_INTERRUPT0 // this is the "old" vector +# endif +# endif + .text + .global USB_INTR_VECTOR + .type USB_INTR_VECTOR, @function + .global usbCrc16 + .global usbCrc16Append +#endif /* __IAR_SYSTEMS_ASM__ */ + + +#if USB_INTR_PENDING < 0x40 /* This is an I/O address, use in and out */ +# define USB_LOAD_PENDING(reg) in reg, USB_INTR_PENDING +# define USB_STORE_PENDING(reg) out USB_INTR_PENDING, reg +#else /* It's a memory address, use lds and sts */ +# define USB_LOAD_PENDING(reg) lds reg, USB_INTR_PENDING +# define USB_STORE_PENDING(reg) sts USB_INTR_PENDING, reg +#endif + +#define usbTxLen1 usbTxStatus1 +#define usbTxBuf1 (usbTxStatus1 + 1) +#define usbTxLen3 usbTxStatus3 +#define usbTxBuf3 (usbTxStatus3 + 1) + + +;---------------------------------------------------------------------------- +; Utility functions +;---------------------------------------------------------------------------- + +#ifdef __IAR_SYSTEMS_ASM__ +/* Register assignments for usbCrc16 on IAR cc */ +/* Calling conventions on IAR: + * First parameter passed in r16/r17, second in r18/r19 and so on. + * Callee must preserve r4-r15, r24-r29 (r28/r29 is frame pointer) + * Result is passed in r16/r17 + * In case of the "tiny" memory model, pointers are only 8 bit with no + * padding. We therefore pass argument 1 as "16 bit unsigned". + */ +RTMODEL "__rt_version", "3" +/* The line above will generate an error if cc calling conventions change. + * The value "3" above is valid for IAR 4.10B/W32 + */ +# define argLen r18 /* argument 2 */ +# define argPtrL r16 /* argument 1 */ +# define argPtrH r17 /* argument 1 */ + +# define resCrcL r16 /* result */ +# define resCrcH r17 /* result */ + +# define ptrL ZL +# define ptrH ZH +# define ptr Z +# define byte r22 +# define bitCnt r19 +# define polyL r20 +# define polyH r21 +# define scratch r23 + +#else /* __IAR_SYSTEMS_ASM__ */ +/* Register assignments for usbCrc16 on gcc */ +/* Calling conventions on gcc: + * First parameter passed in r24/r25, second in r22/23 and so on. + * Callee must preserve r1-r17, r28/r29 + * Result is passed in r24/r25 + */ +# define argLen r22 /* argument 2 */ +# define argPtrL r24 /* argument 1 */ +# define argPtrH r25 /* argument 1 */ + +# define resCrcL r24 /* result */ +# define resCrcH r25 /* result */ + +# define ptrL XL +# define ptrH XH +# define ptr x +# define byte r18 +# define bitCnt r19 +# define polyL r20 +# define polyH r21 +# define scratch r23 + +#endif + +#if USB_USE_FAST_CRC + +; This implementation is faster, but has bigger code size +; Thanks to Slawomir Fras (BoskiDialer) for this code! +; It implements the following C pseudo-code: +; unsigned table(unsigned char x) +; { +; unsigned value; +; +; value = (unsigned)x << 6; +; value ^= (unsigned)x << 7; +; if(parity(x)) +; value ^= 0xc001; +; return value; +; } +; unsigned usbCrc16(unsigned char *argPtr, unsigned char argLen) +; { +; unsigned crc = 0xffff; +; +; while(argLen--) +; crc = table(lo8(crc) ^ *argPtr++) ^ hi8(crc); +; return ~crc; +; } + +; extern unsigned usbCrc16(unsigned char *argPtr, unsigned char argLen); +; argPtr r24+25 / r16+r17 +; argLen r22 / r18 +; temp variables: +; byte r18 / r22 +; scratch r23 +; resCrc r24+r25 / r16+r17 +; ptr X / Z +usbCrc16: + mov ptrL, argPtrL + mov ptrH, argPtrH + ldi resCrcL, 0xFF + ldi resCrcH, 0xFF + rjmp usbCrc16LoopTest +usbCrc16ByteLoop: + ld byte, ptr+ + eor resCrcL, byte ; resCrcL is now 'x' in table() + mov byte, resCrcL ; compute parity of 'x' + swap byte + eor byte, resCrcL + mov scratch, byte + lsr byte + lsr byte + eor byte, scratch + inc byte + lsr byte + andi byte, 1 ; byte is now parity(x) + mov scratch, resCrcL + mov resCrcL, resCrcH + eor resCrcL, byte ; low byte of if(parity(x)) value ^= 0xc001; + neg byte + andi byte, 0xc0 + mov resCrcH, byte ; high byte of if(parity(x)) value ^= 0xc001; + clr byte + lsr scratch + ror byte + eor resCrcH, scratch + eor resCrcL, byte + lsr scratch + ror byte + eor resCrcH, scratch + eor resCrcL, byte +usbCrc16LoopTest: + subi argLen, 1 + brsh usbCrc16ByteLoop + com resCrcL + com resCrcH + ret + +#else /* USB_USE_FAST_CRC */ + +; This implementation is slower, but has less code size +; +; extern unsigned usbCrc16(unsigned char *argPtr, unsigned char argLen); +; argPtr r24+25 / r16+r17 +; argLen r22 / r18 +; temp variables: +; byte r18 / r22 +; bitCnt r19 +; poly r20+r21 +; scratch r23 +; resCrc r24+r25 / r16+r17 +; ptr X / Z +usbCrc16: + mov ptrL, argPtrL + mov ptrH, argPtrH + ldi resCrcL, 0 + ldi resCrcH, 0 + ldi polyL, lo8(0xa001) + ldi polyH, hi8(0xa001) + com argLen ; argLen = -argLen - 1: modified loop to ensure that carry is set + ldi bitCnt, 0 ; loop counter with starnd condition = end condition + rjmp usbCrcLoopEntry +usbCrcByteLoop: + ld byte, ptr+ + eor resCrcL, byte +usbCrcBitLoop: + ror resCrcH ; carry is always set here (see brcs jumps to here) + ror resCrcL + brcs usbCrcNoXor + eor resCrcL, polyL + eor resCrcH, polyH +usbCrcNoXor: + subi bitCnt, 224 ; (8 * 224) % 256 = 0; this loop iterates 8 times + brcs usbCrcBitLoop +usbCrcLoopEntry: + subi argLen, -1 + brcs usbCrcByteLoop +usbCrcReady: + ret +; Thanks to Reimar Doeffinger for optimizing this CRC routine! + +#endif /* USB_USE_FAST_CRC */ + +; extern unsigned usbCrc16Append(unsigned char *data, unsigned char len); +usbCrc16Append: + rcall usbCrc16 + st ptr+, resCrcL + st ptr+, resCrcH + ret + +#undef argLen +#undef argPtrL +#undef argPtrH +#undef resCrcL +#undef resCrcH +#undef ptrL +#undef ptrH +#undef ptr +#undef byte +#undef bitCnt +#undef polyL +#undef polyH +#undef scratch + + +#if USB_CFG_HAVE_MEASURE_FRAME_LENGTH +#ifdef __IAR_SYSTEMS_ASM__ +/* Register assignments for usbMeasureFrameLength on IAR cc */ +/* Calling conventions on IAR: + * First parameter passed in r16/r17, second in r18/r19 and so on. + * Callee must preserve r4-r15, r24-r29 (r28/r29 is frame pointer) + * Result is passed in r16/r17 + * In case of the "tiny" memory model, pointers are only 8 bit with no + * padding. We therefore pass argument 1 as "16 bit unsigned". + */ +# define resL r16 +# define resH r17 +# define cnt16L r30 +# define cnt16H r31 +# define cntH r18 + +#else /* __IAR_SYSTEMS_ASM__ */ +/* Register assignments for usbMeasureFrameLength on gcc */ +/* Calling conventions on gcc: + * First parameter passed in r24/r25, second in r22/23 and so on. + * Callee must preserve r1-r17, r28/r29 + * Result is passed in r24/r25 + */ +# define resL r24 +# define resH r25 +# define cnt16L r24 +# define cnt16H r25 +# define cntH r26 +#endif +# define cnt16 cnt16L + +; extern unsigned usbMeasurePacketLength(void); +; returns time between two idle strobes in multiples of 7 CPU clocks +.global usbMeasureFrameLength +usbMeasureFrameLength: + ldi cntH, 6 ; wait ~ 10 ms for D- == 0 + clr cnt16L + clr cnt16H +usbMFTime16: + dec cntH + breq usbMFTimeout +usbMFWaitStrobe: ; first wait for D- == 0 (idle strobe) + sbiw cnt16, 1 ;[0] [6] + breq usbMFTime16 ;[2] + sbic USBIN, USBMINUS ;[3] + rjmp usbMFWaitStrobe ;[4] +usbMFWaitIdle: ; then wait until idle again + sbis USBIN, USBMINUS ;1 wait for D- == 1 + rjmp usbMFWaitIdle ;2 + ldi cnt16L, 1 ;1 represents cycles so far + clr cnt16H ;1 +usbMFWaitLoop: + in cntH, USBIN ;[0] [7] + adiw cnt16, 1 ;[1] + breq usbMFTimeout ;[3] + andi cntH, USBMASK ;[4] + brne usbMFWaitLoop ;[5] +usbMFTimeout: +#if resL != cnt16L + mov resL, cnt16L + mov resH, cnt16H +#endif + ret + +#undef resL +#undef resH +#undef cnt16 +#undef cnt16L +#undef cnt16H +#undef cntH + +#endif /* USB_CFG_HAVE_MEASURE_FRAME_LENGTH */ + +;---------------------------------------------------------------------------- +; Now include the clock rate specific code +;---------------------------------------------------------------------------- + +#ifndef USB_CFG_CLOCK_KHZ +# ifdef F_CPU +# define USB_CFG_CLOCK_KHZ (F_CPU/1000) +# else +# error "USB_CFG_CLOCK_KHZ not defined in usbconfig.h and no F_CPU set!" +# endif +#endif + +#if USB_CFG_CHECK_CRC /* separate dispatcher for CRC type modules */ +# if USB_CFG_CLOCK_KHZ == 18000 +# include "usbdrvasm18-crc.inc" +# else +# error "USB_CFG_CLOCK_KHZ is not one of the supported crc-rates!" +# endif +#else /* USB_CFG_CHECK_CRC */ +# if USB_CFG_CLOCK_KHZ == 12000 +# include "usbdrvasm12.inc" +# elif USB_CFG_CLOCK_KHZ == 12800 +# include "usbdrvasm128.inc" +# elif USB_CFG_CLOCK_KHZ == 15000 +# include "usbdrvasm15.inc" +# elif USB_CFG_CLOCK_KHZ == 16000 +# include "usbdrvasm16.inc" +# elif USB_CFG_CLOCK_KHZ == 16500 +# include "usbdrvasm165.inc" +# elif USB_CFG_CLOCK_KHZ == 20000 +# include "usbdrvasm20.inc" +# else +# error "USB_CFG_CLOCK_KHZ is not one of the supported non-crc-rates!" +# endif +#endif /* USB_CFG_CHECK_CRC */ diff --git a/firmware/usbdrv/usbdrvasm.asm b/firmware/usbdrv/usbdrvasm.asm new file mode 100644 index 0000000..9cc4e4d --- /dev/null +++ b/firmware/usbdrv/usbdrvasm.asm @@ -0,0 +1,21 @@ +/* Name: usbdrvasm.asm + * Project: V-USB, virtual USB port for Atmel's(r) AVR(r) microcontrollers + * Author: Christian Starkjohann + * Creation Date: 2006-03-01 + * Tabsize: 4 + * Copyright: (c) 2006 by OBJECTIVE DEVELOPMENT Software GmbH + * License: GNU GPL v2 (see License.txt), GNU GPL v3 or proprietary (CommercialLicense.txt) + * This Revision: $Id$ + */ + +/* +General Description: +The IAR compiler/assembler system prefers assembler files with file extension +".asm". We simply provide this file as an alias for usbdrvasm.S. + +Thanks to Oleg Semyonov for his help with the IAR tools port! +*/ + +#include "usbdrvasm.S" + +end diff --git a/firmware/usbdrv/usbdrvasm12.inc b/firmware/usbdrv/usbdrvasm12.inc new file mode 100644 index 0000000..c116758 --- /dev/null +++ b/firmware/usbdrv/usbdrvasm12.inc @@ -0,0 +1,393 @@ +/* Name: usbdrvasm12.inc + * Project: V-USB, virtual USB port for Atmel's(r) AVR(r) microcontrollers + * Author: Christian Starkjohann + * Creation Date: 2004-12-29 + * Tabsize: 4 + * Copyright: (c) 2007 by OBJECTIVE DEVELOPMENT Software GmbH + * License: GNU GPL v2 (see License.txt), GNU GPL v3 or proprietary (CommercialLicense.txt) + * This Revision: $Id: usbdrvasm12.inc 740 2009-04-13 18:23:31Z cs $ + */ + +/* Do not link this file! Link usbdrvasm.S instead, which includes the + * appropriate implementation! + */ + +/* +General Description: +This file is the 12 MHz version of the asssembler part of the USB driver. It +requires a 12 MHz crystal (not a ceramic resonator and not a calibrated RC +oscillator). + +See usbdrv.h for a description of the entire driver. + +Since almost all of this code is timing critical, don't change unless you +really know what you are doing! Many parts require not only a maximum number +of CPU cycles, but even an exact number of cycles! + + +Timing constraints according to spec (in bit times): +timing subject min max CPUcycles +--------------------------------------------------------------------------- +EOP of OUT/SETUP to sync pattern of DATA0 (both rx) 2 16 16-128 +EOP of IN to sync pattern of DATA0 (rx, then tx) 2 7.5 16-60 +DATAx (rx) to ACK/NAK/STALL (tx) 2 7.5 16-60 +*/ + +;Software-receiver engine. Strict timing! Don't change unless you can preserve timing! +;interrupt response time: 4 cycles + insn running = 7 max if interrupts always enabled +;max allowable interrupt latency: 34 cycles -> max 25 cycles interrupt disable +;max stack usage: [ret(2), YL, SREG, YH, shift, x1, x2, x3, cnt, x4] = 11 bytes +;Numbers in brackets are maximum cycles since SOF. +USB_INTR_VECTOR: +;order of registers pushed: YL, SREG [sofError], YH, shift, x1, x2, x3, cnt + push YL ;2 [35] push only what is necessary to sync with edge ASAP + in YL, SREG ;1 [37] + push YL ;2 [39] +;---------------------------------------------------------------------------- +; Synchronize with sync pattern: +;---------------------------------------------------------------------------- +;sync byte (D-) pattern LSb to MSb: 01010100 [1 = idle = J, 0 = K] +;sync up with J to K edge during sync pattern -- use fastest possible loops +;The first part waits at most 1 bit long since we must be in sync pattern. +;YL is guarenteed to be < 0x80 because I flag is clear. When we jump to +;waitForJ, ensure that this prerequisite is met. +waitForJ: + inc YL + sbis USBIN, USBMINUS + brne waitForJ ; just make sure we have ANY timeout +waitForK: +;The following code results in a sampling window of 1/4 bit which meets the spec. + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK +#if USB_COUNT_SOF + lds YL, usbSofCount + inc YL + sts usbSofCount, YL +#endif /* USB_COUNT_SOF */ +#ifdef USB_SOF_HOOK + USB_SOF_HOOK +#endif + rjmp sofError +foundK: +;{3, 5} after falling D- edge, average delay: 4 cycles [we want 4 for center sampling] +;we have 1 bit time for setup purposes, then sample again. Numbers in brackets +;are cycles from center of first sync (double K) bit after the instruction + push YH ;2 [2] + lds YL, usbInputBufOffset;2 [4] + clr YH ;1 [5] + subi YL, lo8(-(usbRxBuf));1 [6] + sbci YH, hi8(-(usbRxBuf));1 [7] + + sbis USBIN, USBMINUS ;1 [8] we want two bits K [sample 1 cycle too early] + rjmp haveTwoBitsK ;2 [10] + pop YH ;2 [11] undo the push from before + rjmp waitForK ;2 [13] this was not the end of sync, retry +haveTwoBitsK: +;---------------------------------------------------------------------------- +; push more registers and initialize values while we sample the first bits: +;---------------------------------------------------------------------------- + push shift ;2 [16] + push x1 ;2 [12] + push x2 ;2 [14] + + in x1, USBIN ;1 [17] <-- sample bit 0 + ldi shift, 0xff ;1 [18] + bst x1, USBMINUS ;1 [19] + bld shift, 0 ;1 [20] + push x3 ;2 [22] + push cnt ;2 [24] + + in x2, USBIN ;1 [25] <-- sample bit 1 + ser x3 ;1 [26] [inserted init instruction] + eor x1, x2 ;1 [27] + bst x1, USBMINUS ;1 [28] + bld shift, 1 ;1 [29] + ldi cnt, USB_BUFSIZE;1 [30] [inserted init instruction] + rjmp rxbit2 ;2 [32] + +;---------------------------------------------------------------------------- +; Receiver loop (numbers in brackets are cycles within byte after instr) +;---------------------------------------------------------------------------- + +unstuff0: ;1 (branch taken) + andi x3, ~0x01 ;1 [15] + mov x1, x2 ;1 [16] x2 contains last sampled (stuffed) bit + in x2, USBIN ;1 [17] <-- sample bit 1 again + ori shift, 0x01 ;1 [18] + rjmp didUnstuff0 ;2 [20] + +unstuff1: ;1 (branch taken) + mov x2, x1 ;1 [21] x1 contains last sampled (stuffed) bit + andi x3, ~0x02 ;1 [22] + ori shift, 0x02 ;1 [23] + nop ;1 [24] + in x1, USBIN ;1 [25] <-- sample bit 2 again + rjmp didUnstuff1 ;2 [27] + +unstuff2: ;1 (branch taken) + andi x3, ~0x04 ;1 [29] + ori shift, 0x04 ;1 [30] + mov x1, x2 ;1 [31] x2 contains last sampled (stuffed) bit + nop ;1 [32] + in x2, USBIN ;1 [33] <-- sample bit 3 + rjmp didUnstuff2 ;2 [35] + +unstuff3: ;1 (branch taken) + in x2, USBIN ;1 [34] <-- sample stuffed bit 3 [one cycle too late] + andi x3, ~0x08 ;1 [35] + ori shift, 0x08 ;1 [36] + rjmp didUnstuff3 ;2 [38] + +unstuff4: ;1 (branch taken) + andi x3, ~0x10 ;1 [40] + in x1, USBIN ;1 [41] <-- sample stuffed bit 4 + ori shift, 0x10 ;1 [42] + rjmp didUnstuff4 ;2 [44] + +unstuff5: ;1 (branch taken) + andi x3, ~0x20 ;1 [48] + in x2, USBIN ;1 [49] <-- sample stuffed bit 5 + ori shift, 0x20 ;1 [50] + rjmp didUnstuff5 ;2 [52] + +unstuff6: ;1 (branch taken) + andi x3, ~0x40 ;1 [56] + in x1, USBIN ;1 [57] <-- sample stuffed bit 6 + ori shift, 0x40 ;1 [58] + rjmp didUnstuff6 ;2 [60] + +; extra jobs done during bit interval: +; bit 0: store, clear [SE0 is unreliable here due to bit dribbling in hubs] +; bit 1: se0 check +; bit 2: overflow check +; bit 3: recovery from delay [bit 0 tasks took too long] +; bit 4: none +; bit 5: none +; bit 6: none +; bit 7: jump, eor +rxLoop: + eor x3, shift ;1 [0] reconstruct: x3 is 0 at bit locations we changed, 1 at others + in x1, USBIN ;1 [1] <-- sample bit 0 + st y+, x3 ;2 [3] store data + ser x3 ;1 [4] + nop ;1 [5] + eor x2, x1 ;1 [6] + bst x2, USBMINUS;1 [7] + bld shift, 0 ;1 [8] + in x2, USBIN ;1 [9] <-- sample bit 1 (or possibly bit 0 stuffed) + andi x2, USBMASK ;1 [10] + breq se0 ;1 [11] SE0 check for bit 1 + andi shift, 0xf9 ;1 [12] +didUnstuff0: + breq unstuff0 ;1 [13] + eor x1, x2 ;1 [14] + bst x1, USBMINUS;1 [15] + bld shift, 1 ;1 [16] +rxbit2: + in x1, USBIN ;1 [17] <-- sample bit 2 (or possibly bit 1 stuffed) + andi shift, 0xf3 ;1 [18] + breq unstuff1 ;1 [19] do remaining work for bit 1 +didUnstuff1: + subi cnt, 1 ;1 [20] + brcs overflow ;1 [21] loop control + eor x2, x1 ;1 [22] + bst x2, USBMINUS;1 [23] + bld shift, 2 ;1 [24] + in x2, USBIN ;1 [25] <-- sample bit 3 (or possibly bit 2 stuffed) + andi shift, 0xe7 ;1 [26] + breq unstuff2 ;1 [27] +didUnstuff2: + eor x1, x2 ;1 [28] + bst x1, USBMINUS;1 [29] + bld shift, 3 ;1 [30] +didUnstuff3: + andi shift, 0xcf ;1 [31] + breq unstuff3 ;1 [32] + in x1, USBIN ;1 [33] <-- sample bit 4 + eor x2, x1 ;1 [34] + bst x2, USBMINUS;1 [35] + bld shift, 4 ;1 [36] +didUnstuff4: + andi shift, 0x9f ;1 [37] + breq unstuff4 ;1 [38] + nop2 ;2 [40] + in x2, USBIN ;1 [41] <-- sample bit 5 + eor x1, x2 ;1 [42] + bst x1, USBMINUS;1 [43] + bld shift, 5 ;1 [44] +didUnstuff5: + andi shift, 0x3f ;1 [45] + breq unstuff5 ;1 [46] + nop2 ;2 [48] + in x1, USBIN ;1 [49] <-- sample bit 6 + eor x2, x1 ;1 [50] + bst x2, USBMINUS;1 [51] + bld shift, 6 ;1 [52] +didUnstuff6: + cpi shift, 0x02 ;1 [53] + brlo unstuff6 ;1 [54] + nop2 ;2 [56] + in x2, USBIN ;1 [57] <-- sample bit 7 + eor x1, x2 ;1 [58] + bst x1, USBMINUS;1 [59] + bld shift, 7 ;1 [60] +didUnstuff7: + cpi shift, 0x04 ;1 [61] + brsh rxLoop ;2 [63] loop control +unstuff7: + andi x3, ~0x80 ;1 [63] + ori shift, 0x80 ;1 [64] + in x2, USBIN ;1 [65] <-- sample stuffed bit 7 + nop ;1 [66] + rjmp didUnstuff7 ;2 [68] + +macro POP_STANDARD ; 12 cycles + pop cnt + pop x3 + pop x2 + pop x1 + pop shift + pop YH + endm +macro POP_RETI ; 5 cycles + pop YL + out SREG, YL + pop YL + endm + +#include "asmcommon.inc" + +;---------------------------------------------------------------------------- +; Transmitting data +;---------------------------------------------------------------------------- + +txByteLoop: +txBitloop: +stuffN1Delay: ; [03] + ror shift ;[-5] [11] [59] + brcc doExorN1 ;[-4] [60] + subi x4, 1 ;[-3] + brne commonN1 ;[-2] + lsl shift ;[-1] compensate ror after rjmp stuffDelay + nop ;[00] stuffing consists of just waiting 8 cycles + rjmp stuffN1Delay ;[01] after ror, C bit is reliably clear + +sendNakAndReti: ;0 [-19] 19 cycles until SOP + ldi x3, USBPID_NAK ;1 [-18] + rjmp usbSendX3 ;2 [-16] +sendAckAndReti: ;0 [-19] 19 cycles until SOP + ldi x3, USBPID_ACK ;1 [-18] + rjmp usbSendX3 ;2 [-16] +sendCntAndReti: ;0 [-17] 17 cycles until SOP + mov x3, cnt ;1 [-16] +usbSendX3: ;0 [-16] + ldi YL, 20 ;1 [-15] 'x3' is R20 + ldi YH, 0 ;1 [-14] + ldi cnt, 2 ;1 [-13] +; rjmp usbSendAndReti fallthrough + +; USB spec says: +; idle = J +; J = (D+ = 0), (D- = 1) or USBOUT = 0x01 +; K = (D+ = 1), (D- = 0) or USBOUT = 0x02 +; Spec allows 7.5 bit times from EOP to SOP for replies (= 60 cycles) + +;usbSend: +;pointer to data in 'Y' +;number of bytes in 'cnt' -- including sync byte +;uses: x1...x2, x4, shift, cnt, Y [x1 = mirror USBOUT, x2 = USBMASK, x4 = bitstuff cnt] +;Numbers in brackets are time since first bit of sync pattern is sent (start of instruction) +usbSendAndReti: + in x2, USBDDR ;[-12] 12 cycles until SOP + ori x2, USBMASK ;[-11] + sbi USBOUT, USBMINUS ;[-10] prepare idle state; D+ and D- must have been 0 (no pullups) + out USBDDR, x2 ;[-8] <--- acquire bus + in x1, USBOUT ;[-7] port mirror for tx loop + ldi shift, 0x40 ;[-6] sync byte is first byte sent (we enter loop after ror) + ldi x2, USBMASK ;[-5] + push x4 ;[-4] +doExorN1: + eor x1, x2 ;[-2] [06] [62] + ldi x4, 6 ;[-1] [07] [63] +commonN1: +stuffN2Delay: + out USBOUT, x1 ;[00] [08] [64] <--- set bit + ror shift ;[01] + brcc doExorN2 ;[02] + subi x4, 1 ;[03] + brne commonN2 ;[04] + lsl shift ;[05] compensate ror after rjmp stuffDelay + rjmp stuffN2Delay ;[06] after ror, C bit is reliably clear +doExorN2: + eor x1, x2 ;[04] [12] + ldi x4, 6 ;[05] [13] +commonN2: + nop ;[06] [14] + subi cnt, 171 ;[07] [15] trick: (3 * 171) & 0xff = 1 + out USBOUT, x1 ;[08] [16] <--- set bit + brcs txBitloop ;[09] [25] [41] + +stuff6Delay: + ror shift ;[42] [50] + brcc doExor6 ;[43] + subi x4, 1 ;[44] + brne common6 ;[45] + lsl shift ;[46] compensate ror after rjmp stuffDelay + nop ;[47] stuffing consists of just waiting 8 cycles + rjmp stuff6Delay ;[48] after ror, C bit is reliably clear +doExor6: + eor x1, x2 ;[45] [53] + ldi x4, 6 ;[46] +common6: +stuff7Delay: + ror shift ;[47] [55] + out USBOUT, x1 ;[48] <--- set bit + brcc doExor7 ;[49] + subi x4, 1 ;[50] + brne common7 ;[51] + lsl shift ;[52] compensate ror after rjmp stuffDelay + rjmp stuff7Delay ;[53] after ror, C bit is reliably clear +doExor7: + eor x1, x2 ;[51] [59] + ldi x4, 6 ;[52] +common7: + ld shift, y+ ;[53] + tst cnt ;[55] + out USBOUT, x1 ;[56] <--- set bit + brne txByteLoop ;[57] + +;make SE0: + cbr x1, USBMASK ;[58] prepare SE0 [spec says EOP may be 15 to 18 cycles] + lds x2, usbNewDeviceAddr;[59] + lsl x2 ;[61] we compare with left shifted address + subi YL, 2 + 20 ;[62] Only assign address on data packets, not ACK/NAK in x3 + sbci YH, 0 ;[63] + out USBOUT, x1 ;[00] <-- out SE0 -- from now 2 bits = 16 cycles until bus idle +;2006-03-06: moved transfer of new address to usbDeviceAddr from C-Code to asm: +;set address only after data packet was sent, not after handshake + breq skipAddrAssign ;[01] + sts usbDeviceAddr, x2 ; if not skipped: SE0 is one cycle longer +skipAddrAssign: +;end of usbDeviceAddress transfer + ldi x2, 1< 12.5625 MHz +max frequency: 69.286 cycles for 8 bit -> 12.99 MHz +nominal frequency: 12.77 MHz ( = sqrt(min * max)) + +sampling positions: (next even number in range [+/- 0.5]) +cycle index range: 0 ... 66 +bits: +.5, 8.875, 17.25, 25.625, 34, 42.375, 50.75, 59.125 +[0/1], [9], [17], [25/+26], [34], [+42/43], [51], [59] + +bit number: 0 1 2 3 4 5 6 7 +spare cycles 1 2 1 2 1 1 1 0 + +operations to perform: duration cycle + ---------------- + eor fix, shift 1 -> 00 + andi phase, USBMASK 1 -> 08 + breq se0 1 -> 16 (moved to 11) + st y+, data 2 -> 24, 25 + mov data, fix 1 -> 33 + ser data 1 -> 41 + subi cnt, 1 1 -> 49 + brcs overflow 1 -> 50 + +layout of samples and operations: +[##] = sample bit +<##> = sample phase +*##* = operation + +0: *00* [01] 02 03 04 <05> 06 07 +1: *08* [09] 10 11 12 <13> 14 15 *16* +2: [17] 18 19 20 <21> 22 23 +3: *24* *25* [26] 27 28 29 <30> 31 32 +4: *33* [34] 35 36 37 <38> 39 40 +5: *41* [42] 43 44 45 <46> 47 48 +6: *49* *50* [51] 52 53 54 <55> 56 57 58 +7: [59] 60 61 62 <63> 64 65 66 +*****************************************************************************/ + +/* we prefer positive expressions (do if condition) instead of negative + * (skip if condition), therefore use defines for skip instructions: + */ +#define ifioclr sbis +#define ifioset sbic +#define ifrclr sbrs +#define ifrset sbrc + +/* The registers "fix" and "data" swap their meaning during the loop. Use + * defines to keep their name constant. + */ +#define fix x2 +#define data x1 +#undef phase /* phase has a default definition to x4 */ +#define phase x3 + + +USB_INTR_VECTOR: +;order of registers pushed: YL, SREG [sofError], YH, shift, x1, x2, x3, cnt, r0 + push YL ;2 push only what is necessary to sync with edge ASAP + in YL, SREG ;1 + push YL ;2 +;---------------------------------------------------------------------------- +; Synchronize with sync pattern: +;---------------------------------------------------------------------------- +;sync byte (D-) pattern LSb to MSb: 01010100 [1 = idle = J, 0 = K] +;sync up with J to K edge during sync pattern -- use fastest possible loops +;The first part waits at most 1 bit long since we must be in sync pattern. +;YL is guarenteed to be < 0x80 because I flag is clear. When we jump to +;waitForJ, ensure that this prerequisite is met. +waitForJ: + inc YL + sbis USBIN, USBMINUS + brne waitForJ ; just make sure we have ANY timeout +waitForK: +;The following code results in a sampling window of 1/4 bit which meets the spec. + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS ;[0] + rjmp foundK ;[1] +#if USB_COUNT_SOF + lds YL, usbSofCount + inc YL + sts usbSofCount, YL +#endif /* USB_COUNT_SOF */ +#ifdef USB_SOF_HOOK + USB_SOF_HOOK +#endif + rjmp sofError + +foundK: +;{3, 5} after falling D- edge, average delay: 4 cycles [we want 4 for center sampling] +;we have 1 bit time for setup purposes, then sample again. Numbers in brackets +;are cycles from center of first sync (double K) bit after the instruction + push YH ;[2] + lds YL, usbInputBufOffset;[4] + clr YH ;[6] + subi YL, lo8(-(usbRxBuf));[7] + sbci YH, hi8(-(usbRxBuf));[8] + + sbis USBIN, USBMINUS ;[9] we want two bits K [we want to sample at 8 + 4 - 1.5 = 10.5] + rjmp haveTwoBitsK ;[10] + pop YH ;[11] undo the push from before + rjmp waitForK ;[13] this was not the end of sync, retry +haveTwoBitsK: +;---------------------------------------------------------------------------- +; push more registers and initialize values while we sample the first bits: +;---------------------------------------------------------------------------- +#define fix x2 +#define data x1 + + push shift ;[12] + push x1 ;[14] + push x2 ;[16] + ldi shift, 0x80 ;[18] prevent bit-unstuffing but init low bits to 0 + ifioset USBIN, USBMINUS ;[19] [01] <--- bit 0 [10.5 + 8 = 18.5] + ori shift, 1<<0 ;[02] + push x3 ;[03] + push cnt ;[05] + push r0 ;[07] + ifioset USBIN, USBMINUS ;[09] <--- bit 1 + ori shift, 1<<1 ;[10] + ser fix ;[11] + ldi cnt, USB_BUFSIZE ;[12] + mov data, shift ;[13] + lsl shift ;[14] + nop2 ;[15] + ifioset USBIN, USBMINUS ;[17] <--- bit 2 + ori data, 3<<2 ;[18] store in bit 2 AND bit 3 + eor shift, data ;[19] do nrzi decoding + andi data, 1<<3 ;[20] + in phase, USBIN ;[21] <- phase + brne jumpToEntryAfterSet ;[22] if USBMINS at bit 3 was 1 + nop ;[23] + rjmp entryAfterClr ;[24] +jumpToEntryAfterSet: + rjmp entryAfterSet ;[24] + +;---------------------------------------------------------------------------- +; Receiver loop (numbers in brackets are cycles within byte after instr) +;---------------------------------------------------------------------------- +#undef fix +#define fix x1 +#undef data +#define data x2 + +bit7IsSet: + ifrclr phase, USBMINUS ;[62] check phase only if D- changed + lpm ;[63] + in phase, USBIN ;[64] <- phase (one cycle too late) + ori shift, 1 << 7 ;[65] + nop ;[66] +;;;;rjmp bit0AfterSet ; -> [00] == [67] moved block up to save jump +bit0AfterSet: + eor fix, shift ;[00] +#undef fix +#define fix x2 +#undef data +#define data x1 /* we now have result in data, fix is reset to 0xff */ + ifioclr USBIN, USBMINUS ;[01] <--- sample 0 + rjmp bit0IsClr ;[02] + andi shift, ~(7 << 0) ;[03] + breq unstuff0s ;[04] + in phase, USBIN ;[05] <- phase + rjmp bit1AfterSet ;[06] +unstuff0s: + in phase, USBIN ;[06] <- phase (one cycle too late) + andi fix, ~(1 << 0) ;[07] + ifioclr USBIN, USBMINUS ;[00] + ifioset USBIN, USBPLUS ;[01] + rjmp bit0IsClr ;[02] executed if first expr false or second true +se0AndStore: ; executed only if both bits 0 + st y+, x1 ;[15/17] cycles after start of byte + rjmp se0 ;[17/19] + +bit0IsClr: + ifrset phase, USBMINUS ;[04] check phase only if D- changed + lpm ;[05] + in phase, USBIN ;[06] <- phase (one cycle too late) + ori shift, 1 << 0 ;[07] +bit1AfterClr: + andi phase, USBMASK ;[08] + ifioset USBIN, USBMINUS ;[09] <--- sample 1 + rjmp bit1IsSet ;[10] + breq se0AndStore ;[11] if D- was 0 in bits 0 AND 1 and D+ was 0 in between, we have SE0 + andi shift, ~(7 << 1) ;[12] + in phase, USBIN ;[13] <- phase + breq unstuff1c ;[14] + rjmp bit2AfterClr ;[15] +unstuff1c: + andi fix, ~(1 << 1) ;[16] + nop2 ;[08] + nop2 ;[10] +bit1IsSet: + ifrclr phase, USBMINUS ;[12] check phase only if D- changed + lpm ;[13] + in phase, USBIN ;[14] <- phase (one cycle too late) + ori shift, 1 << 1 ;[15] + nop ;[16] +bit2AfterSet: + ifioclr USBIN, USBMINUS ;[17] <--- sample 2 + rjmp bit2IsClr ;[18] + andi shift, ~(7 << 2) ;[19] + breq unstuff2s ;[20] + in phase, USBIN ;[21] <- phase + rjmp bit3AfterSet ;[22] +unstuff2s: + in phase, USBIN ;[22] <- phase (one cycle too late) + andi fix, ~(1 << 2) ;[23] + nop2 ;[16] + nop2 ;[18] +bit2IsClr: + ifrset phase, USBMINUS ;[20] check phase only if D- changed + lpm ;[21] + in phase, USBIN ;[22] <- phase (one cycle too late) + ori shift, 1 << 2 ;[23] +bit3AfterClr: + st y+, data ;[24] +entryAfterClr: + ifioset USBIN, USBMINUS ;[26] <--- sample 3 + rjmp bit3IsSet ;[27] + andi shift, ~(7 << 3) ;[28] + breq unstuff3c ;[29] + in phase, USBIN ;[30] <- phase + rjmp bit4AfterClr ;[31] +unstuff3c: + in phase, USBIN ;[31] <- phase (one cycle too late) + andi fix, ~(1 << 3) ;[32] + nop2 ;[25] + nop2 ;[27] +bit3IsSet: + ifrclr phase, USBMINUS ;[29] check phase only if D- changed + lpm ;[30] + in phase, USBIN ;[31] <- phase (one cycle too late) + ori shift, 1 << 3 ;[32] +bit4AfterSet: + mov data, fix ;[33] undo this move by swapping defines +#undef fix +#define fix x1 +#undef data +#define data x2 + ifioclr USBIN, USBMINUS ;[34] <--- sample 4 + rjmp bit4IsClr ;[35] + andi shift, ~(7 << 4) ;[36] + breq unstuff4s ;[37] + in phase, USBIN ;[38] <- phase + rjmp bit5AfterSet ;[39] +unstuff4s: + in phase, USBIN ;[39] <- phase (one cycle too late) + andi fix, ~(1 << 4) ;[40] + nop2 ;[33] + nop2 ;[35] +bit4IsClr: + ifrset phase, USBMINUS ;[37] check phase only if D- changed + lpm ;[38] + in phase, USBIN ;[39] <- phase (one cycle too late) + ori shift, 1 << 4 ;[40] +bit5AfterClr: + ser data ;[41] + ifioset USBIN, USBMINUS ;[42] <--- sample 5 + rjmp bit5IsSet ;[43] + andi shift, ~(7 << 5) ;[44] + breq unstuff5c ;[45] + in phase, USBIN ;[46] <- phase + rjmp bit6AfterClr ;[47] +unstuff5c: + in phase, USBIN ;[47] <- phase (one cycle too late) + andi fix, ~(1 << 5) ;[48] + nop2 ;[41] + nop2 ;[43] +bit5IsSet: + ifrclr phase, USBMINUS ;[45] check phase only if D- changed + lpm ;[46] + in phase, USBIN ;[47] <- phase (one cycle too late) + ori shift, 1 << 5 ;[48] +bit6AfterSet: + subi cnt, 1 ;[49] + brcs jumpToOverflow ;[50] + ifioclr USBIN, USBMINUS ;[51] <--- sample 6 + rjmp bit6IsClr ;[52] + andi shift, ~(3 << 6) ;[53] + cpi shift, 2 ;[54] + in phase, USBIN ;[55] <- phase + brlt unstuff6s ;[56] + rjmp bit7AfterSet ;[57] + +jumpToOverflow: + rjmp overflow + +unstuff6s: + andi fix, ~(1 << 6) ;[50] + lpm ;[51] +bit6IsClr: + ifrset phase, USBMINUS ;[54] check phase only if D- changed + lpm ;[55] + in phase, USBIN ;[56] <- phase (one cycle too late) + ori shift, 1 << 6 ;[57] + nop ;[58] +bit7AfterClr: + ifioset USBIN, USBMINUS ;[59] <--- sample 7 + rjmp bit7IsSet ;[60] + andi shift, ~(1 << 7) ;[61] + cpi shift, 4 ;[62] + in phase, USBIN ;[63] <- phase + brlt unstuff7c ;[64] + rjmp bit0AfterClr ;[65] -> [00] == [67] +unstuff7c: + andi fix, ~(1 << 7) ;[58] + nop ;[59] + rjmp bit7IsSet ;[60] + +bit7IsClr: + ifrset phase, USBMINUS ;[62] check phase only if D- changed + lpm ;[63] + in phase, USBIN ;[64] <- phase (one cycle too late) + ori shift, 1 << 7 ;[65] + nop ;[66] +;;;;rjmp bit0AfterClr ; -> [00] == [67] moved block up to save jump +bit0AfterClr: + eor fix, shift ;[00] +#undef fix +#define fix x2 +#undef data +#define data x1 /* we now have result in data, fix is reset to 0xff */ + ifioset USBIN, USBMINUS ;[01] <--- sample 0 + rjmp bit0IsSet ;[02] + andi shift, ~(7 << 0) ;[03] + breq unstuff0c ;[04] + in phase, USBIN ;[05] <- phase + rjmp bit1AfterClr ;[06] +unstuff0c: + in phase, USBIN ;[06] <- phase (one cycle too late) + andi fix, ~(1 << 0) ;[07] + ifioclr USBIN, USBMINUS ;[00] + ifioset USBIN, USBPLUS ;[01] + rjmp bit0IsSet ;[02] executed if first expr false or second true + rjmp se0AndStore ;[03] executed only if both bits 0 +bit0IsSet: + ifrclr phase, USBMINUS ;[04] check phase only if D- changed + lpm ;[05] + in phase, USBIN ;[06] <- phase (one cycle too late) + ori shift, 1 << 0 ;[07] +bit1AfterSet: + andi shift, ~(7 << 1) ;[08] compensated by "ori shift, 1<<1" if bit1IsClr + ifioclr USBIN, USBMINUS ;[09] <--- sample 1 + rjmp bit1IsClr ;[10] + breq unstuff1s ;[11] + nop2 ;[12] do not check for SE0 if bit 0 was 1 + in phase, USBIN ;[14] <- phase (one cycle too late) + rjmp bit2AfterSet ;[15] +unstuff1s: + in phase, USBIN ;[13] <- phase + andi fix, ~(1 << 1) ;[14] + lpm ;[07] + nop2 ;[10] +bit1IsClr: + ifrset phase, USBMINUS ;[12] check phase only if D- changed + lpm ;[13] + in phase, USBIN ;[14] <- phase (one cycle too late) + ori shift, 1 << 1 ;[15] + nop ;[16] +bit2AfterClr: + ifioset USBIN, USBMINUS ;[17] <--- sample 2 + rjmp bit2IsSet ;[18] + andi shift, ~(7 << 2) ;[19] + breq unstuff2c ;[20] + in phase, USBIN ;[21] <- phase + rjmp bit3AfterClr ;[22] +unstuff2c: + in phase, USBIN ;[22] <- phase (one cycle too late) + andi fix, ~(1 << 2) ;[23] + nop2 ;[16] + nop2 ;[18] +bit2IsSet: + ifrclr phase, USBMINUS ;[20] check phase only if D- changed + lpm ;[21] + in phase, USBIN ;[22] <- phase (one cycle too late) + ori shift, 1 << 2 ;[23] +bit3AfterSet: + st y+, data ;[24] +entryAfterSet: + ifioclr USBIN, USBMINUS ;[26] <--- sample 3 + rjmp bit3IsClr ;[27] + andi shift, ~(7 << 3) ;[28] + breq unstuff3s ;[29] + in phase, USBIN ;[30] <- phase + rjmp bit4AfterSet ;[31] +unstuff3s: + in phase, USBIN ;[31] <- phase (one cycle too late) + andi fix, ~(1 << 3) ;[32] + nop2 ;[25] + nop2 ;[27] +bit3IsClr: + ifrset phase, USBMINUS ;[29] check phase only if D- changed + lpm ;[30] + in phase, USBIN ;[31] <- phase (one cycle too late) + ori shift, 1 << 3 ;[32] +bit4AfterClr: + mov data, fix ;[33] undo this move by swapping defines +#undef fix +#define fix x1 +#undef data +#define data x2 + ifioset USBIN, USBMINUS ;[34] <--- sample 4 + rjmp bit4IsSet ;[35] + andi shift, ~(7 << 4) ;[36] + breq unstuff4c ;[37] + in phase, USBIN ;[38] <- phase + rjmp bit5AfterClr ;[39] +unstuff4c: + in phase, USBIN ;[39] <- phase (one cycle too late) + andi fix, ~(1 << 4) ;[40] + nop2 ;[33] + nop2 ;[35] +bit4IsSet: + ifrclr phase, USBMINUS ;[37] check phase only if D- changed + lpm ;[38] + in phase, USBIN ;[39] <- phase (one cycle too late) + ori shift, 1 << 4 ;[40] +bit5AfterSet: + ser data ;[41] + ifioclr USBIN, USBMINUS ;[42] <--- sample 5 + rjmp bit5IsClr ;[43] + andi shift, ~(7 << 5) ;[44] + breq unstuff5s ;[45] + in phase, USBIN ;[46] <- phase + rjmp bit6AfterSet ;[47] +unstuff5s: + in phase, USBIN ;[47] <- phase (one cycle too late) + andi fix, ~(1 << 5) ;[48] + nop2 ;[41] + nop2 ;[43] +bit5IsClr: + ifrset phase, USBMINUS ;[45] check phase only if D- changed + lpm ;[46] + in phase, USBIN ;[47] <- phase (one cycle too late) + ori shift, 1 << 5 ;[48] +bit6AfterClr: + subi cnt, 1 ;[49] + brcs overflow ;[50] + ifioset USBIN, USBMINUS ;[51] <--- sample 6 + rjmp bit6IsSet ;[52] + andi shift, ~(3 << 6) ;[53] + cpi shift, 2 ;[54] + in phase, USBIN ;[55] <- phase + brlt unstuff6c ;[56] + rjmp bit7AfterClr ;[57] +unstuff6c: + andi fix, ~(1 << 6) ;[50] + lpm ;[51] +bit6IsSet: + ifrclr phase, USBMINUS ;[54] check phase only if D- changed + lpm ;[55] + in phase, USBIN ;[56] <- phase (one cycle too late) + ori shift, 1 << 6 ;[57] +bit7AfterSet: + ifioclr USBIN, USBMINUS ;[59] <--- sample 7 + rjmp bit7IsClr ;[60] + andi shift, ~(1 << 7) ;[61] + cpi shift, 4 ;[62] + in phase, USBIN ;[63] <- phase + brlt unstuff7s ;[64] + rjmp bit0AfterSet ;[65] -> [00] == [67] +unstuff7s: + andi fix, ~(1 << 7) ;[58] + nop ;[59] + rjmp bit7IsClr ;[60] + +macro POP_STANDARD ; 14 cycles + pop r0 + pop cnt + pop x3 + pop x2 + pop x1 + pop shift + pop YH + endm +macro POP_RETI ; 5 cycles + pop YL + out SREG, YL + pop YL + endm + +#include "asmcommon.inc" + +;---------------------------------------------------------------------------- +; Transmitting data +;---------------------------------------------------------------------------- + +txByteLoop: +txBitloop: +stuffN1Delay: ; [03] + ror shift ;[-5] [11] [63] + brcc doExorN1 ;[-4] [64] + subi x3, 1 ;[-3] + brne commonN1 ;[-2] + lsl shift ;[-1] compensate ror after rjmp stuffDelay + nop ;[00] stuffing consists of just waiting 8 cycles + rjmp stuffN1Delay ;[01] after ror, C bit is reliably clear + +sendNakAndReti: + ldi cnt, USBPID_NAK ;[-19] + rjmp sendCntAndReti ;[-18] +sendAckAndReti: + ldi cnt, USBPID_ACK ;[-17] +sendCntAndReti: + mov r0, cnt ;[-16] + ldi YL, 0 ;[-15] R0 address is 0 + ldi YH, 0 ;[-14] + ldi cnt, 2 ;[-13] +; rjmp usbSendAndReti fallthrough + +; USB spec says: +; idle = J +; J = (D+ = 0), (D- = 1) or USBOUT = 0x01 +; K = (D+ = 1), (D- = 0) or USBOUT = 0x02 +; Spec allows 7.5 bit times from EOP to SOP for replies (= 60 cycles) + +;usbSend: +;pointer to data in 'Y' +;number of bytes in 'cnt' -- including sync byte +;uses: x1...x3, shift, cnt, Y [x1 = mirror USBOUT, x2 = USBMASK, x3 = bitstuff cnt] +;Numbers in brackets are time since first bit of sync pattern is sent (start of instruction) +usbSendAndReti: + in x2, USBDDR ;[-10] 10 cycles until SOP + ori x2, USBMASK ;[-9] + sbi USBOUT, USBMINUS ;[-8] prepare idle state; D+ and D- must have been 0 (no pullups) + out USBDDR, x2 ;[-6] <--- acquire bus + in x1, USBOUT ;[-5] port mirror for tx loop + ldi shift, 0x40 ;[-4] sync byte is first byte sent (we enter loop after ror) + ldi x2, USBMASK ;[-3] +doExorN1: + eor x1, x2 ;[-2] [06] [62] + ldi x3, 6 ;[-1] [07] [63] +commonN1: +stuffN2Delay: + out USBOUT, x1 ;[00] [08] [64] <--- set bit + ror shift ;[01] + brcc doExorN2 ;[02] + subi x3, 1 ;[03] + brne commonN2 ;[04] + lsl shift ;[05] compensate ror after rjmp stuffDelay + rjmp stuffN2Delay ;[06] after ror, C bit is reliably clear +doExorN2: + eor x1, x2 ;[04] [12] + ldi x3, 6 ;[05] [13] +commonN2: + nop2 ;[06] [14] + subi cnt, 171 ;[08] [16] trick: (3 * 171) & 0xff = 1 + out USBOUT, x1 ;[09] [17] <--- set bit + brcs txBitloop ;[10] [27] [44] + +stuff6Delay: + ror shift ;[45] [53] + brcc doExor6 ;[46] + subi x3, 1 ;[47] + brne common6 ;[48] + lsl shift ;[49] compensate ror after rjmp stuffDelay + nop ;[50] stuffing consists of just waiting 8 cycles + rjmp stuff6Delay ;[51] after ror, C bit is reliably clear +doExor6: + eor x1, x2 ;[48] [56] + ldi x3, 6 ;[49] +common6: +stuff7Delay: + ror shift ;[50] [58] + out USBOUT, x1 ;[51] <--- set bit + brcc doExor7 ;[52] + subi x3, 1 ;[53] + brne common7 ;[54] + lsl shift ;[55] compensate ror after rjmp stuffDelay + rjmp stuff7Delay ;[56] after ror, C bit is reliably clear +doExor7: + eor x1, x2 ;[54] [62] + ldi x3, 6 ;[55] +common7: + ld shift, y+ ;[56] + nop ;[58] + tst cnt ;[59] + out USBOUT, x1 ;[60] [00]<--- set bit + brne txByteLoop ;[61] [01] +;make SE0: + cbr x1, USBMASK ;[02] prepare SE0 [spec says EOP may be 15 to 18 cycles] + lds x2, usbNewDeviceAddr;[03] + lsl x2 ;[05] we compare with left shifted address + subi YL, 2 + 0 ;[06] Only assign address on data packets, not ACK/NAK in r0 + sbci YH, 0 ;[07] + out USBOUT, x1 ;[00] <-- out SE0 -- from now 2 bits = 16 cycles until bus idle +;2006-03-06: moved transfer of new address to usbDeviceAddr from C-Code to asm: +;set address only after data packet was sent, not after handshake + breq skipAddrAssign ;[01] + sts usbDeviceAddr, x2 ; if not skipped: SE0 is one cycle longer +skipAddrAssign: +;end of usbDeviceAddress transfer + ldi x2, 1< 0) + echo "$s\n"; + } +} + +function printBit($isAfterSet, $bitNum) +{ + ob_start(); + if($isAfterSet){ +?> + ifioclr USBIN, USBMINUS ;[00] <--- sample + rjmp bit#IsClr ;[01] + andi shift, ~(7 << #) ;[02] + breq unstuff#s ;[03] + in phase, USBIN ;[04] <- phase + rjmp bit@AfterSet ;[05] +unstuff#s: + in phase, USBIN ;[05] <- phase (one cycle too late) + andi fix, ~(1 << #) ;[06] + nop2 ;[-1] + nop2 ;[01] +bit#IsClr: + ifrset phase, USBMINUS ;[03] check phase only if D- changed + lpm ;[04] + in phase, USBIN ;[05] <- phase (one cycle too late) + ori shift, 1 << # ;[06] + + ifioset USBIN, USBMINUS ;[00] <--- sample + rjmp bit#IsSet ;[01] + andi shift, ~(7 << #) ;[02] + breq unstuff#c ;[03] + in phase, USBIN ;[04] <- phase + rjmp bit@AfterClr ;[05] +unstuff#c: + in phase, USBIN ;[05] <- phase (one cycle too late) + andi fix, ~(1 << #) ;[06] + nop2 ;[-1] + nop2 ;[01] +bit#IsSet: + ifrclr phase, USBMINUS ;[03] check phase only if D- changed + lpm ;[04] + in phase, USBIN ;[05] <- phase (one cycle too late) + ori shift, 1 << # ;[06] + +*****************************************************************************/ diff --git a/firmware/usbdrv/usbdrvasm15.inc b/firmware/usbdrv/usbdrvasm15.inc new file mode 100644 index 0000000..401b7f8 --- /dev/null +++ b/firmware/usbdrv/usbdrvasm15.inc @@ -0,0 +1,423 @@ +/* Name: usbdrvasm15.inc + * Project: V-USB, virtual USB port for Atmel's(r) AVR(r) microcontrollers + * Author: contributed by V. Bosch + * Creation Date: 2007-08-06 + * Tabsize: 4 + * Copyright: (c) 2007 by OBJECTIVE DEVELOPMENT Software GmbH + * License: GNU GPL v2 (see License.txt), GNU GPL v3 or proprietary (CommercialLicense.txt) + * Revision: $Id: usbdrvasm15.inc 740 2009-04-13 18:23:31Z cs $ + */ + +/* Do not link this file! Link usbdrvasm.S instead, which includes the + * appropriate implementation! + */ + +/* +General Description: +This file is the 15 MHz version of the asssembler part of the USB driver. It +requires a 15 MHz crystal (not a ceramic resonator and not a calibrated RC +oscillator). + +See usbdrv.h for a description of the entire driver. + +Since almost all of this code is timing critical, don't change unless you +really know what you are doing! Many parts require not only a maximum number +of CPU cycles, but even an exact number of cycles! +*/ + +;max stack usage: [ret(2), YL, SREG, YH, bitcnt, shift, x1, x2, x3, x4, cnt] = 12 bytes +;nominal frequency: 15 MHz -> 10.0 cycles per bit, 80.0 cycles per byte +; Numbers in brackets are clocks counted from center of last sync bit +; when instruction starts + +;---------------------------------------------------------------------------- +; order of registers pushed: +; YL, SREG [sofError] YH, shift, x1, x2, x3, bitcnt, cnt, x4 +;---------------------------------------------------------------------------- +USB_INTR_VECTOR: + push YL ;2 push only what is necessary to sync with edge ASAP + in YL, SREG ;1 + push YL ;2 +;---------------------------------------------------------------------------- +; Synchronize with sync pattern: +; +; sync byte (D-) pattern LSb to MSb: 01010100 [1 = idle = J, 0 = K] +; sync up with J to K edge during sync pattern -- use fastest possible loops +;The first part waits at most 1 bit long since we must be in sync pattern. +;YL is guarenteed to be < 0x80 because I flag is clear. When we jump to +;waitForJ, ensure that this prerequisite is met. +waitForJ: + inc YL + sbis USBIN, USBMINUS + brne waitForJ ; just make sure we have ANY timeout +;------------------------------------------------------------------------------- +; The following code results in a sampling window of < 1/4 bit +; which meets the spec. +;------------------------------------------------------------------------------- +waitForK: ;- + sbis USBIN, USBMINUS ;1 [00] <-- sample + rjmp foundK ;2 [01] + sbis USBIN, USBMINUS ; <-- sample + rjmp foundK + sbis USBIN, USBMINUS ; <-- sample + rjmp foundK + sbis USBIN, USBMINUS ; <-- sample + rjmp foundK + sbis USBIN, USBMINUS ; <-- sample + rjmp foundK + sbis USBIN, USBMINUS ; <-- sample + rjmp foundK +#if USB_COUNT_SOF + lds YL, usbSofCount + inc YL + sts usbSofCount, YL +#endif /* USB_COUNT_SOF */ +#ifdef USB_SOF_HOOK + USB_SOF_HOOK +#endif + rjmp sofError +;------------------------------------------------------------------------------ +; {3, 5} after falling D- edge, average delay: 4 cycles [we want 5 for +; center sampling] +; we have 1 bit time for setup purposes, then sample again. +; Numbers in brackets are cycles from center of first sync (double K) +; bit after the instruction +;------------------------------------------------------------------------------ +foundK: ;- [02] + lds YL, usbInputBufOffset;2 [03+04] tx loop + push YH ;2 [05+06] + clr YH ;1 [07] + subi YL, lo8(-(usbRxBuf)) ;1 [08] [rx loop init] + sbci YH, hi8(-(usbRxBuf)) ;1 [09] [rx loop init] + push shift ;2 [10+11] + ser shift ;1 [12] + sbis USBIN, USBMINUS ;1 [-1] [13] <--sample:we want two bits K (sample 1 cycle too early) + rjmp haveTwoBitsK ;2 [00] [14] + pop shift ;2 [15+16] undo the push from before + pop YH ;2 [17+18] undo the push from before + rjmp waitForK ;2 [19+20] this was not the end of sync, retry +; The entire loop from waitForK until rjmp waitForK above must not exceed two +; bit times (= 20 cycles). + +;---------------------------------------------------------------------------- +; push more registers and initialize values while we sample the first bits: +;---------------------------------------------------------------------------- +haveTwoBitsK: ;- [01] + push x1 ;2 [02+03] + push x2 ;2 [04+05] + push x3 ;2 [06+07] + push bitcnt ;2 [08+09] + in x1, USBIN ;1 [00] [10] <-- sample bit 0 + bst x1, USBMINUS ;1 [01] + bld shift, 0 ;1 [02] + push cnt ;2 [03+04] + ldi cnt, USB_BUFSIZE ;1 [05] + push x4 ;2 [06+07] tx loop + rjmp rxLoop ;2 [08] +;---------------------------------------------------------------------------- +; Receiver loop (numbers in brackets are cycles within byte after instr) +;---------------------------------------------------------------------------- +unstuff0: ;- [07] (branch taken) + andi x3, ~0x01 ;1 [08] + mov x1, x2 ;1 [09] x2 contains last sampled (stuffed) bit + in x2, USBIN ;1 [00] [10] <-- sample bit 1 again + andi x2, USBMASK ;1 [01] + breq se0Hop ;1 [02] SE0 check for bit 1 + ori shift, 0x01 ;1 [03] 0b00000001 + nop ;1 [04] + rjmp didUnstuff0 ;2 [05] +;----------------------------------------------------- +unstuff1: ;- [05] (branch taken) + mov x2, x1 ;1 [06] x1 contains last sampled (stuffed) bit + andi x3, ~0x02 ;1 [07] + ori shift, 0x02 ;1 [08] 0b00000010 + nop ;1 [09] + in x1, USBIN ;1 [00] [10] <-- sample bit 2 again + andi x1, USBMASK ;1 [01] + breq se0Hop ;1 [02] SE0 check for bit 2 + rjmp didUnstuff1 ;2 [03] +;----------------------------------------------------- +unstuff2: ;- [05] (branch taken) + andi x3, ~0x04 ;1 [06] + ori shift, 0x04 ;1 [07] 0b00000100 + mov x1, x2 ;1 [08] x2 contains last sampled (stuffed) bit + nop ;1 [09] + in x2, USBIN ;1 [00] [10] <-- sample bit 3 + andi x2, USBMASK ;1 [01] + breq se0Hop ;1 [02] SE0 check for bit 3 + rjmp didUnstuff2 ;2 [03] +;----------------------------------------------------- +unstuff3: ;- [00] [10] (branch taken) + in x2, USBIN ;1 [01] [11] <-- sample stuffed bit 3 one cycle too late + andi x2, USBMASK ;1 [02] + breq se0Hop ;1 [03] SE0 check for stuffed bit 3 + andi x3, ~0x08 ;1 [04] + ori shift, 0x08 ;1 [05] 0b00001000 + rjmp didUnstuff3 ;2 [06] +;---------------------------------------------------------------------------- +; extra jobs done during bit interval: +; +; bit 0: store, clear [SE0 is unreliable here due to bit dribbling in hubs], +; overflow check, jump to the head of rxLoop +; bit 1: SE0 check +; bit 2: SE0 check, recovery from delay [bit 0 tasks took too long] +; bit 3: SE0 check, recovery from delay [bit 0 tasks took too long] +; bit 4: SE0 check, none +; bit 5: SE0 check, none +; bit 6: SE0 check, none +; bit 7: SE0 check, reconstruct: x3 is 0 at bit locations we changed, 1 at others +;---------------------------------------------------------------------------- +rxLoop: ;- [09] + in x2, USBIN ;1 [00] [10] <-- sample bit 1 (or possibly bit 0 stuffed) + andi x2, USBMASK ;1 [01] + brne SkipSe0Hop ;1 [02] +se0Hop: ;- [02] + rjmp se0 ;2 [03] SE0 check for bit 1 +SkipSe0Hop: ;- [03] + ser x3 ;1 [04] + andi shift, 0xf9 ;1 [05] 0b11111001 + breq unstuff0 ;1 [06] +didUnstuff0: ;- [06] + eor x1, x2 ;1 [07] + bst x1, USBMINUS ;1 [08] + bld shift, 1 ;1 [09] + in x1, USBIN ;1 [00] [10] <-- sample bit 2 (or possibly bit 1 stuffed) + andi x1, USBMASK ;1 [01] + breq se0Hop ;1 [02] SE0 check for bit 2 + andi shift, 0xf3 ;1 [03] 0b11110011 + breq unstuff1 ;1 [04] do remaining work for bit 1 +didUnstuff1: ;- [04] + eor x2, x1 ;1 [05] + bst x2, USBMINUS ;1 [06] + bld shift, 2 ;1 [07] + nop2 ;2 [08+09] + in x2, USBIN ;1 [00] [10] <-- sample bit 3 (or possibly bit 2 stuffed) + andi x2, USBMASK ;1 [01] + breq se0Hop ;1 [02] SE0 check for bit 3 + andi shift, 0xe7 ;1 [03] 0b11100111 + breq unstuff2 ;1 [04] +didUnstuff2: ;- [04] + eor x1, x2 ;1 [05] + bst x1, USBMINUS ;1 [06] + bld shift, 3 ;1 [07] +didUnstuff3: ;- [07] + andi shift, 0xcf ;1 [08] 0b11001111 + breq unstuff3 ;1 [09] + in x1, USBIN ;1 [00] [10] <-- sample bit 4 + andi x1, USBMASK ;1 [01] + breq se0Hop ;1 [02] SE0 check for bit 4 + eor x2, x1 ;1 [03] + bst x2, USBMINUS ;1 [04] + bld shift, 4 ;1 [05] +didUnstuff4: ;- [05] + andi shift, 0x9f ;1 [06] 0b10011111 + breq unstuff4 ;1 [07] + nop2 ;2 [08+09] + in x2, USBIN ;1 [00] [10] <-- sample bit 5 + andi x2, USBMASK ;1 [01] + breq se0 ;1 [02] SE0 check for bit 5 + eor x1, x2 ;1 [03] + bst x1, USBMINUS ;1 [04] + bld shift, 5 ;1 [05] +didUnstuff5: ;- [05] + andi shift, 0x3f ;1 [06] 0b00111111 + breq unstuff5 ;1 [07] + nop2 ;2 [08+09] + in x1, USBIN ;1 [00] [10] <-- sample bit 6 + andi x1, USBMASK ;1 [01] + breq se0 ;1 [02] SE0 check for bit 6 + eor x2, x1 ;1 [03] + bst x2, USBMINUS ;1 [04] + bld shift, 6 ;1 [05] +didUnstuff6: ;- [05] + cpi shift, 0x02 ;1 [06] 0b00000010 + brlo unstuff6 ;1 [07] + nop2 ;2 [08+09] + in x2, USBIN ;1 [00] [10] <-- sample bit 7 + andi x2, USBMASK ;1 [01] + breq se0 ;1 [02] SE0 check for bit 7 + eor x1, x2 ;1 [03] + bst x1, USBMINUS ;1 [04] + bld shift, 7 ;1 [05] +didUnstuff7: ;- [05] + cpi shift, 0x04 ;1 [06] 0b00000100 + brlo unstuff7 ;1 [07] + eor x3, shift ;1 [08] reconstruct: x3 is 0 at bit locations we changed, 1 at others + nop ;1 [09] + in x1, USBIN ;1 [00] [10] <-- sample bit 0 + st y+, x3 ;2 [01+02] store data + eor x2, x1 ;1 [03] + bst x2, USBMINUS ;1 [04] + bld shift, 0 ;1 [05] + subi cnt, 1 ;1 [06] + brcs overflow ;1 [07] + rjmp rxLoop ;2 [08] +;----------------------------------------------------- +unstuff4: ;- [08] + andi x3, ~0x10 ;1 [09] + in x1, USBIN ;1 [00] [10] <-- sample stuffed bit 4 + andi x1, USBMASK ;1 [01] + breq se0 ;1 [02] SE0 check for stuffed bit 4 + ori shift, 0x10 ;1 [03] + rjmp didUnstuff4 ;2 [04] +;----------------------------------------------------- +unstuff5: ;- [08] + ori shift, 0x20 ;1 [09] + in x2, USBIN ;1 [00] [10] <-- sample stuffed bit 5 + andi x2, USBMASK ;1 [01] + breq se0 ;1 [02] SE0 check for stuffed bit 5 + andi x3, ~0x20 ;1 [03] + rjmp didUnstuff5 ;2 [04] +;----------------------------------------------------- +unstuff6: ;- [08] + andi x3, ~0x40 ;1 [09] + in x1, USBIN ;1 [00] [10] <-- sample stuffed bit 6 + andi x1, USBMASK ;1 [01] + breq se0 ;1 [02] SE0 check for stuffed bit 6 + ori shift, 0x40 ;1 [03] + rjmp didUnstuff6 ;2 [04] +;----------------------------------------------------- +unstuff7: ;- [08] + andi x3, ~0x80 ;1 [09] + in x2, USBIN ;1 [00] [10] <-- sample stuffed bit 7 + andi x2, USBMASK ;1 [01] + breq se0 ;1 [02] SE0 check for stuffed bit 7 + ori shift, 0x80 ;1 [03] + rjmp didUnstuff7 ;2 [04] + +macro POP_STANDARD ; 16 cycles + pop x4 + pop cnt + pop bitcnt + pop x3 + pop x2 + pop x1 + pop shift + pop YH + endm +macro POP_RETI ; 5 cycles + pop YL + out SREG, YL + pop YL + endm + +#include "asmcommon.inc" + +;--------------------------------------------------------------------------- +; USB spec says: +; idle = J +; J = (D+ = 0), (D- = 1) +; K = (D+ = 1), (D- = 0) +; Spec allows 7.5 bit times from EOP to SOP for replies +;--------------------------------------------------------------------------- +bitstuffN: ;- [04] + eor x1, x4 ;1 [05] + clr x2 ;1 [06] + nop ;1 [07] + rjmp didStuffN ;1 [08] +;--------------------------------------------------------------------------- +bitstuff6: ;- [04] + eor x1, x4 ;1 [05] + clr x2 ;1 [06] + rjmp didStuff6 ;1 [07] +;--------------------------------------------------------------------------- +bitstuff7: ;- [02] + eor x1, x4 ;1 [03] + clr x2 ;1 [06] + nop ;1 [05] + rjmp didStuff7 ;1 [06] +;--------------------------------------------------------------------------- +sendNakAndReti: ;- [-19] + ldi x3, USBPID_NAK ;1 [-18] + rjmp sendX3AndReti ;1 [-17] +;--------------------------------------------------------------------------- +sendAckAndReti: ;- [-17] + ldi cnt, USBPID_ACK ;1 [-16] +sendCntAndReti: ;- [-16] + mov x3, cnt ;1 [-15] +sendX3AndReti: ;- [-15] + ldi YL, 20 ;1 [-14] x3==r20 address is 20 + ldi YH, 0 ;1 [-13] + ldi cnt, 2 ;1 [-12] +; rjmp usbSendAndReti fallthrough +;--------------------------------------------------------------------------- +;usbSend: +;pointer to data in 'Y' +;number of bytes in 'cnt' -- including sync byte [range 2 ... 12] +;uses: x1...x4, btcnt, shift, cnt, Y +;Numbers in brackets are time since first bit of sync pattern is sent +;We need not to match the transfer rate exactly because the spec demands +;only 1.5% precision anyway. +usbSendAndReti: ;- [-13] 13 cycles until SOP + in x2, USBDDR ;1 [-12] + ori x2, USBMASK ;1 [-11] + sbi USBOUT, USBMINUS ;2 [-09-10] prepare idle state; D+ and D- must have been 0 (no pullups) + in x1, USBOUT ;1 [-08] port mirror for tx loop + out USBDDR, x2 ;1 [-07] <- acquire bus + ; need not init x2 (bitstuff history) because sync starts with 0 + ldi x4, USBMASK ;1 [-06] exor mask + ldi shift, 0x80 ;1 [-05] sync byte is first byte sent + ldi bitcnt, 6 ;1 [-04] +txBitLoop: ;- [-04] [06] + sbrs shift, 0 ;1 [-03] [07] + eor x1, x4 ;1 [-02] [08] + ror shift ;1 [-01] [09] +didStuffN: ;- [09] + out USBOUT, x1 ;1 [00] [10] <-- out N + ror x2 ;1 [01] + cpi x2, 0xfc ;1 [02] + brcc bitstuffN ;1 [03] + dec bitcnt ;1 [04] + brne txBitLoop ;1 [05] + sbrs shift, 0 ;1 [06] + eor x1, x4 ;1 [07] + ror shift ;1 [08] +didStuff6: ;- [08] + nop ;1 [09] + out USBOUT, x1 ;1 [00] [10] <-- out 6 + ror x2 ;1 [01] + cpi x2, 0xfc ;1 [02] + brcc bitstuff6 ;1 [03] + sbrs shift, 0 ;1 [04] + eor x1, x4 ;1 [05] + ror shift ;1 [06] + ror x2 ;1 [07] +didStuff7: ;- [07] + ldi bitcnt, 6 ;1 [08] + cpi x2, 0xfc ;1 [09] + out USBOUT, x1 ;1 [00] [10] <-- out 7 + brcc bitstuff7 ;1 [01] + ld shift, y+ ;2 [02+03] + dec cnt ;1 [04] + brne txBitLoop ;1 [05] +makeSE0: + cbr x1, USBMASK ;1 [06] prepare SE0 [spec says EOP may be 19 to 23 cycles] + lds x2, usbNewDeviceAddr;2 [07+08] + lsl x2 ;1 [09] we compare with left shifted address +;2006-03-06: moved transfer of new address to usbDeviceAddr from C-Code to asm: +;set address only after data packet was sent, not after handshake + out USBOUT, x1 ;1 [00] [10] <-- out SE0-- from now 2 bits==20 cycl. until bus idle + subi YL, 20 + 2 ;1 [01] Only assign address on data packets, not ACK/NAK in x3 + sbci YH, 0 ;1 [02] + breq skipAddrAssign ;1 [03] + sts usbDeviceAddr, x2 ;2 [04+05] if not skipped: SE0 is one cycle longer +;---------------------------------------------------------------------------- +;end of usbDeviceAddress transfer +skipAddrAssign: ;- [03/04] + ldi x2, 1< 10.6666666 cycles per bit, 85.333333333 cycles per byte +; Numbers in brackets are clocks counted from center of last sync bit +; when instruction starts + +USB_INTR_VECTOR: +;order of registers pushed: YL, SREG YH, [sofError], bitcnt, shift, x1, x2, x3, x4, cnt + push YL ;[-25] push only what is necessary to sync with edge ASAP + in YL, SREG ;[-23] + push YL ;[-22] + push YH ;[-20] +;---------------------------------------------------------------------------- +; Synchronize with sync pattern: +;---------------------------------------------------------------------------- +;sync byte (D-) pattern LSb to MSb: 01010100 [1 = idle = J, 0 = K] +;sync up with J to K edge during sync pattern -- use fastest possible loops +;The first part waits at most 1 bit long since we must be in sync pattern. +;YL is guarenteed to be < 0x80 because I flag is clear. When we jump to +;waitForJ, ensure that this prerequisite is met. +waitForJ: + inc YL + sbis USBIN, USBMINUS + brne waitForJ ; just make sure we have ANY timeout +waitForK: +;The following code results in a sampling window of < 1/4 bit which meets the spec. + sbis USBIN, USBMINUS ;[-15] + rjmp foundK ;[-14] + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK +#if USB_COUNT_SOF + lds YL, usbSofCount + inc YL + sts usbSofCount, YL +#endif /* USB_COUNT_SOF */ +#ifdef USB_SOF_HOOK + USB_SOF_HOOK +#endif + rjmp sofError +foundK: ;[-12] +;{3, 5} after falling D- edge, average delay: 4 cycles [we want 5 for center sampling] +;we have 1 bit time for setup purposes, then sample again. Numbers in brackets +;are cycles from center of first sync (double K) bit after the instruction + push bitcnt ;[-12] +; [---] ;[-11] + lds YL, usbInputBufOffset;[-10] +; [---] ;[-9] + clr YH ;[-8] + subi YL, lo8(-(usbRxBuf));[-7] [rx loop init] + sbci YH, hi8(-(usbRxBuf));[-6] [rx loop init] + push shift ;[-5] +; [---] ;[-4] + ldi bitcnt, 0x55 ;[-3] [rx loop init] + sbis USBIN, USBMINUS ;[-2] we want two bits K (sample 2 cycles too early) + rjmp haveTwoBitsK ;[-1] + pop shift ;[0] undo the push from before + pop bitcnt ;[2] undo the push from before + rjmp waitForK ;[4] this was not the end of sync, retry +; The entire loop from waitForK until rjmp waitForK above must not exceed two +; bit times (= 21 cycles). + +;---------------------------------------------------------------------------- +; push more registers and initialize values while we sample the first bits: +;---------------------------------------------------------------------------- +haveTwoBitsK: + push x1 ;[1] + push x2 ;[3] + push x3 ;[5] + ldi shift, 0 ;[7] + ldi x3, 1<<4 ;[8] [rx loop init] first sample is inverse bit, compensate that + push x4 ;[9] == leap + + in x1, USBIN ;[11] <-- sample bit 0 + andi x1, USBMASK ;[12] + bst x1, USBMINUS ;[13] + bld shift, 7 ;[14] + push cnt ;[15] + ldi leap, 0 ;[17] [rx loop init] + ldi cnt, USB_BUFSIZE;[18] [rx loop init] + rjmp rxbit1 ;[19] arrives at [21] + +;---------------------------------------------------------------------------- +; Receiver loop (numbers in brackets are cycles within byte after instr) +;---------------------------------------------------------------------------- + +; duration of unstuffing code should be 10.66666667 cycles. We adjust "leap" +; accordingly to approximate this value in the long run. + +unstuff6: + andi x2, USBMASK ;[03] + ori x3, 1<<6 ;[04] will not be shifted any more + andi shift, ~0x80;[05] + mov x1, x2 ;[06] sampled bit 7 is actually re-sampled bit 6 + subi leap, -1 ;[07] total duration = 11 bits -> subtract 1/3 + rjmp didUnstuff6 ;[08] + +unstuff7: + ori x3, 1<<7 ;[09] will not be shifted any more + in x2, USBIN ;[00] [10] re-sample bit 7 + andi x2, USBMASK ;[01] + andi shift, ~0x80;[02] + subi leap, 2 ;[03] total duration = 10 bits -> add 1/3 + rjmp didUnstuff7 ;[04] + +unstuffEven: + ori x3, 1<<6 ;[09] will be shifted right 6 times for bit 0 + in x1, USBIN ;[00] [10] + andi shift, ~0x80;[01] + andi x1, USBMASK ;[02] + breq se0 ;[03] + subi leap, -1 ;[04] total duration = 11 bits -> subtract 1/3 + nop2 ;[05] + rjmp didUnstuffE ;[06] + +unstuffOdd: + ori x3, 1<<5 ;[09] will be shifted right 4 times for bit 1 + in x2, USBIN ;[00] [10] + andi shift, ~0x80;[01] + andi x2, USBMASK ;[02] + breq se0 ;[03] + subi leap, -1 ;[04] total duration = 11 bits -> subtract 1/3 + nop2 ;[05] + rjmp didUnstuffO ;[06] + +rxByteLoop: + andi x1, USBMASK ;[03] + eor x2, x1 ;[04] + subi leap, 1 ;[05] + brpl skipLeap ;[06] + subi leap, -3 ;1 one leap cycle every 3rd byte -> 85 + 1/3 cycles per byte + nop ;1 +skipLeap: + subi x2, 1 ;[08] + ror shift ;[09] +didUnstuff6: + cpi shift, 0xfc ;[10] + in x2, USBIN ;[00] [11] <-- sample bit 7 + brcc unstuff6 ;[01] + andi x2, USBMASK ;[02] + eor x1, x2 ;[03] + subi x1, 1 ;[04] + ror shift ;[05] +didUnstuff7: + cpi shift, 0xfc ;[06] + brcc unstuff7 ;[07] + eor x3, shift ;[08] reconstruct: x3 is 1 at bit locations we changed, 0 at others + st y+, x3 ;[09] store data +rxBitLoop: + in x1, USBIN ;[00] [11] <-- sample bit 0/2/4 + andi x1, USBMASK ;[01] + eor x2, x1 ;[02] + andi x3, 0x3f ;[03] topmost two bits reserved for 6 and 7 + subi x2, 1 ;[04] + ror shift ;[05] + cpi shift, 0xfc ;[06] + brcc unstuffEven ;[07] +didUnstuffE: + lsr x3 ;[08] + lsr x3 ;[09] +rxbit1: + in x2, USBIN ;[00] [10] <-- sample bit 1/3/5 + andi x2, USBMASK ;[01] + breq se0 ;[02] + eor x1, x2 ;[03] + subi x1, 1 ;[04] + ror shift ;[05] + cpi shift, 0xfc ;[06] + brcc unstuffOdd ;[07] +didUnstuffO: + subi bitcnt, 0xab;[08] == addi 0x55, 0x55 = 0x100/3 + brcs rxBitLoop ;[09] + + subi cnt, 1 ;[10] + in x1, USBIN ;[00] [11] <-- sample bit 6 + brcc rxByteLoop ;[01] + rjmp overflow + +macro POP_STANDARD ; 14 cycles + pop cnt + pop x4 + pop x3 + pop x2 + pop x1 + pop shift + pop bitcnt + endm +macro POP_RETI ; 7 cycles + pop YH + pop YL + out SREG, YL + pop YL + endm + +#include "asmcommon.inc" + +; USB spec says: +; idle = J +; J = (D+ = 0), (D- = 1) +; K = (D+ = 1), (D- = 0) +; Spec allows 7.5 bit times from EOP to SOP for replies + +bitstuffN: + eor x1, x4 ;[5] + ldi x2, 0 ;[6] + nop2 ;[7] + nop ;[9] + out USBOUT, x1 ;[10] <-- out + rjmp didStuffN ;[0] + +bitstuff6: + eor x1, x4 ;[5] + ldi x2, 0 ;[6] Carry is zero due to brcc + rol shift ;[7] compensate for ror shift at branch destination + rjmp didStuff6 ;[8] + +bitstuff7: + ldi x2, 0 ;[2] Carry is zero due to brcc + rjmp didStuff7 ;[3] + + +sendNakAndReti: + ldi x3, USBPID_NAK ;[-18] + rjmp sendX3AndReti ;[-17] +sendAckAndReti: + ldi cnt, USBPID_ACK ;[-17] +sendCntAndReti: + mov x3, cnt ;[-16] +sendX3AndReti: + ldi YL, 20 ;[-15] x3==r20 address is 20 + ldi YH, 0 ;[-14] + ldi cnt, 2 ;[-13] +; rjmp usbSendAndReti fallthrough + +;usbSend: +;pointer to data in 'Y' +;number of bytes in 'cnt' -- including sync byte [range 2 ... 12] +;uses: x1...x4, btcnt, shift, cnt, Y +;Numbers in brackets are time since first bit of sync pattern is sent +;We don't match the transfer rate exactly (don't insert leap cycles every third +;byte) because the spec demands only 1.5% precision anyway. +usbSendAndReti: ; 12 cycles until SOP + in x2, USBDDR ;[-12] + ori x2, USBMASK ;[-11] + sbi USBOUT, USBMINUS;[-10] prepare idle state; D+ and D- must have been 0 (no pullups) + in x1, USBOUT ;[-8] port mirror for tx loop + out USBDDR, x2 ;[-7] <- acquire bus +; need not init x2 (bitstuff history) because sync starts with 0 + ldi x4, USBMASK ;[-6] exor mask + ldi shift, 0x80 ;[-5] sync byte is first byte sent +txByteLoop: + ldi bitcnt, 0x35 ;[-4] [6] binary 0011 0101 +txBitLoop: + sbrs shift, 0 ;[-3] [7] + eor x1, x4 ;[-2] [8] + out USBOUT, x1 ;[-1] [9] <-- out N + ror shift ;[0] [10] + ror x2 ;[1] +didStuffN: + cpi x2, 0xfc ;[2] + brcc bitstuffN ;[3] + lsr bitcnt ;[4] + brcc txBitLoop ;[5] + brne txBitLoop ;[6] + + sbrs shift, 0 ;[7] + eor x1, x4 ;[8] +didStuff6: + out USBOUT, x1 ;[-1] [9] <-- out 6 + ror shift ;[0] [10] + ror x2 ;[1] + cpi x2, 0xfc ;[2] + brcc bitstuff6 ;[3] + ror shift ;[4] +didStuff7: + ror x2 ;[5] + sbrs x2, 7 ;[6] + eor x1, x4 ;[7] + nop ;[8] + cpi x2, 0xfc ;[9] + out USBOUT, x1 ;[-1][10] <-- out 7 + brcc bitstuff7 ;[0] [11] + ld shift, y+ ;[1] + dec cnt ;[3] + brne txByteLoop ;[4] +;make SE0: + cbr x1, USBMASK ;[5] prepare SE0 [spec says EOP may be 21 to 25 cycles] + lds x2, usbNewDeviceAddr;[6] + lsl x2 ;[8] we compare with left shifted address + subi YL, 20 + 2 ;[9] Only assign address on data packets, not ACK/NAK in x3 + sbci YH, 0 ;[10] + out USBOUT, x1 ;[11] <-- out SE0 -- from now 2 bits = 22 cycles until bus idle +;2006-03-06: moved transfer of new address to usbDeviceAddr from C-Code to asm: +;set address only after data packet was sent, not after handshake + breq skipAddrAssign ;[0] + sts usbDeviceAddr, x2; if not skipped: SE0 is one cycle longer +skipAddrAssign: +;end of usbDeviceAddress transfer + ldi x2, 1< max 52 cycles interrupt disable +;max stack usage: [ret(2), r0, SREG, YL, YH, shift, x1, x2, x3, x4, cnt] = 12 bytes +;nominal frequency: 16.5 MHz -> 11 cycles per bit +; 16.3125 MHz < F_CPU < 16.6875 MHz (+/- 1.1%) +; Numbers in brackets are clocks counted from center of last sync bit +; when instruction starts + + +USB_INTR_VECTOR: +;order of registers pushed: YL, SREG [sofError], r0, YH, shift, x1, x2, x3, x4, cnt + push YL ;[-23] push only what is necessary to sync with edge ASAP + in YL, SREG ;[-21] + push YL ;[-20] +;---------------------------------------------------------------------------- +; Synchronize with sync pattern: +;---------------------------------------------------------------------------- +;sync byte (D-) pattern LSb to MSb: 01010100 [1 = idle = J, 0 = K] +;sync up with J to K edge during sync pattern -- use fastest possible loops +;The first part waits at most 1 bit long since we must be in sync pattern. +;YL is guarenteed to be < 0x80 because I flag is clear. When we jump to +;waitForJ, ensure that this prerequisite is met. +waitForJ: + inc YL + sbis USBIN, USBMINUS + brne waitForJ ; just make sure we have ANY timeout +waitForK: +;The following code results in a sampling window of < 1/4 bit which meets the spec. + sbis USBIN, USBMINUS ;[-15] + rjmp foundK ;[-14] + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK +#if USB_COUNT_SOF + lds YL, usbSofCount + inc YL + sts usbSofCount, YL +#endif /* USB_COUNT_SOF */ +#ifdef USB_SOF_HOOK + USB_SOF_HOOK +#endif + rjmp sofError +foundK: ;[-12] +;{3, 5} after falling D- edge, average delay: 4 cycles [we want 5 for center sampling] +;we have 1 bit time for setup purposes, then sample again. Numbers in brackets +;are cycles from center of first sync (double K) bit after the instruction + push r0 ;[-12] +; [---] ;[-11] + push YH ;[-10] +; [---] ;[-9] + lds YL, usbInputBufOffset;[-8] +; [---] ;[-7] + clr YH ;[-6] + subi YL, lo8(-(usbRxBuf));[-5] [rx loop init] + sbci YH, hi8(-(usbRxBuf));[-4] [rx loop init] + mov r0, x2 ;[-3] [rx loop init] + sbis USBIN, USBMINUS ;[-2] we want two bits K (sample 2 cycles too early) + rjmp haveTwoBitsK ;[-1] + pop YH ;[0] undo the pushes from before + pop r0 ;[2] + rjmp waitForK ;[4] this was not the end of sync, retry +; The entire loop from waitForK until rjmp waitForK above must not exceed two +; bit times (= 22 cycles). + +;---------------------------------------------------------------------------- +; push more registers and initialize values while we sample the first bits: +;---------------------------------------------------------------------------- +haveTwoBitsK: ;[1] + push shift ;[1] + push x1 ;[3] + push x2 ;[5] + push x3 ;[7] + ldi shift, 0xff ;[9] [rx loop init] + ori x3, 0xff ;[10] [rx loop init] == ser x3, clear zero flag + + in x1, USBIN ;[11] <-- sample bit 0 + bst x1, USBMINUS ;[12] + bld shift, 0 ;[13] + push x4 ;[14] == phase +; [---] ;[15] + push cnt ;[16] +; [---] ;[17] + ldi phase, 0 ;[18] [rx loop init] + ldi cnt, USB_BUFSIZE;[19] [rx loop init] + rjmp rxbit1 ;[20] +; [---] ;[21] + +;---------------------------------------------------------------------------- +; Receiver loop (numbers in brackets are cycles within byte after instr) +;---------------------------------------------------------------------------- +/* +byte oriented operations done during loop: +bit 0: store data +bit 1: SE0 check +bit 2: overflow check +bit 3: catch up +bit 4: rjmp to achieve conditional jump range +bit 5: PLL +bit 6: catch up +bit 7: jump, fixup bitstuff +; 87 [+ 2] cycles +------------------------------------------------------------------ +*/ +continueWithBit5: + in x2, USBIN ;[055] <-- bit 5 + eor r0, x2 ;[056] + or phase, r0 ;[057] + sbrc phase, USBMINUS ;[058] + lpm ;[059] optional nop3; modifies r0 + in phase, USBIN ;[060] <-- phase + eor x1, x2 ;[061] + bst x1, USBMINUS ;[062] + bld shift, 5 ;[063] + andi shift, 0x3f ;[064] + in x1, USBIN ;[065] <-- bit 6 + breq unstuff5 ;[066] *** unstuff escape + eor phase, x1 ;[067] + eor x2, x1 ;[068] + bst x2, USBMINUS ;[069] + bld shift, 6 ;[070] +didUnstuff6: ;[ ] + in r0, USBIN ;[071] <-- phase + cpi shift, 0x02 ;[072] + brlo unstuff6 ;[073] *** unstuff escape +didUnstuff5: ;[ ] + nop2 ;[074] +; [---] ;[075] + in x2, USBIN ;[076] <-- bit 7 + eor x1, x2 ;[077] + bst x1, USBMINUS ;[078] + bld shift, 7 ;[079] +didUnstuff7: ;[ ] + eor r0, x2 ;[080] + or phase, r0 ;[081] + in r0, USBIN ;[082] <-- phase + cpi shift, 0x04 ;[083] + brsh rxLoop ;[084] +; [---] ;[085] +unstuff7: ;[ ] + andi x3, ~0x80 ;[085] + ori shift, 0x80 ;[086] + in x2, USBIN ;[087] <-- sample stuffed bit 7 + nop ;[088] + rjmp didUnstuff7 ;[089] +; [---] ;[090] + ;[080] + +unstuff5: ;[067] + eor phase, x1 ;[068] + andi x3, ~0x20 ;[069] + ori shift, 0x20 ;[070] + in r0, USBIN ;[071] <-- phase + mov x2, x1 ;[072] + nop ;[073] + nop2 ;[074] +; [---] ;[075] + in x1, USBIN ;[076] <-- bit 6 + eor r0, x1 ;[077] + or phase, r0 ;[078] + eor x2, x1 ;[079] + bst x2, USBMINUS ;[080] + bld shift, 6 ;[081] no need to check bitstuffing, we just had one + in r0, USBIN ;[082] <-- phase + rjmp didUnstuff5 ;[083] +; [---] ;[084] + ;[074] + +unstuff6: ;[074] + andi x3, ~0x40 ;[075] + in x1, USBIN ;[076] <-- bit 6 again + ori shift, 0x40 ;[077] + nop2 ;[078] +; [---] ;[079] + rjmp didUnstuff6 ;[080] +; [---] ;[081] + ;[071] + +unstuff0: ;[013] + eor r0, x2 ;[014] + or phase, r0 ;[015] + andi x2, USBMASK ;[016] check for SE0 + in r0, USBIN ;[017] <-- phase + breq didUnstuff0 ;[018] direct jump to se0 would be too long + andi x3, ~0x01 ;[019] + ori shift, 0x01 ;[020] + mov x1, x2 ;[021] mov existing sample + in x2, USBIN ;[022] <-- bit 1 again + rjmp didUnstuff0 ;[023] +; [---] ;[024] + ;[014] + +unstuff1: ;[024] + eor r0, x1 ;[025] + or phase, r0 ;[026] + andi x3, ~0x02 ;[027] + in r0, USBIN ;[028] <-- phase + ori shift, 0x02 ;[029] + mov x2, x1 ;[030] + rjmp didUnstuff1 ;[031] +; [---] ;[032] + ;[022] + +unstuff2: ;[035] + eor r0, x2 ;[036] + or phase, r0 ;[037] + andi x3, ~0x04 ;[038] + in r0, USBIN ;[039] <-- phase + ori shift, 0x04 ;[040] + mov x1, x2 ;[041] + rjmp didUnstuff2 ;[042] +; [---] ;[043] + ;[033] + +unstuff3: ;[043] + in x2, USBIN ;[044] <-- bit 3 again + eor r0, x2 ;[045] + or phase, r0 ;[046] + andi x3, ~0x08 ;[047] + ori shift, 0x08 ;[048] + nop ;[049] + in r0, USBIN ;[050] <-- phase + rjmp didUnstuff3 ;[051] +; [---] ;[052] + ;[042] + +unstuff4: ;[053] + andi x3, ~0x10 ;[054] + in x1, USBIN ;[055] <-- bit 4 again + ori shift, 0x10 ;[056] + rjmp didUnstuff4 ;[057] +; [---] ;[058] + ;[048] + +rxLoop: ;[085] + eor x3, shift ;[086] reconstruct: x3 is 0 at bit locations we changed, 1 at others + in x1, USBIN ;[000] <-- bit 0 + st y+, x3 ;[001] +; [---] ;[002] + eor r0, x1 ;[003] + or phase, r0 ;[004] + eor x2, x1 ;[005] + in r0, USBIN ;[006] <-- phase + ser x3 ;[007] + bst x2, USBMINUS ;[008] + bld shift, 0 ;[009] + andi shift, 0xf9 ;[010] +rxbit1: ;[ ] + in x2, USBIN ;[011] <-- bit 1 + breq unstuff0 ;[012] *** unstuff escape + andi x2, USBMASK ;[013] SE0 check for bit 1 +didUnstuff0: ;[ ] Z only set if we detected SE0 in bitstuff + breq se0 ;[014] + eor r0, x2 ;[015] + or phase, r0 ;[016] + in r0, USBIN ;[017] <-- phase + eor x1, x2 ;[018] + bst x1, USBMINUS ;[019] + bld shift, 1 ;[020] + andi shift, 0xf3 ;[021] +didUnstuff1: ;[ ] + in x1, USBIN ;[022] <-- bit 2 + breq unstuff1 ;[023] *** unstuff escape + eor r0, x1 ;[024] + or phase, r0 ;[025] + subi cnt, 1 ;[026] overflow check + brcs overflow ;[027] + in r0, USBIN ;[028] <-- phase + eor x2, x1 ;[029] + bst x2, USBMINUS ;[030] + bld shift, 2 ;[031] + andi shift, 0xe7 ;[032] +didUnstuff2: ;[ ] + in x2, USBIN ;[033] <-- bit 3 + breq unstuff2 ;[034] *** unstuff escape + eor r0, x2 ;[035] + or phase, r0 ;[036] + eor x1, x2 ;[037] + bst x1, USBMINUS ;[038] + in r0, USBIN ;[039] <-- phase + bld shift, 3 ;[040] + andi shift, 0xcf ;[041] +didUnstuff3: ;[ ] + breq unstuff3 ;[042] *** unstuff escape + nop ;[043] + in x1, USBIN ;[044] <-- bit 4 + eor x2, x1 ;[045] + bst x2, USBMINUS ;[046] + bld shift, 4 ;[047] +didUnstuff4: ;[ ] + eor r0, x1 ;[048] + or phase, r0 ;[049] + in r0, USBIN ;[050] <-- phase + andi shift, 0x9f ;[051] + breq unstuff4 ;[052] *** unstuff escape + rjmp continueWithBit5;[053] +; [---] ;[054] + +macro POP_STANDARD ; 16 cycles + pop cnt + pop x4 + pop x3 + pop x2 + pop x1 + pop shift + pop YH + pop r0 + endm +macro POP_RETI ; 5 cycles + pop YL + out SREG, YL + pop YL + endm + +#include "asmcommon.inc" + + +; USB spec says: +; idle = J +; J = (D+ = 0), (D- = 1) +; K = (D+ = 1), (D- = 0) +; Spec allows 7.5 bit times from EOP to SOP for replies + +bitstuff7: + eor x1, x4 ;[4] + ldi x2, 0 ;[5] + nop2 ;[6] C is zero (brcc) + rjmp didStuff7 ;[8] + +bitstuffN: + eor x1, x4 ;[5] + ldi x2, 0 ;[6] + lpm ;[7] 3 cycle NOP, modifies r0 + out USBOUT, x1 ;[10] <-- out + rjmp didStuffN ;[0] + +#define bitStatus x3 + +sendNakAndReti: + ldi cnt, USBPID_NAK ;[-19] + rjmp sendCntAndReti ;[-18] +sendAckAndReti: + ldi cnt, USBPID_ACK ;[-17] +sendCntAndReti: + mov r0, cnt ;[-16] + ldi YL, 0 ;[-15] R0 address is 0 + ldi YH, 0 ;[-14] + ldi cnt, 2 ;[-13] +; rjmp usbSendAndReti fallthrough + +;usbSend: +;pointer to data in 'Y' +;number of bytes in 'cnt' -- including sync byte [range 2 ... 12] +;uses: x1...x4, shift, cnt, Y +;Numbers in brackets are time since first bit of sync pattern is sent +usbSendAndReti: ; 12 cycles until SOP + in x2, USBDDR ;[-12] + ori x2, USBMASK ;[-11] + sbi USBOUT, USBMINUS;[-10] prepare idle state; D+ and D- must have been 0 (no pullups) + in x1, USBOUT ;[-8] port mirror for tx loop + out USBDDR, x2 ;[-7] <- acquire bus +; need not init x2 (bitstuff history) because sync starts with 0 + ldi x4, USBMASK ;[-6] exor mask + ldi shift, 0x80 ;[-5] sync byte is first byte sent + ldi bitStatus, 0xff ;[-4] init bit loop counter, works for up to 12 bytes +byteloop: +bitloop: + sbrs shift, 0 ;[8] [-3] + eor x1, x4 ;[9] [-2] + out USBOUT, x1 ;[10] [-1] <-- out + ror shift ;[0] + ror x2 ;[1] +didStuffN: + cpi x2, 0xfc ;[2] + brcc bitstuffN ;[3] + nop ;[4] + subi bitStatus, 37 ;[5] 256 / 7 ~=~ 37 + brcc bitloop ;[6] when we leave the loop, bitStatus has almost the initial value + sbrs shift, 0 ;[7] + eor x1, x4 ;[8] + ror shift ;[9] +didStuff7: + out USBOUT, x1 ;[10] <-- out + ror x2 ;[0] + cpi x2, 0xfc ;[1] + brcc bitstuff7 ;[2] + ld shift, y+ ;[3] + dec cnt ;[5] + brne byteloop ;[6] +;make SE0: + cbr x1, USBMASK ;[7] prepare SE0 [spec says EOP may be 21 to 25 cycles] + lds x2, usbNewDeviceAddr;[8] + lsl x2 ;[10] we compare with left shifted address + out USBOUT, x1 ;[11] <-- out SE0 -- from now 2 bits = 22 cycles until bus idle +;2006-03-06: moved transfer of new address to usbDeviceAddr from C-Code to asm: +;set address only after data packet was sent, not after handshake + subi YL, 2 ;[0] Only assign address on data packets, not ACK/NAK in r0 + sbci YH, 0 ;[1] + breq skipAddrAssign ;[2] + sts usbDeviceAddr, x2; if not skipped: SE0 is one cycle longer +skipAddrAssign: +;end of usbDeviceAddress transfer + ldi x2, 1< 12 cycles per bit +; Numbers in brackets are clocks counted from center of last sync bit +; when instruction starts +;register use in receive loop to receive the data bytes: +; shift assembles the byte currently being received +; x1 holds the D+ and D- line state +; x2 holds the previous line state +; cnt holds the number of bytes left in the receive buffer +; x3 holds the higher crc byte (see algorithm below) +; x4 is used as temporary register for the crc algorithm +; x5 is used for unstuffing: when unstuffing the last received bit is inverted in shift (to prevent further +; unstuffing calls. In the same time the corresponding bit in x5 is cleared to mark the bit as beening iverted +; zl lower crc value and crc table index +; zh used for crc table accesses + +;-------------------------------------------------------------------------------------------------------------- +; CRC mods: +; table driven crc checker, Z points to table in prog space +; ZL is the lower crc byte, x3 is the higher crc byte +; x4 is used as temp register to store different results +; the initialization of the crc register is not 0xFFFF but 0xFE54. This is because during the receipt of the +; first data byte an virtual zero data byte is added to the crc register, this results in the correct initial +; value of 0xFFFF at beginning of the second data byte before the first data byte is added to the crc. +; The magic number 0xFE54 results form the crc table: At tabH[0x54] = 0xFF = crcH (required) and +; tabL[0x54] = 0x01 -> crcL = 0x01 xor 0xFE = 0xFF +; bitcnt is renamed to x5 and is used for unstuffing purposes, the unstuffing works like in the 12MHz version +;-------------------------------------------------------------------------------------------------------------- +; CRC algorithm: +; The crc register is formed by x3 (higher byte) and ZL (lower byte). The algorithm uses a 'reversed' form +; i.e. that it takes the least significant bit first and shifts to the right. So in fact the highest order +; bit seen from the polynomial devision point of view is the lsb of ZL. (If this sounds strange to you i +; propose a research on CRC :-) ) +; Each data byte received is xored to ZL, the lower crc byte. This byte now builds the crc +; table index. Next the new high byte is loaded from the table and stored in x4 until we have space in x3 +; (its destination). +; Afterwards the lower table is loaded from the table and stored in ZL (the old index is overwritten as +; we don't need it anymore. In fact this is a right shift by 8 bits.) Now the old crc high value is xored +; to ZL, this is the second shift of the old crc value. Now x4 (the temp reg) is moved to x3 and the crc +; calculation is done. +; Prior to the first byte the two CRC register have to be initialized to 0xFFFF (as defined in usb spec) +; however the crc engine also runs during the receipt of the first byte, therefore x3 and zl are initialized +; to a magic number which results in a crc value of 0xFFFF after the first complete byte. +; +; This algorithm is split into the extra cycles of the different bits: +; bit7: XOR the received byte to ZL +; bit5: load the new high byte to x4 +; bit6: load the lower xor byte from the table, xor zl and x3, store result in zl (=the new crc low value) +; move x4 (the new high byte) to x3, the crc value is ready +; + + +macro POP_STANDARD ; 18 cycles + pop ZH + pop ZL + pop cnt + pop x5 + pop x3 + pop x2 + pop x1 + pop shift + pop x4 + endm +macro POP_RETI ; 7 cycles + pop YH + pop YL + out SREG, YL + pop YL + endm + +macro CRC_CLEANUP_AND_CHECK + ; the last byte has already been xored with the lower crc byte, we have to do the table lookup and xor + ; x3 is the higher crc byte, zl the lower one + ldi ZH, hi8(usbCrcTableHigh);[+1] get the new high byte from the table + lpm x2, Z ;[+2][+3][+4] + ldi ZH, hi8(usbCrcTableLow);[+5] get the new low xor byte from the table + lpm ZL, Z ;[+6][+7][+8] + eor ZL, x3 ;[+7] xor the old high byte with the value from the table, x2:ZL now holds the crc value + cpi ZL, 0x01 ;[+8] if the crc is ok we have a fixed remainder value of 0xb001 in x2:ZL (see usb spec) + brne ignorePacket ;[+9] detected a crc fault -> paket is ignored and retransmitted by the host + cpi x2, 0xb0 ;[+10] + brne ignorePacket ;[+11] detected a crc fault -> paket is ignored and retransmitted by the host + endm + + +USB_INTR_VECTOR: +;order of registers pushed: YL, SREG, YH, [sofError], x4, shift, x1, x2, x3, x5, cnt, ZL, ZH + push YL ;[-28] push only what is necessary to sync with edge ASAP + in YL, SREG ;[-26] + push YL ;[-25] + push YH ;[-23] +;---------------------------------------------------------------------------- +; Synchronize with sync pattern: +;---------------------------------------------------------------------------- +;sync byte (D-) pattern LSb to MSb: 01010100 [1 = idle = J, 0 = K] +;sync up with J to K edge during sync pattern -- use fastest possible loops +;The first part waits at most 1 bit long since we must be in sync pattern. +;YL is guarenteed to be < 0x80 because I flag is clear. When we jump to +;waitForJ, ensure that this prerequisite is met. +waitForJ: + inc YL + sbis USBIN, USBMINUS + brne waitForJ ; just make sure we have ANY timeout +waitForK: +;The following code results in a sampling window of < 1/4 bit which meets the spec. + sbis USBIN, USBMINUS ;[-17] + rjmp foundK ;[-16] + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK +#if USB_COUNT_SOF + lds YL, usbSofCount + inc YL + sts usbSofCount, YL +#endif /* USB_COUNT_SOF */ +#ifdef USB_SOF_HOOK + USB_SOF_HOOK +#endif + rjmp sofError +foundK: ;[-15] +;{3, 5} after falling D- edge, average delay: 4 cycles +;bit0 should be at 30 (2.5 bits) for center sampling. Currently at 4 so 26 cylces till bit 0 sample +;use 1 bit time for setup purposes, then sample again. Numbers in brackets +;are cycles from center of first sync (double K) bit after the instruction + push x4 ;[-14] +; [---] ;[-13] + lds YL, usbInputBufOffset;[-12] used to toggle the two usb receive buffers +; [---] ;[-11] + clr YH ;[-10] + subi YL, lo8(-(usbRxBuf));[-9] [rx loop init] + sbci YH, hi8(-(usbRxBuf));[-8] [rx loop init] + push shift ;[-7] +; [---] ;[-6] + ldi shift, 0x80 ;[-5] the last bit is the end of byte marker for the pid receiver loop + clc ;[-4] the carry has to be clear for receipt of pid bit 0 + sbis USBIN, USBMINUS ;[-3] we want two bits K (sample 3 cycles too early) + rjmp haveTwoBitsK ;[-2] + pop shift ;[-1] undo the push from before + pop x4 ;[1] + rjmp waitForK ;[3] this was not the end of sync, retry +; The entire loop from waitForK until rjmp waitForK above must not exceed two +; bit times (= 24 cycles). + +;---------------------------------------------------------------------------- +; push more registers and initialize values while we sample the first bits: +;---------------------------------------------------------------------------- +haveTwoBitsK: + push x1 ;[0] + push x2 ;[2] + push x3 ;[4] crc high byte + ldi x2, 1< jump back and store the byte + ori shift, 0x01 ;[11] invert the last received bit to prevent furhter unstuffing + in x2, USBIN ;[0] we have some free cycles so we could check for bit stuffing errors + andi x5, 0xFE ;[1] mark this bit as inverted (will be corrected before storing shift) + eor x1, x2 ;[2] x1 and x2 have to be different because the stuff bit is always a zero + andi x1, USBMASK ;[3] mask the interesting bits + breq stuffErr ;[4] if the stuff bit is a 1-bit something went wrong + mov x1, x2 ;[5] the next bit expects the last state to be in x1 + rjmp didunstuff0 ;[6] + ;[7] jump delay of rjmp didunstuffX + +unstuff1: ;[11] this is the jump delay of breq unstuffX + in x1, USBIN ;[0] we have some free cycles so we could check for bit stuffing errors + ori shift, 0x02 ;[1] invert the last received bit to prevent furhter unstuffing + andi x5, 0xFD ;[2] mark this bit as inverted (will be corrected before storing shift) + eor x2, x1 ;[3] x1 and x2 have to be different because the stuff bit is always a zero + andi x2, USBMASK ;[4] mask the interesting bits + breq stuffErr ;[5] if the stuff bit is a 1-bit something went wrong + mov x2, x1 ;[6] the next bit expects the last state to be in x2 + nop2 ;[7] + ;[8] + rjmp didunstuff1 ;[9] + ;[10] jump delay of rjmp didunstuffX + +unstuff2: ;[9] this is the jump delay of breq unstuffX + ori shift, 0x04 ;[10] invert the last received bit to prevent furhter unstuffing + andi x5, 0xFB ;[11] mark this bit as inverted (will be corrected before storing shift) + in x2, USBIN ;[0] we have some free cycles so we could check for bit stuffing errors + eor x1, x2 ;[1] x1 and x2 have to be different because the stuff bit is always a zero + andi x1, USBMASK ;[2] mask the interesting bits + breq stuffErr ;[3] if the stuff bit is a 1-bit something went wrong + mov x1, x2 ;[4] the next bit expects the last state to be in x1 + nop2 ;[5] + ;[6] + rjmp didunstuff2 ;[7] + ;[8] jump delay of rjmp didunstuffX + +unstuff3: ;[9] this is the jump delay of breq unstuffX + ori shift, 0x08 ;[10] invert the last received bit to prevent furhter unstuffing + andi x5, 0xF7 ;[11] mark this bit as inverted (will be corrected before storing shift) + in x1, USBIN ;[0] we have some free cycles so we could check for bit stuffing errors + eor x2, x1 ;[1] x1 and x2 have to be different because the stuff bit is always a zero + andi x2, USBMASK ;[2] mask the interesting bits + breq stuffErr ;[3] if the stuff bit is a 1-bit something went wrong + mov x2, x1 ;[4] the next bit expects the last state to be in x2 + nop2 ;[5] + ;[6] + rjmp didunstuff3 ;[7] + ;[8] jump delay of rjmp didunstuffX + + + +; the include has to be here due to branch distance restirctions +#define __USE_CRC__ +#include "asmcommon.inc" + + + +; USB spec says: +; idle = J +; J = (D+ = 0), (D- = 1) +; K = (D+ = 1), (D- = 0) +; Spec allows 7.5 bit times from EOP to SOP for replies +; 7.5 bit times is 90 cycles. ...there is plenty of time + + +sendNakAndReti: + ldi x3, USBPID_NAK ;[-18] + rjmp sendX3AndReti ;[-17] +sendAckAndReti: + ldi cnt, USBPID_ACK ;[-17] +sendCntAndReti: + mov x3, cnt ;[-16] +sendX3AndReti: + ldi YL, 20 ;[-15] x3==r20 address is 20 + ldi YH, 0 ;[-14] + ldi cnt, 2 ;[-13] +; rjmp usbSendAndReti fallthrough + +;usbSend: +;pointer to data in 'Y' +;number of bytes in 'cnt' -- including sync byte [range 2 ... 12] +;uses: x1...x4, btcnt, shift, cnt, Y +;Numbers in brackets are time since first bit of sync pattern is sent + +usbSendAndReti: ; 12 cycles until SOP + in x2, USBDDR ;[-12] + ori x2, USBMASK ;[-11] + sbi USBOUT, USBMINUS;[-10] prepare idle state; D+ and D- must have been 0 (no pullups) + in x1, USBOUT ;[-8] port mirror for tx loop + out USBDDR, x2 ;[-6] <- acquire bus + ldi x2, 0 ;[-6] init x2 (bitstuff history) because sync starts with 0 + ldi x4, USBMASK ;[-5] exor mask + ldi shift, 0x80 ;[-4] sync byte is first byte sent +txByteLoop: + ldi bitcnt, 0x40 ;[-3]=[9] binary 01000000 +txBitLoop: ; the loop sends the first 7 bits of the byte + sbrs shift, 0 ;[-2]=[10] if we have to send a 1 don't change the line state + eor x1, x4 ;[-1]=[11] + out USBOUT, x1 ;[0] + ror shift ;[1] + ror x2 ;[2] transfers the last sent bit to the stuffing history +didStuffN: + nop ;[3] + nop ;[4] + cpi x2, 0xfc ;[5] if we sent six consecutive ones + brcc bitstuffN ;[6] + lsr bitcnt ;[7] + brne txBitLoop ;[8] restart the loop while the 1 is still in the bitcount + +; transmit bit 7 + sbrs shift, 0 ;[9] + eor x1, x4 ;[10] +didStuff7: + ror shift ;[11] + out USBOUT, x1 ;[0] transfer bit 7 to the pins + ror x2 ;[1] move the bit into the stuffing history + cpi x2, 0xfc ;[2] + brcc bitstuff7 ;[3] + ld shift, y+ ;[4] get next byte to transmit + dec cnt ;[5] decrement byte counter + brne txByteLoop ;[7] if we have more bytes start next one + ;[8] branch delay + +;make SE0: + cbr x1, USBMASK ;[8] prepare SE0 [spec says EOP may be 25 to 30 cycles] + lds x2, usbNewDeviceAddr;[9] + lsl x2 ;[11] we compare with left shifted address + out USBOUT, x1 ;[0] <-- out SE0 -- from now 2 bits = 24 cycles until bus idle + subi YL, 20 + 2 ;[1] Only assign address on data packets, not ACK/NAK in x3 + sbci YH, 0 ;[2] +;2006-03-06: moved transfer of new address to usbDeviceAddr from C-Code to asm: +;set address only after data packet was sent, not after handshake + breq skipAddrAssign ;[3] + sts usbDeviceAddr, x2 ; if not skipped: SE0 is one cycle longer +skipAddrAssign: +;end of usbDeviceAddress transfer + ldi x2, 1< +int main (int argc, char **argv) +{ + int i, j; + for (i=0; i<512; i++){ + unsigned short crc = i & 0xff; + for(j=0; j<8; j++) crc = (crc >> 1) ^ ((crc & 1) ? 0xa001 : 0); + if((i & 7) == 0) printf("\n.byte "); + printf("0x%02x, ", (i > 0xff ? (crc >> 8) : crc) & 0xff); + if(i == 255) printf("\n"); + } + return 0; +} + +// Use the following algorithm to compute CRC values: +ushort computeCrc(uchar *msg, uchar msgLen) +{ + uchar i; + ushort crc = 0xffff; + for(i = 0; i < msgLen; i++) + crc = usbCrcTable16[lo8(crc) ^ msg[i]] ^ hi8(crc); + return crc; +} +*/ + +.balign 256 +usbCrcTableLow: +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x00, 0xC1, 0x81, 0x40, 0x01, 0xC0, 0x80, 0x41 +.byte 0x01, 0xC0, 0x80, 0x41, 0x00, 0xC1, 0x81, 0x40 + +; .balign 256 +usbCrcTableHigh: +.byte 0x00, 0xC0, 0xC1, 0x01, 0xC3, 0x03, 0x02, 0xC2 +.byte 0xC6, 0x06, 0x07, 0xC7, 0x05, 0xC5, 0xC4, 0x04 +.byte 0xCC, 0x0C, 0x0D, 0xCD, 0x0F, 0xCF, 0xCE, 0x0E +.byte 0x0A, 0xCA, 0xCB, 0x0B, 0xC9, 0x09, 0x08, 0xC8 +.byte 0xD8, 0x18, 0x19, 0xD9, 0x1B, 0xDB, 0xDA, 0x1A +.byte 0x1E, 0xDE, 0xDF, 0x1F, 0xDD, 0x1D, 0x1C, 0xDC +.byte 0x14, 0xD4, 0xD5, 0x15, 0xD7, 0x17, 0x16, 0xD6 +.byte 0xD2, 0x12, 0x13, 0xD3, 0x11, 0xD1, 0xD0, 0x10 +.byte 0xF0, 0x30, 0x31, 0xF1, 0x33, 0xF3, 0xF2, 0x32 +.byte 0x36, 0xF6, 0xF7, 0x37, 0xF5, 0x35, 0x34, 0xF4 +.byte 0x3C, 0xFC, 0xFD, 0x3D, 0xFF, 0x3F, 0x3E, 0xFE +.byte 0xFA, 0x3A, 0x3B, 0xFB, 0x39, 0xF9, 0xF8, 0x38 +.byte 0x28, 0xE8, 0xE9, 0x29, 0xEB, 0x2B, 0x2A, 0xEA +.byte 0xEE, 0x2E, 0x2F, 0xEF, 0x2D, 0xED, 0xEC, 0x2C +.byte 0xE4, 0x24, 0x25, 0xE5, 0x27, 0xE7, 0xE6, 0x26 +.byte 0x22, 0xE2, 0xE3, 0x23, 0xE1, 0x21, 0x20, 0xE0 +.byte 0xA0, 0x60, 0x61, 0xA1, 0x63, 0xA3, 0xA2, 0x62 +.byte 0x66, 0xA6, 0xA7, 0x67, 0xA5, 0x65, 0x64, 0xA4 +.byte 0x6C, 0xAC, 0xAD, 0x6D, 0xAF, 0x6F, 0x6E, 0xAE +.byte 0xAA, 0x6A, 0x6B, 0xAB, 0x69, 0xA9, 0xA8, 0x68 +.byte 0x78, 0xB8, 0xB9, 0x79, 0xBB, 0x7B, 0x7A, 0xBA +.byte 0xBE, 0x7E, 0x7F, 0xBF, 0x7D, 0xBD, 0xBC, 0x7C +.byte 0xB4, 0x74, 0x75, 0xB5, 0x77, 0xB7, 0xB6, 0x76 +.byte 0x72, 0xB2, 0xB3, 0x73, 0xB1, 0x71, 0x70, 0xB0 +.byte 0x50, 0x90, 0x91, 0x51, 0x93, 0x53, 0x52, 0x92 +.byte 0x96, 0x56, 0x57, 0x97, 0x55, 0x95, 0x94, 0x54 +.byte 0x9C, 0x5C, 0x5D, 0x9D, 0x5F, 0x9F, 0x9E, 0x5E +.byte 0x5A, 0x9A, 0x9B, 0x5B, 0x99, 0x59, 0x58, 0x98 +.byte 0x88, 0x48, 0x49, 0x89, 0x4B, 0x8B, 0x8A, 0x4A +.byte 0x4E, 0x8E, 0x8F, 0x4F, 0x8D, 0x4D, 0x4C, 0x8C +.byte 0x44, 0x84, 0x85, 0x45, 0x87, 0x47, 0x46, 0x86 +.byte 0x82, 0x42, 0x43, 0x83, 0x41, 0x81, 0x80, 0x40 + diff --git a/firmware/usbdrv/usbdrvasm20.inc b/firmware/usbdrv/usbdrvasm20.inc new file mode 100644 index 0000000..303abaf --- /dev/null +++ b/firmware/usbdrv/usbdrvasm20.inc @@ -0,0 +1,360 @@ +/* Name: usbdrvasm20.inc + * Project: V-USB, virtual USB port for Atmel's(r) AVR(r) microcontrollers + * Author: Jeroen Benschop + * Based on usbdrvasm16.inc from Christian Starkjohann + * Creation Date: 2008-03-05 + * Tabsize: 4 + * Copyright: (c) 2008 by Jeroen Benschop and OBJECTIVE DEVELOPMENT Software GmbH + * License: GNU GPL v2 (see License.txt), GNU GPL v3 or proprietary (CommercialLicense.txt) + * Revision: $Id: usbdrvasm20.inc 740 2009-04-13 18:23:31Z cs $ + */ + +/* Do not link this file! Link usbdrvasm.S instead, which includes the + * appropriate implementation! + */ + +/* +General Description: +This file is the 20 MHz version of the asssembler part of the USB driver. It +requires a 20 MHz crystal (not a ceramic resonator and not a calibrated RC +oscillator). + +See usbdrv.h for a description of the entire driver. + +Since almost all of this code is timing critical, don't change unless you +really know what you are doing! Many parts require not only a maximum number +of CPU cycles, but even an exact number of cycles! +*/ + +#define leap2 x3 +#ifdef __IAR_SYSTEMS_ASM__ +#define nextInst $+2 +#else +#define nextInst .+0 +#endif + +;max stack usage: [ret(2), YL, SREG, YH, bitcnt, shift, x1, x2, x3, x4, cnt] = 12 bytes +;nominal frequency: 20 MHz -> 13.333333 cycles per bit, 106.666667 cycles per byte +; Numbers in brackets are clocks counted from center of last sync bit +; when instruction starts +;register use in receive loop: +; shift assembles the byte currently being received +; x1 holds the D+ and D- line state +; x2 holds the previous line state +; x4 (leap) is used to add a leap cycle once every three bytes received +; X3 (leap2) is used to add a leap cycle once every three stuff bits received +; bitcnt is used to determine when a stuff bit is due +; cnt holds the number of bytes left in the receive buffer + +USB_INTR_VECTOR: +;order of registers pushed: YL, SREG YH, [sofError], bitcnt, shift, x1, x2, x3, x4, cnt + push YL ;[-28] push only what is necessary to sync with edge ASAP + in YL, SREG ;[-26] + push YL ;[-25] + push YH ;[-23] +;---------------------------------------------------------------------------- +; Synchronize with sync pattern: +;---------------------------------------------------------------------------- +;sync byte (D-) pattern LSb to MSb: 01010100 [1 = idle = J, 0 = K] +;sync up with J to K edge during sync pattern -- use fastest possible loops +;The first part waits at most 1 bit long since we must be in sync pattern. +;YL is guarenteed to be < 0x80 because I flag is clear. When we jump to +;waitForJ, ensure that this prerequisite is met. +waitForJ: + inc YL + sbis USBIN, USBMINUS + brne waitForJ ; just make sure we have ANY timeout +waitForK: +;The following code results in a sampling window of < 1/4 bit which meets the spec. + sbis USBIN, USBMINUS ;[-19] + rjmp foundK ;[-18] + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK + sbis USBIN, USBMINUS + rjmp foundK +#if USB_COUNT_SOF + lds YL, usbSofCount + inc YL + sts usbSofCount, YL +#endif /* USB_COUNT_SOF */ +#ifdef USB_SOF_HOOK + USB_SOF_HOOK +#endif + rjmp sofError +foundK: ;[-16] +;{3, 5} after falling D- edge, average delay: 4 cycles +;bit0 should be at 34 for center sampling. Currently at 4 so 30 cylces till bit 0 sample +;use 1 bit time for setup purposes, then sample again. Numbers in brackets +;are cycles from center of first sync (double K) bit after the instruction + push bitcnt ;[-16] +; [---] ;[-15] + lds YL, usbInputBufOffset;[-14] +; [---] ;[-13] + clr YH ;[-12] + subi YL, lo8(-(usbRxBuf));[-11] [rx loop init] + sbci YH, hi8(-(usbRxBuf));[-10] [rx loop init] + push shift ;[-9] +; [---] ;[-8] + ldi shift,0x40 ;[-7] set msb to "1" so processing bit7 can be detected + nop2 ;[-6] +; [---] ;[-5] + ldi bitcnt, 5 ;[-4] [rx loop init] + sbis USBIN, USBMINUS ;[-3] we want two bits K (sample 3 cycles too early) + rjmp haveTwoBitsK ;[-2] + pop shift ;[-1] undo the push from before + pop bitcnt ;[1] + rjmp waitForK ;[3] this was not the end of sync, retry +; The entire loop from waitForK until rjmp waitForK above must not exceed two +; bit times (= 27 cycles). + +;---------------------------------------------------------------------------- +; push more registers and initialize values while we sample the first bits: +;---------------------------------------------------------------------------- +haveTwoBitsK: + push x1 ;[0] + push x2 ;[2] + push x3 ;[4] (leap2) + ldi leap2, 0x55 ;[6] add leap cycle on 2nd,5th,8th,... stuff bit + push x4 ;[7] == leap + ldi leap, 0x55 ;[9] skip leap cycle on 2nd,5th,8th,... byte received + push cnt ;[10] + ldi cnt, USB_BUFSIZE ;[12] [rx loop init] + ldi x2, 1< +#ifndef __IAR_SYSTEMS_ASM__ +# include +#endif + +#define __attribute__(arg) /* not supported on IAR */ + +#ifdef __IAR_SYSTEMS_ASM__ +# define __ASSEMBLER__ /* IAR does not define standard macro for asm */ +#endif + +#ifdef __HAS_ELPM__ +# define PROGMEM __farflash +#else +# define PROGMEM __flash +#endif + +#define USB_READ_FLASH(addr) (*(PROGMEM char *)(addr)) + +/* The following definitions are not needed by the driver, but may be of some + * help if you port a gcc based project to IAR. + */ +#define cli() __disable_interrupt() +#define sei() __enable_interrupt() +#define wdt_reset() __watchdog_reset() +#define _BV(x) (1 << (x)) + +/* assembler compatibility macros */ +#define nop2 rjmp $+2 /* jump to next instruction */ +#define XL r26 +#define XH r27 +#define YL r28 +#define YH r29 +#define ZL r30 +#define ZH r31 +#define lo8(x) LOW(x) +#define hi8(x) (((x)>>8) & 0xff) /* not HIGH to allow XLINK to make a proper range check */ + +/* Depending on the device you use, you may get problems with the way usbdrv.h + * handles the differences between devices. Since IAR does not use #defines + * for MCU registers, we can't check for the existence of a particular + * register with an #ifdef. If the autodetection mechanism fails, include + * definitions for the required USB_INTR_* macros in your usbconfig.h. See + * usbconfig-prototype.h and usbdrv.h for details. + */ + +/* ------------------------------------------------------------------------- */ +#elif __CODEVISIONAVR__ /* check for CodeVision AVR */ +/* ------------------------------------------------------------------------- */ +/* This port is not working (yet) */ + +/* #define F_CPU _MCU_CLOCK_FREQUENCY_ seems to be defined automatically */ + +#include +#include + +#define __attribute__(arg) /* not supported on IAR */ + +#define PROGMEM __flash +#define USB_READ_FLASH(addr) (*(PROGMEM char *)(addr)) + +#ifndef __ASSEMBLER__ +static inline void cli(void) +{ + #asm("cli"); +} +static inline void sei(void) +{ + #asm("sei"); +} +#endif +#define _delay_ms(t) delay_ms(t) +#define _BV(x) (1 << (x)) +#define USB_CFG_USE_SWITCH_STATEMENT 1 /* macro for if() cascase fails for unknown reason */ + +#define macro .macro +#define endm .endmacro +#define nop2 rjmp .+0 /* jump to next instruction */ + +/* ------------------------------------------------------------------------- */ +#else /* default development environment is avr-gcc/avr-libc */ +/* ------------------------------------------------------------------------- */ + +#include +#ifdef __ASSEMBLER__ +# define _VECTOR(N) __vector_ ## N /* io.h does not define this for asm */ +#else +# include +#endif + +#if USB_CFG_DRIVER_FLASH_PAGE +# define USB_READ_FLASH(addr) pgm_read_byte_far(((long)USB_CFG_DRIVER_FLASH_PAGE << 16) | (long)(addr)) +#else +# define USB_READ_FLASH(addr) pgm_read_byte(addr) +#endif + +#define macro .macro +#define endm .endm +#define nop2 rjmp .+0 /* jump to next instruction */ + +#endif /* development environment */ + +/* for conveniecne, ensure that PRG_RDB exists */ +#ifndef PRG_RDB +# define PRG_RDB(addr) USB_READ_FLASH(addr) +#endif +#endif /* __usbportability_h_INCLUDED__ */ diff --git a/images/4x20-front.jpg b/images/4x20-front.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3e71fa217875bcf819a0e06f87a924d1d6fc597d GIT binary patch literal 11862 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 Xflc+SAR;S^Ly0+Z1HoE2`q%#g@6Oq> literal 0 HcmV?d00001 diff --git a/images/4x20-rear.jpg b/images/4x20-rear.jpg new file mode 100644 index 0000000000000000000000000000000000000000..8dfcc3a097dbf5276c4e24cdd0f62e100b551c57 GIT binary patch literal 17066 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 Bwy6LB literal 0 HcmV?d00001 diff --git a/images/avrisp.gif b/images/avrisp.gif new file mode 100644 index 0000000000000000000000000000000000000000..44ef3f956f1e46e00f9b84aa5600d72b5bd3b693 GIT binary patch literal 7096 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�T(%{MwFJv;wn(n9zb(nMSZ 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 literal 0 HcmV?d00001 diff --git a/images/connectors.gif b/images/connectors.gif new file mode 100644 index 0000000000000000000000000000000000000000..fc2f1c86dae5308c252e6510ecf3373672883ce3 GIT binary patch literal 3051 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 literal 0 HcmV?d00001 diff --git a/images/disp_con3.gif b/images/disp_con3.gif new file mode 100644 index 0000000000000000000000000000000000000000..cf12b4e446da55eb629f4d4793257bf159697b90 GIT binary patch literal 3251 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 literal 0 HcmV?d00001 diff --git a/images/pcb.gif b/images/pcb.gif new file mode 100644 index 0000000000000000000000000000000000000000..e3804a2a4ef23d32a6d919e25a9700143c861bcd GIT binary patch literal 57439 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%0AjK-JMMMA4xc(qm!;KWNsV~Qh_QOWKX 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 literal 0 HcmV?d00001 diff --git a/images/pcb.jpg b/images/pcb.jpg new file mode 100644 index 0000000000000000000000000000000000000000..65fcda069dceda586506f3c2bd1b3667466a1214 GIT binary patch literal 11467 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 literal 0 HcmV?d00001 diff --git a/images/prototyp.jpg b/images/prototyp.jpg new file mode 100644 index 0000000000000000000000000000000000000000..fbc2dcb09d7e8e635dea9b12e03eafac726ba895 GIT binary patch literal 23946 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 literal 0 HcmV?d00001 diff --git a/images/simple.jpg b/images/simple.jpg new file mode 100644 index 0000000000000000000000000000000000000000..eb410cc2308245304b2c6fe48e0a6c6f3ce72137 GIT binary patch literal 13905 zcmbWebyQqE^fo%U7K#=b+_iWIw<3ePOJQ(_!70TGEfgKBxVuwaT6}PKcZwEwxxByc zu6x(If8FoPS;@*d$;rxd&d$zG_LGaCTPN$+doIkEC4e*l9TgP~6$Kp)4GjYW9TS`I4K@}QHYq*Kknj**dH__fxKR-PCjkEMfPjdEjDm`Wj)95wTA}_e01*KR z2@x3y1qB)TwYL9jIRF_C1)qjn5|u#R42{;6kS8cE2c1r;rjtlx;*_4(+$|UbllUD8 zDH#JJ6Eh1dAHTo{kf4zCM;Tc;d9Z?}mbQ+rp1uLZ!qUpx#?}t%?&0a>?c*ErH8kwo z_wWcorGwqwgEr}HD6t! zOoMeC5v4>TM|UwFF%VBDU;C!8MoVMZrIZJJY($?$T&H)hzlL{Mj~Z}xVBWk|yjy_S zw)XrECsvTmW8*%NYBuK9sO1x>G3)k|g}Q_>WfF?01cm)jOkWzirMqp+>^kmKQpyVe zt8zIjSsMBRaE819zGrj#HeDA5naGO?(0qC)^{Bk|0x(m40feslzQN;t0hltq0K&65 z{SYI(5!);totn_>{+?P-jf!tbKRULNU==KGUvsW)Nf=$HWBZPyc<0>Cl@ue}Hc)2< z{u6)Tr@5UgcU*Sh+o9a2c>yf^#mZbo5y7=P?L5mfVm3T#aoc)M=?}Q}{d7CBiTVOa z5@6+?mRfiLj2BlM-2}39+IM{G6UUQxdsD38C;bALE6j=%qlbRq3zCCwzrP~XXW?)&d*_e@GZ_o=Mdg4>_CCI=?cXaKvPDJOR zv?U>mF2EE0RQzo5dJSdO#7>O(SNreu5x$Ow%~H@Pnu@Rn^2oA=c_zY%t*b;If?`7^ z3MUI-q%O^N+d_>HC*i-WKMFVkeFTY?HZ1}sCqLd=txYjd+V?#5?1%fX{rU;H@rep~ zrsD>H{geXOMNI{)Hi*pzW<;MVxGDg;v=IqK^@Iq!2lccC)I_Wm0BYcLX&tLp>F;R( z^Q)}9io=5%V(G<*0w5o;xdPf-QfP-;B#n9)8VPRy{g-q+f0Gj2LkBM=jQi021<0T_hL zFxr_s8rUA~H5!9hU;@gk)=H69ZGHL)zcJl!O6V;G&G58Gc~eX1ocz1R(r0TDN2Z!- z67?m{;gq`}Ty&HMTL-q8`hB+fpW^nl)S0tluIyvrkG91AdEdvsc)T;5qXynJBDQvl;*Ezti%!sq@?N}-4yn2d7uBj05BuKnKA&F>qmqg$83DgZFFvC1jGHEt zb|f%N%cI@2Mn21!xm5k?vBD;QYLb-f1*17nX4r}g7nK&C=VR~@1tKZY@jBeU1zV$#Z7R5eF!1@7_xjo%QTC4ZZx5`K`uyzG!=IwR>X z#*GmXL3`))CGNwm?pRB7eSp9Bq_NV!$PMtF?%%wiTb;eIM@cV=MT3#w@}znp11v%5 zds7h+(XKH(3>P<|k+%=hR30bfPxDb9o(Z0)>b$<~zkLCa?Uais<{i94U7hnW$ABZR z13zJ>`(7NYsg^HxocC7OHM{`Y6D$y_w}AK3M%U!}h9MVtX+JW|gRbK1DH;ZHs!3PqHKhiL{Nec)xWPbMB+yXh@{n zXIU!s!nXS*Mqp>6{pU$Jy{c)U7!YQkOOT%DqTu)_=aJ(*xz+n#1PVvC z#UTHj>mzbCP#LNr;x^OiE#B3V6w0ur^tQZL;n?ZtSYuP=EIPfOwuO4LEDo;0->-Gk z6O4^~mjfTYP>F;S@9yyowskqkmL-b~m!*SiV8*;RLCBD+u?>SF{p9D*s!vZZfJ4m| zGQNllWj6gHy|nt6XPN&VsZ@zS-r_#I7SB((6Z5(F+mw$T`^DUyQr$ef0BUl7WY_c- zUzTWTYH4L#{lrz*U@oj88oCYXi?g|b&39wif0fu-OF)`JN}qHZJW2t}7-zUeBuWx( z$DC>0(XG;i{BwjSK_B<4KWol78RfgcTS*bj2gFtEeCEvki{eECaRjR<&t%SvzSr9q z?x=n56aA(-S!H;8W7I}&4iKj$?$yso8lG_%%F^n##K;C#{GCInW30YLFjS8zD`G zrX9&X@q1@rDJwqx)3%>=WL_NYNAk~x@Quy6tv4huT`z3c(5-^N(So`R2fZ(#FHMOQ(NMDHaluj-X&V6ndGC*iYnH*p ztAxyQrmk}AToWTB1ntM~rv_CjB}+kppCSQ)pYxEA4ksHbMD$AyQ+DB9 z)w9ZO`KxP;@hTaE1dUa4tVoSbs?U^cp~t*2njVb_+x*1MH%n7(OE+10M7Q=3ny5_S za5A`>mlGA}E&{YpmFK%99ctJh-F6cF^(y8>C1tliOq@TcOj`vtWTkvm7sH_ViF7zW zi@#=+LvBfp4GFq?uDfGe?p?emgDciNe1v^St*QH(?{gQpGF4>cdVEiTMTK2|U4-9l zEn4S>f7aG<4DiJlGufa-(DX(^` zV?Nh#QLqqMxCpo+kK0)1OcCFZpn5>mZ(2yhUe?~%bN=r?zMsLP@rKNn*lnn5b0X>M zSsl8mU}uJ;B6h=PZ(!6QbgJF`!fvtR0DW(obN3^1s834pbA9TBvs;gogNH~u!ZTv! zTbP$a&+#P(8z#B>5d9@W%xq31ULX`Mcs$}$A9^%9$E{G? zG=H#6Fu&WLEThllx6cr|r4eHLi8p;4f_xuzJFV+$@bLY!uWYgzeww{1>+uJtPl2e& zd!(cGNZoU>cGnQic0HKl_b!2z(pKNlp-kU7Gq>#J=B3DHCp4qxg)w ziC|a{ff9}GFw*s(!F^PMj;_WXI|=&FI`zg_DrN#rGQZA+!8~9LLA?hFJoP zN!)(|>9&EVs35c~lbIR!)JeFqL7mIc!gxfQU*kR98cLlRVHjFOv>st*w(Gu8#O;`p zMAjLf71kUky0~dl13Q1KqXBX1qQqIrQY*#%&3(iI-|9D%*}fj)vws>ECX$reCF1O>MvtpK0>xZODgJQ`hEJ@<@U@ud}VQcgG&8 zWL(~QH>x!1X#G&X`}vFbBYph8RAxjE($|FoVXr})j1A2JsETw>Y@yUUM!Tg}$16-5 ztFa235OUV*_hx(F9wKt|MQ@8e0Kr5qZ&l7Z&%|_uTHlG00pUQOC>`>QQvHRWXHHu1 zV7SblLUMXVPBgJarHR0pwZvTLD>g>Qek`kX!|ZYDq6cj93~wPXlSocYTal-xL)@Jp ze)jG*=-Q%$9pNqQ>tkBNPR`O}Xg|IkVl22FvLUx`rP$M3uRKK+er#@PWpBea%-(+iAXWUtXpGisK&d>M*wsnVb?TME!Hges zozHCEthGuVJbxx(tZ%^%v2m`a23W&fiNQD9Gj|1vb%t9`^omv+0*rIP)aLKe7N?2^W$QKey)?}T&$^35Jm)~C=)E>v&+ z(g~$rExAynbe4ge3bh3w?0en@60Zx!*wExx2<-`5BU5(8kDuiMzi6XZ1%FTfWZyww zi@QJ?d+pl4%r-UR$zYs5cn;waEwx~Ywp;i8)adAPecn zru4mY?SrW4i>Ya`z^9oXOEt?6c8m?~$lZfA^kZY6BH{<*mPmSaf-UA2Ide+vG>w+# zbMtRd)FCN)7M0I9TUp64UucY7veJWW3dJyit=UfaqWL)yz~|#TU`SI`5sB!Sx^{GZ zSxcz>6<#RYP8qe5d*1|HMaX@#EdM6hr&4S=*VfC~nU|r_+G}s^P&P!E1a?2^zc$~n zHI(MF!h+K~pn>&Pat~=L7|nOxsUmZAYbZ{FLAwKu8da_PlD5vGxjk{qYx+jyBM%jK zxP~Ayl?nLKj+EvDPhGr8--#-FZ@72?V<+jnXzNtqz+Q!kA@juxfQp;y^M_lFAIyCi zO)->#A8xfGhcg(G$*Hg+c|syz09pH*5@dvGJun0`Gzz=By6;rCw$8 z*9C6ClP{ov%!#D4%Cxnusd4JqI(SpLwsRMS`aLb}7L7zdhz?EEkJ5fLvu`4F(&EFfTny4q|GEoQPEnLavXQ=hQlNih1Cfniv zfd#66;85wZ2xj3NTm0O3XH-j!M!^f;iqlN1P#tW5Eo@`CS`_V=AS}VW1v#bwkyO$; z9zR%|9@&R@2t7U~DRBxAQP+@+;-W>)k-?(!TdH+s?l#3FbSzh?#J!=-a$+mu2AydN zjqd5`A;K&U0N<-lIBCa-X`|0*9uy&QJCrtjiwEL~3;dJ`x;j>F{(%mL11_)m`5Cv= z&#N_TS9p_KBZMtYQ*O$9LYNA@8EOWAuFIEWg+AYgv5gWh-%MYP`dOTa%@jMPI+`nb zXwo^yHAKtzYhXN*BkijNSev%>?dlD7^+qtlKfMjWo0oj@)2Z8HIT04H&bNOqPj`*} z(p0G<(P^~*Z>WH>56BasaqDUnDF9byCc0SmpVRxIg>?L7ce&^FU?*6vsJiFt*x!j z?7`4SR-w6~N1j%Tbg4T^3mL)Z^YoxQtI9VID%R5@vI=%?2fiLOGNM{k#YO7I-_-FM z0@HsR^L6lDNDr4hcxe1V$Nu1YuoeK)3%)5Lu=R0%q&@LunpGGGk}vIbxO2UH0a zLLBgMP~=?UXO)&EONbTj{eoikHPQ>9%0$}Lt?MirthQVX>c1=wAc|~EX{4-jb_6mV z-NYuU?|zM@X|sM<;tlzi)t4G$A3)HbBV zsKZ|?X2q1Chw_nrOf-g8gmJ&U41Htt#U99Nnt_d>t|+3<=5uFb6ob^#51}wpk}>t$ z8E>;CGh}E&LJR*g`Y_}?>^Q0)m^66-X~9fwPb|PGB&1bTS-UoA_1-=?S*7-(lZpKzo@Pu?%zC!)3^#MOK~u$q zh0#YTsi$Gaql@@1TsZtNekK6H@$Zly@YngUs1ate;Mm>^Acri{tv_Iie;WP>1=Wx<2+-gkOkoE3@_q6oPSK%Uf}o!q_-#8R9Bg z$_pOX`zIU1h~3xjIxAx|LDUcm(Sz8DC^OpfZTyb7prG{Be1dv1SRQlfFYXC|SH=0W7KH8mM%-^-WARq8JNXMm^f`sj*~xap1-|&NH^0q* zoY2Ew=#2?~>Vtv+<0#*9us|$9MpI|U{@B)WM6&8xVqaE)j2TJ-yZH-1mxhUL6dL_4 zt9zPE*DUAP#(P|EQ{73E-TNCg{UjY(J##exz&Fb`rn`mdo0CU|3S1*uUEGRp@ElLl zEPi0r&++jPOYThTo}zqQ#vXfs&Dk=cT5zi+)(`i&UashN@IiIv#Ca?DL+W0*_C;M} zFdE5L(4FQqpOE`Ro6v92Hzn~!M>C93+n!_!*&C{7aBE||0>=8Ns*zDu0CHE{jyTtRxym=j&Ep=}edHxHq3jDr4%eG~fwV(kekFG<~=E$3r1^H|if( zo+fpA*U@CAUe4VR|GS9e?-3jMAyT7@qS}EVQL*z*eakNi?WF z_?=GrhAz8irhnnLTiun9Drl0ReXy9QEhgz-YXrJ>@TErQveSnm^C+?hZfG{31Gkog zZm&yY-V5#M3JS%_&@G7Q7NRRDMObl{`NTDFf9t<%fzZX6^?npl+%C6cUrA>xLF7lG z-y;z%m2~~V{bg!d@@;J2E+GRnt~1s}5WYWRl62B1&fm6mAyvNM#GA?XJBwGDAL71a z@htO(sfSl@-*cQl{GM9h4HAuave-v=TNt)^EL+A4)(=v}EjO!I%QXaD{D0Z}ZM;tpWBp>vLTT`bmNQTj-5G_3-QAYN6A~T3e;gipY z9=|H#o)UmKM;lei3xKxCpIkXaefqJrM4(6eXM#(9+_=T%-Z(+@%%4p*c+(ki!RMO0 z65#r$N?pKK`dLhcrL@zzGUEufi7?|CnIH>}_mIQCBl+S7$3yMxo?j*+r`pAL15)2Zu zy1VpvaP>oD#$+e!SxCD;i9@oIRRo`7r*1as6-h}6V^T=GE%4W^-6n+;Ig4bpzOkA$ z8Y$@57^Ty~Clj5nHEFp`*=5(1M@A{?xc=6>WZz%$>+I#n+=*Zh>z2tp=8kz#fkFHj~U&FmA_Ysp$NR8`rra zDubL&d6dF3FLapPJRX#00L_Np9|1(!mEOQA%P44sZHDo9p~&6EeI-8k0;o_x$G=$6 z3Sc!G7;OBKdFjDyy~uQqO=*886GFJsNe2Qws_rQRrUp@@{Pr#@Bf2|VGA{8HazV2n zdEOjJVjXy2m%1rJ^`tbv9IzUC>)h{YJfKH_{%Nt9?S7=|M?q5hO6?{=q^tsn zpnRVj%$M+ZD}qDPIkY-fj!isCb{zmX$3@1mODge0xo#HS)){)2LgW7vfRug-#Qal6 zuIJvAU!M@}+X9Vs;ZY^&+yYqtepTxWJDfeg1irZe8yA@x z<4$0NksyhPe1H%qDi?W!59K$m1G2P(Bw}KXu2y!n(u+>yy~nFUMY4rObC4+~-sc%6 z8?(90yTj;ZzbVJ;#G}ghxcB+)-`8&(s$czg%D#H3T6r=9Y}|z>dj2vyr$+|DvLfGi zFSPKvVchAEDii3f_6qBIfcctjfPL^RRv69%mpT0>Zvbm%);Fj6Av^qpa6F#YQ4F*K zTbnZl&YTQw5~RrcI1>%s=?OYrr50tN3WpO!ra2JK*vr<0H-6R+jQOnT zUe?67BFVX)1S*v7254Q(#f_*U|B`_sSD@VCeSC}L*uTe=e$yvT<>V~=xubH)zWBOy z{f=Xy7L6joGJp&y2Vo?2L|GhW45yb{tqSH^5WTX4G< zC*y42N*?tVg}tdt(}T$9IpO&rh+zpBodOci#1X!a{vc*;e*!ME&DQVQ{K($NWF;f+ zVK}Y*#;Q;FZlrD)5)nWL#pwVyioALQ75;L>WYlb}YWg;O^r1l2W##(Pj#~ldsBb@R z0hTsl69tkdSQm-B^$Ur$W0k3JdawEOxqIr8!=z6K=GO{m?`^=BLiT{0{zHL_pim|* z7_1bWq);s5?~tSugZAe{?stE2Ip#Nj9gT+2Ex;Aqg7a=F6QjOQUC@};R-(chgExZZ zNsGs3%xXc-G$2u*rMW|u{OO$8Eo*TvXg)6YaixY2%3KD?*W{Dzc=(N?pZi|Dkk3YQ zYrUUgn$f#4d@D=(tw>7HKi%>=EPGPwCJgQ*#`jHz)z+X61{XP`rIHb{jL_dT#nK{i zCURZ?6h=c&4bk795GX*sHq-CDtHui~P6l(k&^Zgk8N&1MS&2T$vmSP3@7SzHOK9?nS)li)KeyLL};M_b{_S&^}h2R-guLD_-vM)=^EFd28PDLL%ZuANf zMD}*Ye&3d<_Af1J&Z+c}?M6;;6UP~V$t>rEWD-e45rFq|*exgdEjyzzqIJZ7A&6=< zw7e{=-Pxpjwp&?Ut;$k9PMow!EEU`G==1bR{GSvyV(5YRyq%yUU)`U#5v%s5B!#D4 zJJm)OR6{`bUPpyNS*Y!iUH^P-9AoH;4o?*=Hef0IdYz|6aMXKWZJ)=mvQTWSx%z7{ z9lQKqjBgT#*pRFHND`PLu`#wRWS)479=Mm;&c@iM>F9;s?*egg!)^D+)?SBZfp1OL zRdc!k@Fay#*L&1oKI)9PiD9(x$U({1-(d+LjM0C30npsd8JY+zl1Z*$$Z!x2iX6-F zMZ1T+NP& z<@;9kkatlQyxKK-Aj+fo>LHVM#(4@hWmo8(cZS5phicB7mb5^~oTq!Qy0 zo$AFRIgyTXKiNAC8cPW)YNyUV-(eO<%O8&-ULp;H1>q0U=fyu-Xod1rh7Df;mPSV8 z;he`?O)x**jGK)-8IaNSrsTg~MGumimU9TgmrgUF1j0n{3DZTTrlwGRx1u}ea9rol zXoX@xphBpuW#_*!(L>ux#-=G}PHVRdrB3iwAKH0wdJBPo#Yam0llNr0sns;k)bpVh_PL12WPDE;>& z&N~|suU@sbHu;_CmAXSFZF4RIbHbZGi+hct8ouNfJN=KNv%h6B%6hrA;w`8SZZeuj zRd7_1Z{P-dS8Td|Lw~nC6CsHg>`_C^j;%4x@Izzebh9ehESopSX6%KB1N|BvrXCS{ z4^pVu?U=&m?->!zyq+DS&)t6nM>KW$?2bx4+~0@_Rw&~tJTLwUo*I>31S48Tb063- zOn88&huJHE9~c@4QVX>={0kIXG9^i9Lz&wN_+9MX9ajuZ_7^LT+kZv`)H>mqOB_}M z37R~&p~jg%Hq(e3VumwlEgR<5$Ec%c_B;)uRx@}N?RjO7LdkQmi;AgF9= z5|hk3qVq!jLhmN*+3O0$!Y}vDu?lJ`qgX4 zPwE-X3TOwYlAGhS7dmken8cd)#-VrU^~@0qE6PA~t~tzFWOD7AKTc>);!=W#T9x%s zKbvuKi%8zEJ3o&X0MH+BKl4+h?=*44%Dl`AKq}a=@E)-p+rTb_P^XZt>sM|cJX%n+ zx$>}kmC(=6M@LsaC(%nr>_q5FbE0Xh>Z*JVXKCKZuEBAq=a9rRRS;D|4P$jFY$Y$) z&Cgww&EfDy$RqC8q%&US>V|P)O{5(8`y>Ra_h`G96yaO^TV?YLWEdNVk)KoHQ#>z# zs{`*gUQh5!Y0myl(Q#IV1$>i=P+`f`Ac-#W@#2^&Ls~q-<502rxa!KUi9WEU-(V+D zqurM>05j=$+)Jno7khwWlc2au!g7?8NB-Yx?pbD*W0C#Da)&@GOOG87S4W9>$zxeY z-5Fzr%K+1LLBE98=Nk=yjms4srm#INCbiTJ2tK%4B+Q8Wy2H7MvC#E%qdYlV?-Z#B zQcTC3bS|%dtr}?~pQc$*=V+I#IO|?2h9hS|V=NWVhdA^L!(x%y!Vr;eqc8$XfdLFj zHU)+C5>nE`^ym6sBHLV?1bvxnd&7OkHkd78t)nFay2B@8QCy(=zq!=k$r{+OWIKQ$ zJA{PlW}+O-SsAcFGF3okb)#=7O)#2g(@(t};h9(5zET~=!N{U0tCsfT=i5TL(?@vB z&{dJBu={f(>4XeTv+PC&MmOSF-0i6y$>QRsGb`@VooQC`XUis#2r~bO4Hvj*4a_iH z&=X5C4~8N^xgjRvrMtdvRzba{)l<38BUAH5V@h*g$#S%Qx^k(ELvbte9U}mIG9y6p%*x3=h8myz$^BT9;$a234FnMQ=U#T?Lk{c?UYtfR8I>#Qwq# zv0bAPvA^&Sr_4TelpIFu5gdct*k9H4iI-bK3 zldF+x50q${po77~OxX`thU~P!+ugRN;6?xJQiq^{~doi2d z_URhLuWWBIfzj%zvxu?z_ z+5XzJ_L6#t>TZk{(cchPaNq6d(=w5a$)erO73+rI@*MR#TDv}SD}8P7=@6EGtTCBo z8!D~PkS}$1CsdDMeS<4%lGyzylQm*2tV(r0>)7LmBVOS}t*tCAGj(OD?&km_dZ_BR zyvLK){WxGuDYi&|45g2>vJfe^?^ub(D4*C6?)vh&z*{3a!Ptmm4;W%mowa&p10{G{ zE4%Tj=fqnbnV6~ufBX5l zZUf!NhsLMpfU`=hzJ`Wtvh0TX<)3?+EA2UCZeL+$0h65U=W9bQyoR`WHJR z%STH|`q(d;nW`Jc9IIikCS5&ja|d;Tq@CfraURw~HfS{)M-;`LC|4k&R)%3U)&E=$ za}moXQzn&^-fWzW8hidOgqhwK;9V)L^jps(&1YAAyDTzfe_R*5Nm}JVXe;yPxA_vg z6@&)RaNJA{;Nd;L8l&F|pX)ZYsh^~z5ChZs8IAC%{fg?7W6ItRrT&7L1};p=w;bZM z@Jjts;xLg{UcE(1O8uNTcsnKkO`|pVy30^vl0{!+V3K_c_}F7zbzV}}E=u>iKKP>B z3uZfeOh=PQZ?)}u9{dhQTww3_VEDCR>T-ZwIhvtsRk|&VHD@sFuN$cI*vP#)u7J~G zw592fEu~I0`>oYuetFoWG@&CMyKbB?ih2?VTNOZ--7nKbvfp^0dMW70QNBK1nKWxC zH4Bvs{|SK}%V;B|uh)nVMQqW+$PFK4lNmv~avn&#i%nyc?cS9Qv)>r5YShb9S%_J{ z;25n>l4#XpSDsizHBCYF!hSI<)w>Mj6tR1|$T9uvmlaE`yVHzq@^SPHuwBJ?-i$vi zf=rpb(cI~oDEi5|yh`B(RD$&N!3$r1s-_UWca!D8*qf^t&TjS$AT${w8*Q=gbf)Vs zb1@zgs+M7m>Of}2PRHl%V`DRDPBZa#ay;6N?&>2717oZ;a>CiA0!iZc$M!VfWpG!fF;e+k6f6IPO+~JxUz(<7sGw zt`sQB3iW$$q9y1qF$~AwRa0N4<(YX*d9bb0Ul^ypVDpu)?9FNY_VWT}4G029ZgkD^ zJ$&Tf7{f7!Q_PI!j(4pSSw7$7IB$r*?#Sr*6bpyw$};8_P`j`X(!(&2%bNgOi6$W6 z!_$Q3QkWPl`F+bUxOOH zax%neA*FCfW(Ay8)PTN^#&CqI+ot&Hq;ckn%no?YMlsao=$!(OKuTHv+#l_F3qz_5 z0GY};YAzVfuVk}@QdmNtXI8(~1lO3fiM6oIN``hDZ-Axhs}htG<~gR_<-(+CD7D5!0 zm@8&i{XxSZ$BT};%Rb7MCGV@Cf@S^H#lDkw+l$&#xGuO9INbZkM#^7n7gr>qWCFJt z6mA%#Xmst)-KBEC+7Y6Vy#8_|47~(;nEVk4wBK>F8>-o46l2)ds4RQFL!!WtDI1Qy z(J30R^6W2URpsqbAe52Q@-F{@U2Ha(84~S#F;-L|`WDep0%UZoVM#=)Q4KLv2^%j!J@9k`?x@OSbjso9Mz3C7}vB!MAP|E7|LHx zsk{Kr`zlBO{dQHD5*H+RcxYH;I$4Xhg!X4}Z9}c0y%3G#dIks)(|mPprnxE`Gi(D7 zn}@+U3Vhwj$tXoQ#-?i|+Yga@_cxOCLs4G_mWeVYqs5em zGTR$w1nXY_yige*cKY;VykIoZXtYDHy~oI(SSY+Xw5Z>)-Vl86<3=NL{bp=m>o>hV zM1GE%>b&b(IFvG|7WX-I2tyOa&7lyU*~&FJ_^8nEuC^3jZ-5SB zdgae$w%eO_vlRa&4zPrw7igJ75;#wIClaCqgbrhVT-nkrUHg4{`YF`|+5g=RGM|Q6 z4A01WSW|5rDh`p`9#`hrKw(64Z!&Q&#eY^gPFX+bq&W%-@_a1+(zM%_8gMKsr>4L6 zGwUbupa)Vl9N?#$@2$U32ip1sCFeO8y?C8^Mynl*v+}HLYN$ zU5cn?yU|{Xr@?81=;B?)e#UISMq*6o`V}*+Y3zU8u(^K}z>XZ1-#-wa4(b;D463=C z9uyhuQ2`#nBbIJ$7L9)tH>9AdP}xVziM*9O)O{W*eHX2IObP{tsXufem@n1JNsm?d z9@zSN@0;1b0KVuxvT9A0OKy%X`_r197GJA2W5ye+61R>Q{7F~za81H|YZhD@G!Ebb z-0RF{U<-NF!{{ez8tGeDQ0RqkoSb~<0>v`yr+cHa_wCW19*B4rmQXfV@v^Q__*GV9 zOO{Hud>ay-OHHvt-qZ4H==ZbBeYTD%&{4%Pq;q8rSett0KMBW{2FPaJ^q0)?ZDIZi z%-=U&-8gz2!)Q94&En{Zjv6X@ig)|Y<@jqb30(hVu^pRThWwSE0L z#34AHM`rUE45vv2F93QNMKJog$dwO8HpECuk!f1{*-K0BVH-EkdEWJu=ujaQ9Q{Vx{twg|W z>A~N;I9wPL#|r@6%J=mE$TrpUV9dq8PJGNOK=ovYb9kw6;5&BGCMFA=k3_+ayP zEDnU~GTfP-^<23TpG0x_ne3ReF?8z{64WIKFuijl0N&d{s>ti=G602k8I^YC+(3Gh zgbf)&Kxx3|FCq8SdF_N62%8D&GBiIFS0k9;s=pTf7d2kr;2>0&KzWS_xe?3&zOdKi czs!HJ;I&}|1LkbRAQ{3A=G+L0fR}~;3&Os{FaQ7m literal 0 HcmV?d00001 diff --git a/testapp/Makefile b/testapp/Makefile new file mode 100644 index 0000000..284f077 --- /dev/null +++ b/testapp/Makefile @@ -0,0 +1,14 @@ +# +# Makefile +# + +APP = lcd2usb + +all: $(APP) + +clean: + rm -f $(APP) + +$(APP): $(APP).c + $(CC) -Wall -o $@ $(APP).c -lusb + diff --git a/testapp/Makefile.cygwin b/testapp/Makefile.cygwin new file mode 100644 index 0000000..85e0379 --- /dev/null +++ b/testapp/Makefile.cygwin @@ -0,0 +1,15 @@ +# +# Makefile.xmingw +# + +APP = lcd2usb + +all: $(APP).exe + +clean: + rm -f $(APP).exe + +$(APP).exe: $(APP).c + $(CC) -Wall -DWIN -o $@ $(APP).c -lusb + + diff --git a/testapp/Makefile.macos b/testapp/Makefile.macos new file mode 100644 index 0000000..ce99501 --- /dev/null +++ b/testapp/Makefile.macos @@ -0,0 +1,14 @@ +# +# Makefile +# + +APP = lcd2usb + +all: $(APP) + +clean: + rm -f $(APP) + +$(APP): $(APP).c + $(CC) -Wall -I/sw/include -o $@ $(APP).c -L/sw/lib -lusb + diff --git a/testapp/Makefile.mingw b/testapp/Makefile.mingw new file mode 100644 index 0000000..ee89d98 --- /dev/null +++ b/testapp/Makefile.mingw @@ -0,0 +1,15 @@ +# +# Makefile.xmingw +# + +APP = lcd2usb + +all: $(APP).exe + +clean: + rm -f $(APP).exe + +$(APP).exe: $(APP).c + $(CC) -Wall -mno-cygwin -DWIN -o $@ $(APP).c -lusb + + diff --git a/testapp/Makefile.xmingw b/testapp/Makefile.xmingw new file mode 100644 index 0000000..970b63f --- /dev/null +++ b/testapp/Makefile.xmingw @@ -0,0 +1,19 @@ +# +# Makefile.xmingw +# + +XMINGW_ROOT = /usr/local/cross-tools/bin + +CC = $(XMINGW_ROOT)/i386-mingw32msvc-gcc + +APP = lcd2usb + +all: $(APP).exe + +clean: + rm -f $(APP).exe + +$(APP).exe: $(APP).c + $(CC) -Wall -DWIN -o $@ $(APP).c -lusb + + diff --git a/testapp/lcd2usb.c b/testapp/lcd2usb.c new file mode 100644 index 0000000..c9ae9ef --- /dev/null +++ b/testapp/lcd2usb.c @@ -0,0 +1,342 @@ +/* + * lcd2usb.c - test application for the lcd2usb interface + * http://www.harbaum.org/till/lcd2usb + */ + +#include +#include +#include +#include + +/* vendor and product id */ +#define LCD2USB_VID 0x0403 +#define LCD2USB_PID 0xc630 + +/* target is a bit map for CMD/DATA */ +#define LCD_CTRL_0 (1<<3) +#define LCD_CTRL_1 (1<<4) +#define LCD_BOTH (LCD_CTRL_0 | LCD_CTRL_1) + +#define LCD_ECHO (0<<5) +#define LCD_CMD (1<<5) +#define LCD_DATA (2<<5) +#define LCD_SET (3<<5) +#define LCD_GET (4<<5) + +/* target is value to set */ +#define LCD_SET_CONTRAST (LCD_SET | (0<<3)) +#define LCD_SET_BRIGHTNESS (LCD_SET | (1<<3)) +#define LCD_SET_RESERVED0 (LCD_SET | (2<<3)) +#define LCD_SET_RESERVED1 (LCD_SET | (3<<3)) + +/* target is value to get */ +#define LCD_GET_FWVER (LCD_GET | (0<<3)) +#define LCD_GET_KEYS (LCD_GET | (1<<3)) +#define LCD_GET_CTRL (LCD_GET | (2<<3)) +#define LCD_GET_RESERVED1 (LCD_GET | (3<<3)) + +#ifdef WIN +#include +#include +#define MSLEEP(a) Sleep(a) +#else +#define MSLEEP(a) usleep(a*1000) +#endif + +const char msg[] = + " " + "The quick brown fox jumps over the lazy dogs back ..." + " "; + +usb_dev_handle *handle = NULL; + +int lcd_send(int request, int value, int index) { + if(usb_control_msg(handle, USB_TYPE_VENDOR, request, + value, index, NULL, 0, 1000) < 0) { + fprintf(stderr, "USB request failed!"); + return -1; + } + return 0; +} + +/* to increase performance, a little buffer is being used to */ +/* collect command bytes of the same type before transmitting them */ +#define BUFFER_MAX_CMD 4 /* current protocol supports up to 4 bytes */ +int buffer_current_type = -1; /* nothing in buffer yet */ +int buffer_current_fill = 0; /* -"- */ +unsigned char buffer[BUFFER_MAX_CMD]; + +/* command format: + * 7 6 5 4 3 2 1 0 + * C C C T T R L L + * + * TT = target bit map + * R = reserved for future use, set to 0 + * LL = number of bytes in transfer - 1 + */ + +/* flush command queue due to buffer overflow / content */ +/* change or due to explicit request */ +void lcd_flush(void) { + int request, value, index; + + /* anything to flush? ignore request if not */ + if (buffer_current_type == -1) + return; + + /* build request byte */ + request = buffer_current_type | (buffer_current_fill - 1); + + /* fill value and index with buffer contents. endianess should IMHO not */ + /* be a problem, since usb_control_msg() will handle this. */ + value = buffer[0] | (buffer[1] << 8); + index = buffer[2] | (buffer[3] << 8); + + /* send current buffer contents */ + lcd_send(request, value, index); + + /* buffer is now free again */ + buffer_current_type = -1; + buffer_current_fill = 0; +} + +/* enqueue a command into the buffer */ +void lcd_enqueue(int command_type, int value) { + if ((buffer_current_type >= 0) && (buffer_current_type != command_type)) + lcd_flush(); + + /* add new item to buffer */ + buffer_current_type = command_type; + buffer[buffer_current_fill++] = value; + + /* flush buffer if it's full */ + if (buffer_current_fill == BUFFER_MAX_CMD) + lcd_flush(); +} + +/* see HD44780 datasheet for a command description */ +void lcd_command(const unsigned char ctrl, const unsigned char cmd) { + lcd_enqueue(LCD_CMD | ctrl, cmd); +} + +/* clear display */ +void lcd_clear(void) { + lcd_command(LCD_BOTH, 0x01); /* clear display */ + lcd_command(LCD_BOTH, 0x03); /* return home */ +} + +/* home display */ +void lcd_home(void) { + lcd_command(LCD_BOTH, 0x03); /* return home */ +} + +/* write a data string to the first display */ +void lcd_write(const char *data) { + int ctrl = LCD_CTRL_0; + + while(*data) + lcd_enqueue(LCD_DATA | ctrl, *data++); + + lcd_flush(); +} + +/* send a number of 16 bit words to the lcd2usb interface */ +/* and verify that they are correctly returned by the echo */ +/* command. This may be used to check the reliability of */ +/* the usb interfacing */ +#define ECHO_NUM 100 +void lcd_echo(void) { + + int i, nBytes, errors=0; + unsigned short val, ret; + + for(i=0;i>8); +} + +/* get the bit mask of installed LCD controllers (0 = no */ +/* lcd found, 1 = single controller display, 3 = dual */ +/* controller display */ +void lcd_get_controller(void) { + int ctrl = lcd_get(LCD_GET_CTRL); + + if(ctrl != -1) { + if(ctrl) + printf("Installed controllers: %s%s\n", + (ctrl&1)?"CTRL0":"", + (ctrl&2)?" CTRL1":""); + else + printf("No controllers installed!\n"); + } +} + +/* get state of the two optional buttons */ +void lcd_get_keys(void) { + int keymask = lcd_get(LCD_GET_KEYS); + + if(keymask != -1) + printf("Keys: 0:%s 1:%s\n", + (keymask&1)?"on":"off", + (keymask&2)?"on":"off"); +} + +/* set a value in the LCD interface */ +void lcd_set(unsigned char cmd, int value) { + if(usb_control_msg(handle, + USB_TYPE_VENDOR, cmd, value, 0, + NULL, 0, 1000) < 0) { + fprintf(stderr, "USB request failed!"); + } +} + +/* set contrast to a value between 0 and 255. Result depends */ +/* display type */ +void lcd_set_contrast(int value) { + lcd_set(LCD_SET_CONTRAST, value); +} + +/* set backlight brightness to a value between 0 (off) anf 255 */ +void lcd_set_brightness(int value) { + lcd_set(LCD_SET_BRIGHTNESS, value); +} + +int main(int argc, char *argv[]) { + struct usb_bus *bus; + struct usb_device *dev; + int i; + + printf("-- LCD2USB test application --\n"); + printf("-- (c) 2006 by Till Harbaum --\n"); + printf("-- http://www.harbaum.org/till/lcd2usb --\n"); + + usb_init(); + + usb_find_busses(); + usb_find_devices(); + + for(bus = usb_get_busses(); bus; bus = bus->next) { + for(dev = bus->devices; dev; dev = dev->next) { + if((dev->descriptor.idVendor == LCD2USB_VID) && + (dev->descriptor.idProduct == LCD2USB_PID)) { + + printf("Found LCD2USB device on bus %s device %s.\n", + bus->dirname, dev->filename); + + /* open device */ + if(!(handle = usb_open(dev))) + fprintf(stderr, "Error: Cannot open USB device: %s\n", + usb_strerror()); + + break; + } + } + } + + if(!handle) { + fprintf(stderr, "Error: Could not find LCD2USB device\n"); + +#ifdef WIN + printf("Press return to quit\n"); + getchar(); +#endif + + exit(-1); + } + + /* make lcd interface return some bytes to */ + /* test transfer reliability */ + lcd_echo(); + + /* read some values from adaptor */ + lcd_get_version(); + lcd_get_controller(); + lcd_get_keys(); + + /* adjust contrast and brightess */ + lcd_set_contrast(200); + lcd_set_brightness(255); + + /* clear display */ + lcd_clear(); + + /* write something on the screen */ + for(i=0;i=0;i--) { + lcd_set_brightness(i); + MSLEEP(10); + } + + lcd_clear(); + lcd_write("Bye bye!!!"); + + for(i=0;i<=255;i++) { + lcd_set_brightness(i); + MSLEEP(10); + } + + usb_close(handle); + +#ifdef WIN + printf("Press return to quit\n"); + getchar(); +#endif + + return 0; +} diff --git a/testapp/lcd2usb.exe b/testapp/lcd2usb.exe new file mode 100755 index 0000000000000000000000000000000000000000..f485ddfb3a5ae4b9388c23afb32c6dc77111a07a GIT binary patch literal 23490 zcmeHP3v?V;dA@o$Q5+E~Uqz6uMn{cu@a!(CMH7bax z-+v!7vpasu=FuMJoZ0#BcmMnU|NZZOA9H7ByKb9c6^yY;oO5%G9l@23R{neTpAlqV z^{%I`Vvk?(^712Poi8u%O{Pq3IF}vBMTfLlG?U3%TEC&?@)<3a(b~86XhYe!QTvv+ zELAVJ~>u4oD(~9;3D=ffI z1Shq_J8-&=@+!8G^O;ue@g>OEj+10*I9&(vxstype}_EKH};d!6DxW~pPx=vUfs$H z)riN@=VuF#yoIhcFN9~wSY#gv&qfX{)>>KQKzJsStOS*0_$mAu=hViREJbSHcNg7v z4+zDe8aYJ9MhY)hF*bIz@OPYRx~D*Lxesb?>G7W$4_EnrIF3T= z{}g>-*EQ=8;9}ms9-Uy)TK2}Dqh<$ovh@#AGQ9pFy0pDP^_@Wd2HD`1g|t*ZQ>uWE43;6I2N_cznAkUI^}+=LzjA8RGiBVpRJf{8=M;Vy2`mHl2Lju7%34sk95gRE zRRcNIww$WDV+V}F*ekbxaO}jL&sCC*yiQf%7%V$9+uF+Jjuozcb8c?zgn#nRqec1U zD*vayqWn9LPG}`ZZ_?22%BNyGwEkRnS4K-@cWZiK(5N_F1 zWXs38s`ppd%yAi`>q$~&enFuYye}Q){#uGM<9*fp!*l!l-h@LIJsEy8^0Dw-wYKQV zW8H-ZggGy{+nIuCY2g`>L$OtXdk*%5XRFZ|HKOFy55QaaFe2`yqZ6e^xVw96ceA!Ku4VI|W+IjvW#7fEZeJ3b$iMQhL-lLwJixL+W4Y*2fmF>O0%VIVAh zGCUV?+c}FlnD+x^=k;DYZxEtIXL!fhsYOpxh=+eQ_Uzb;&mONTdv5I5R0Znr($P(+ z+|aIQ&d|_@%~UpnR;XPWU#R-zQnGdgPAYsrG$|Y!o*msgJ7;M;{%4<^siN>-iB%(u zB!96475ftRWX(%QwYJ{wPCsLGsb?J-tR~Xv@megKv2t0EITHb3t~3|2Em=2;b)w`& zE5l9^e`L!9+43?X3eDiyayu+yR#;dxdb}LtV%3pbuW4mdmrWe`Ag*NM=ux-0 zAXN}Pt(kfobdi>O34EP98r8^VST>PhHyL|iZhiAgQ}g4e*hl-xuEtWkHo7fZc;vdb z!=ftaII z$l&(E!>YF{eRf{5aJQXjy@wrm`n{+uTeC(C?wxJz0UFgU>YmZz;dCk%wJ4Irv1SeW z>FEwtepPI>7O1ap()#yky{U9s+Z@gHNApAHQ9fx|!_9SdyLRoWO^QOb+1x;#1u1pu zSUiw7`?WLb-;~W~;+nEPZtP6O3=L-Y=S{?1vTKe4(7N!e7$Q$LZ%D{HRXF@|V5w1e$pQJ!gEP zigNn+xCk8UA;M=8_Z(S_jEc&9Mx?Gms{R}K?L6#fMko2uK$qk+sr>}Ek<6k=v#=1{ zyc>UxX86(d^vm+gQMm9r7DQu{k!0{%_ZVu3@>4Y^K3)TR-q?Y_M7)xXNYB2}Celh) z3v~gjNXBy8hUBM^Q79AX!cVy|(}Qz`9}BYzpZ%Y?xx%Sm;AihI@l!KPgU)pFMO41< zHJ;!Orh%{UEs-ufID=_FJPn99#$qf{3ik_nW0MCWKV8>1ohzT(j4BS+JVm)<$0{&a z90(ta6mAuK-v}RP1ru_hjN>2WH0c_Q7w+Xu)tGXoJ~MV|0=h^)%{zO`r&e&!PDcti z*yar`ENqoUx~9c^{9iv86*)}Rzg`HJHs7m(|VRwDHa3l)y~@4@c? zRihzhy^|-#vBc%Xfk@@p5}v)glI35e6|EZA7WW(qU59cr zbNOZd$AA|*(Poza`Pk8YKeXO5F<$v;VxK#9Qyxpc>Ez?f;I>y$ zkMTPTB$m%ji+e`bYcPi8yIxp81TE-oHP(gci{*7%@`YqND6h-pb%ngHl2@O+YVx{NUSE@Pj>~I7T+!WNCH9QOmFV9e|F=D$ z+EQKHseAnX_`diwcfz(HZ5o!2<+pC_88)ciJDDCcppEFqn4Z91 zOC}5YE1+rro$x0>4`YRCfa~9wp33%P1}h^`f@48>6g$*H#@osTb$vOCq%u|l70$qqT_A2x4X(H09AR`9##olq%MelG zQ1#l!@h*-(!|5#^o*Ce(j(!9^(Fec6SVGdDS;v^tOWP`+0Y1VSJ#xOv@%y;}-{G{d zr<0uS;`CllM>tJSZbsOxoc=tgZ{zgSoQ`t(dz_AQdWzFKI9+)amE}V^ zPb)jGOjiB);?Motv@(_K=21vx74@z18ZAYI-425RdNaD^2O zwh>B~r*Pv16fUy1$tmb}X?4h!dPlp9l9lGNJl3prggSz#DlUH($ug7KoMn3=B#MVt zx2$OhtZfRl&@ZYkxIEg{3HEi=98Hal4UOOwuC-gtUoS1HhfIGUB$~~Z`n~IA% z!p~&ey4B3WgOx;Tpf-82eQ^L!;8JlTmcDpVwY7DrOe~#`8+DgXsHkThjYD<2hxm8| zORb@cH`gs$j&PS&Xl&2Gu2kmI${dKAmsTJ-783Ce7u~34b9yXmT4r3Q{i-C_HRh5?|Lu_)tD=>2#AOQ49n&-0z@Gyzj+R zI}w?RbDivdj-_<_%MHb-U_`pNwuO6owsz|ss8Msh&jkbl_+3CGyrs9Jud6xW#Zaob z!3E#c)ExA+u$(b~`_`x_9D||8*s@jc4&T@VMH_I1_;$Jkd~I}T@NJ|^(6^yoa5egF z7DSV;r-QQA`r7$5C-Q@7)@qWV7E-sh)7#)-7CU zvp?Y5)VXy-uVilUZRk`5gTBs=F2eP;&J8_1;htuHBWgiyt<$ao_ZkL7(;wKC&BaaW zWA60~>Z$-S>I3ljF2bt=SK4LYQBS)7XVepz#$b25Q|J8ct-QL$;bg zfX@sqY*R;PSkwhgC#+_P;jAelLJTAIz9tMK7Z}3k9=8S?I3yj^NHF$f={;h|LZF4nOIRAzM=dLt>ZgVe%8tkV8^bEvLc^0% z6>>Zy%HQZx86xm_#;#n-DImg+3_*yJ6)>GI6J$7nUcEl5?iX>7u&xCb1i*%P4Ah6} zu}HTqPBjIU(KJ#7LZM&3(G> z1RAJc8MkchXeVW~QoXr@Q+}T$urA#!pa!2Lg1$(PfEuxao+mz7kBP29gR;E4ua$tkJR=F04V+z5&(EhxpwKI`z4=C< z4d8OdTYrlv55{&c;~BSd=aW%OPlr(uTk`BpywNjIhDVit>;{({l`>5aGVquJ2R6a^ z;UFt*L}L{MpXR`$6;_G7G6o)=--F**BvQ^1Qa)oN>Psog0tm_U=Hc~}v=8-_6agfo zq72*RC5QS#ieS=wIt!IIx{)uuAzvmfaR_;XtRQfBIGcTDj4OIdJ2eEgnS*y5gXA_F?z9JWP!WXKY?d4 zD&)vH4&-1FG7Thzr;vh&%fYJhpp77#*LS)ISqu-xn~E|#6e~H-tCi)qcNU6M!&ETwRosfT!|*D#t&KFcgP{ls(if6N zNYmXgMj}%3-5$vgcqDK4NdCS@@=1^6`#h5OdnDiCk$lV}`8AK^2RxETJd%4ol3(;l ze%>SbA&=y{J(43H$&sO2E44=UueBc%Ku6^|%o zAEd}HKF+HTN}CfXYTKNk)mgF8Bwg8au{JM-EI1A0#>Lr8BfGE}Pd{lSD>j*r1!uEa zAFgeH2(}C-w}%pJ71~_G)j{Zu10hE{;|xNPQs8Y09;_F1KC<3`C-ueSs;!b+ z0lDi?jo3EquV5z=(R;gNHS z?Tri49`b0faU}C^!B+(D^JuR`rKCLQ#%S&B3rbS#v0KRz$*+dbMtj%3;HU-W1n_SC&FFYR}Dv&kFYWCf?eunHal21=w6E}JpP85TPLK8#9_FsOTI&vLOs{*lROGI}VDBwDh^w0unXWU3w$$SPcF}lVUIc{jG7LZqZcp~a_ zJo0~Rs4S{>`du0^k^~kbpVy*{DB^Ywc}L%P5|H4b-{M2^1ml3u$RqvJa2Efl_2F-@ z?!m)nvsw73@dns@#(D{!wY1kHc&dw?gOsOU7c?eRD#>ak-1wTZSs}q~rAX6mWwWh) zm5Qhf(oW&P>!oxx9xv4u>@7u_k{<2#^U_}B(OxLk6}+PqX?obvE~Bmu$hmr@Qw!BA zk2{iOuMDYLKwjx_se2{K7ZG*lUil-Nhd7H5)hi=_g`CsyNdMe=7XPT|{SDSVxczK4 z%U*fn+&pWmRs59IfV=pR{t2uC%>83Wc&igXLRawdQl8)|rATAEwA9)Or5*bT;zKfV z|3y0tbli>-YE3JU9YDm+q~gf~p@Z@T&wW5zWgH6RK_KlosTKlx6e%@|3gjpdHAZ27 zLwsDu#5zIg`T=<8kI(2!WKrrQ5OtR=kT;2kX)Yc$2RfyKV2yy!v8NM=*cVm0?f{}z z7eX?9u`~nOPAS?Cruo!CXs>Qt5%MsQ%{HQo?*Q=?oTvdZaeNsUwU;Z9uZatv>jX*P zLiO5msMM=K#66?3`9F!Z$Uh6v!WIU6u}4IuYJfasBk}`0`x%GObv<~*y)a3p*L?6_ zJyh6b5AAl;7uoZEASzaAhYBCp={hgvc>ZSa(BU8nASw=p_B}w<+6HpuXN2NDMb-3v z@X)B^c>Ysda;r=7V?fl(Tu6R`c#8b$K@Ul5A@SBYOx4u?ZgftTirU!|~x`#ABDDmze0YQn4?gw9|8~;<1Ik!_(|i zr0bu7s67y2;ZJ~&7o~Rj!Ru1)XC?Vf@N^c*St9oboqD|+h`Q4hlKnuYA)6EkWD}4T zMRNLp953P-1oB!D@+Ux0NLlC#GD3yq&x3~!$DSiVs25Pa;5iCJ>}F^Zc^QbhM-x0h zlyV%KPXZB7SX3$eQ71RZ;aMa$S}3YeIS#!0X@dI+UYwe9nV^NtZ2^44+A46Lw(FGNA+B55U=XtF@c-&)>Nje z1fnOhCN(jCrkY6S&7>fW4E{AQZ-@kJ8lo?(Ia3U;-{%BLZzu_hzdR>M`d2kU(bv)P zkG>oLZ&u5H<8rVa_^&IGqIU&3N7S?&q(6suFRToG#m?W{Pes#sGY|G)WY6mK)G3~n?$7PU#{DXD%aXPP{>(g}U0KSe<&TxOwuQ2)`U(zI#f5`4i%a-HwvpBF*$^R%;Pt!drg15=xIK0#=V~{-N z;;>tY+bRcQN04er?vdz#!QWSQoX!Ueim4d=g@TTN9LNkAcyk&`$aMQ_e?9E{2Llfh z9&%#Rp&st~pM|1VbfA|a*7=hKT_+c-g6P-sj}=@^;V3N;C6-NkET7Afjr0~3kjGxJ3uSMj!uW@W({>s4mkrW1`(GbQ+T9)HcEGs*dI9`)*i-l9Ot6lI zawWUOgPa9UrPYGsDQyAHbFRKDs!reD8SVhm@gZQ`$njUzO&$)^5;O!s8`_JWCM&&i zvT$N*hmp$|X}ldD6+u#5S8kTP`BBm9)ZZ1vGP1q4iHgyGc<@LQ0!yNZcQMyrUhrs@ TT^+r{F;Vr8lGs7Jr`i7kauna@ literal 0 HcmV?d00001 diff --git a/testapp/readme.txt b/testapp/readme.txt new file mode 100644 index 0000000..fee2cc0 --- /dev/null +++ b/testapp/readme.txt @@ -0,0 +1,41 @@ +lcd2usb test application - http://www.harbaum.org/till/lcd2usb +---------------------------------------------------------------- + +This simple test application is meant to demonstrate libusb +interfacing to the lcd2usb interface. + +This is no useful application, if you are only interesting in +using the lcd2usb interface please check out the latest version +of lcd4linux. + +Linux +----- + +This demo application has been developed under and for linux. Just +make sure you have libusb installed. To use this program just +compile by typing "make" and run the resulting lcd2usb. + +Windows +------- + +This program can be compiled for windows. This has been tested +under Linux using xmingw and the windows port of libusb +(see http://libusb-win32.sourceforge.net). To install the +driver plug the device in and install the driver from +the win directory. Then run testapp/lcd2usb.exe + +This program may also be compiled under windows using cygwin or +mingw (which is part of cygwin). In order to use cygwin simply +copy usb.h win32-linusb to /cygwin/usr/include and libusb.a to +/cygwin/lib and do a "make -f Makefile.cygwin". Don't forget to +distribute /cygwin/bin/cygwin1.dll with your file to allow it to +run in non-cygwin environments as well. No dll is required when using +mingw. In that case copy usb.h to /cygwin/usr/include/mingw and +libusb.a to /cygwin/lib/mingw. Finally do a "make -f Makefile.mingw". + +MacOS X +------- + +The program can be compiled under MacOS as well. The fink version +of linusb has to be installed and a simple "make -f Makefile.macos" +will build the native MacOS X version. diff --git a/win/lcd2usb.inf b/win/lcd2usb.inf new file mode 100755 index 0000000..a521b32 --- /dev/null +++ b/win/lcd2usb.inf @@ -0,0 +1,91 @@ +[Version] +Signature = "$Chicago$" +provider = %manufacturer% +DriverVer = 03/09/2005,0.1.10.1 +CatalogFile = lcd2usb.cat + +Class = LibUsbDevices +ClassGUID = {EB781AAF-9C70-4523-A5DF-642A87ECA567} + +[ClassInstall] +AddReg=ClassInstall.AddReg + +[ClassInstall32] +AddReg=ClassInstall.AddReg + +[ClassInstall.AddReg] +HKR,,,,"LibUSB-Win32 Devices" +HKR,,Icon,,"-20" + +[Manufacturer] +%manufacturer%=Devices + +;-------------------------------------------------------------------------- +; Files +;-------------------------------------------------------------------------- + +[SourceDisksNames] +1 = "Libusb-Win32 Driver Installation Disk",, + +[SourceDisksFiles] +libusb0.sys = 1,, +libusb0.dll = 1,, + +[DestinationDirs] +LIBUSB.Files.Sys = 10,System32\Drivers +LIBUSB.Files.Dll = 10,System32 + +[LIBUSB.Files.Sys] +libusb0.sys + +[LIBUSB.Files.Dll] +libusb0.dll + +;-------------------------------------------------------------------------- +; Device driver +;-------------------------------------------------------------------------- + +[LIBUSB_DEV] +CopyFiles = LIBUSB.Files.Sys, LIBUSB.Files.Dll +AddReg = LIBUSB_DEV.AddReg + +[LIBUSB_DEV.NT] +CopyFiles = LIBUSB.Files.Sys, LIBUSB.Files.Dll + +[LIBUSB_DEV.HW] +DelReg = LIBUSB_DEV.DelReg.HW + +[LIBUSB_DEV.NT.HW] +DelReg = LIBUSB_DEV.DelReg.HW + +[LIBUSB_DEV.NT.Services] +AddService = libusb0, 0x00000002, LIBUSB.AddService + +[LIBUSB_DEV.AddReg] +HKR,,DevLoader,,*ntkern +HKR,,NTMPDriver,,libusb0.sys + +[LIBUSB_DEV.DelReg.HW] +HKR,,"LowerFilters" + +;-------------------------------------------------------------------------- +; Services +;-------------------------------------------------------------------------- + +[LIBUSB.AddService] +DisplayName = "LibUsb-Win32 - Kernel Driver 03/09/2005, 0.1.10.1" +ServiceType = 1 +StartType = 3 +ErrorControl = 0 +ServiceBinary = %12%\libusb0.sys + +;-------------------------------------------------------------------------- +; Devices +;-------------------------------------------------------------------------- + +[Devices] +"LCD2USB LCD Interface"=LIBUSB_DEV, USB\VID_0403&PID_c630 + +[Strings] +manufacturer = "Till Harbaum" + diff --git a/win/libusb0.dll b/win/libusb0.dll new file mode 100755 index 0000000000000000000000000000000000000000..8f0d9f71964e5957b6d7c40226f3ff041e6f59ff GIT binary patch literal 46592 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 literal 0 HcmV?d00001 diff --git a/win/libusb0.sys b/win/libusb0.sys new file mode 100755 index 0000000000000000000000000000000000000000..3d369667a13573450e265d7aa75590487db61b23 GIT binary patch literal 33792 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 literal 0 HcmV?d00001