DiscFerret:Downloads - Revision history

Philpem: Mcode 0028, Libdiscferret 1.5

2012-01-11T21:48:04Z

Mcode 0028, Libdiscferret 1.5

Philpem at 23:59, 7 January 2012

2012-01-07T23:59:07Z

Philpem: /* Bootloader */

2011-12-31T21:42:16Z

‎Bootloader

Philpem: /* Microcode */

2011-12-31T21:41:19Z

‎Microcode

Philpem: /* Release 1.3 */

2011-12-31T21:39:32Z

‎Release 1.3

Philpem: /* Access libraries */

2011-12-31T21:38:52Z

‎Access libraries

Philpem: Unprotected "DiscFerret:Downloads"

2011-12-23T03:04:36Z

Unprotected "DiscFerret:Downloads"

Philpem: /* Access libraries */

2011-03-22T17:02:38Z

‎Access libraries

Philpem at 17:01, 22 March 2011

2011-03-22T17:01:53Z

Philpem: /* Firmware */ move upgrade instructions below versionID instructions

2011-03-21T22:16:41Z

‎Firmware: move upgrade instructions below versionID instructions

@@ Line 8: / Line 8: @@
 * Linux
 * FreeBSD 8 (or later)
-* Mac OS X (Darwin)
+* Mac OS X (Darwin) -- tested and known to work on Lion, but believed to work on Snow Leopard as well (feedback would be appreciated)
 To build it:
-  tar -zxf libdiscferret-1.4.tar.gz
+  tar -zxf libdiscferret-''version''.tar.gz
   make
@@ Line 22: / Line 22: @@
   make install PREFIX=/opt/discferret
-The latest version is '''Release 1.4''', which can be downloaded from here: [http://www.discferret.com/downloads/libdiscferret-1.4.tar.gz libdiscferret-1.4.tar.gz].
+The latest version is '''Release 1.5''', which can be downloaded from here: [http://www.discferret.com/downloads/libdiscferret-1.5.tar.gz libdiscferret-1.5.tar.gz].
 ==== Change history ====
-===== Release 1.4 =====
+===== Release 1.5 =====
 '''CRITICAL UPDATE!''' -- Everyone should immediately update to this version.
 * update microcode to REL_0027
 * Bugfix: if the disc-reader counter overflowed at exactly the same time a data or index pulse arrived, the overflow byte would be stored but the timing byte would be discarded. This corrupts the incoming data stream, rendering it useless.
@@ Line 67: / Line 74: @@
 Microcode bundles (RBF files) are included with release versions of the C and Python APIs. Generally speaking, you should only use the microcode version which was included with a given version of the API. To upgrade to a later microcode version, upgrade the API.
-For reference, the latest 'release' Microcode is '''version 0027''', which is available to download here: [http://www.discferret.com/downloads/microcode_0027.rbf microcode_0027.rbf].
+For reference, the latest 'release' Microcode is '''version 0028''', which is available to download here: [http://www.discferret.com/downloads/microcode_0028.rbf microcode_0028.rbf].
 === Microcode change log ===
 ==== Rev 0027 (2012-JAN-07) ====
 * New disc reader engine (simplified and bugfixed)
 * Major bug-fix: if a carry occurs at the same time a data pulse arrives, the data pulse will be ignored.

@@ Line 11: / Line 11: @@
 To build it:
-  tar -zxf libdiscferret-1.3.tar.gz
+  tar -zxf libdiscferret-1.4.tar.gz
   make
@@ Line 22: / Line 22: @@
   make install PREFIX=/opt/discferret
-The latest version is '''Release 1.3''', which can be downloaded from here: [http://www.discferret.com/downloads/libdiscferret-1.3.tar.gz libdiscferret-1.3.tar.gz].
+The latest version is '''Release 1.4''', which can be downloaded from here: [http://www.discferret.com/downloads/libdiscferret-1.4.tar.gz libdiscferret-1.4.tar.gz].
 ==== Change history ====
 ===== Release 1.3 =====
@@ Line 59: / Line 67: @@
 Microcode bundles (RBF files) are included with release versions of the C and Python APIs. Generally speaking, you should only use the microcode version which was included with a given version of the API. To upgrade to a later microcode version, upgrade the API.
-For reference, the latest 'release' Microcode is '''version 0026''', which is available to download here: [http://www.discferret.com/downloads/microcode_0026.rbf microcode_0026.rbf].
+For reference, the latest 'release' Microcode is '''version 0027''', which is available to download here: [http://www.discferret.com/downloads/microcode_0027.rbf microcode_0027.rbf].
 === Microcode change log ===
 ==== Rev 0026 (2011-DEC-31) ====

@@ Line 125: / Line 125: @@
 If the DiscFerret will not enter the bootloader even with the BOOT jumper installed, the bootloader may have become corrupted. In normal use, this should not be possible. It is, however, still possible to recover the DiscFerret, as long as you have a suitable PIC programmer. To do this, five wires must be soldered to the programming pads on the bottom of the DiscFerret PCB, and a PIC programmer (e.g. a Microchip PICKit 2) is connected to these wires. See the DiscFerret circuit diagram for the pin configuration of these pads.
-'''NOTE: The DiscFerret uses a PIC18F85J50 microcontroller, which uses 3.3V Low Voltage Programming. Make ABSOLUTELY SURE your PIC programmer supports this programming mode (the PICKit 2 and PICKit 3 do), and that the device is set to "PIC18F85J50" (NOT auto-detect). Failure to follow these instructions WILL destroy the microcontroller IC!'''
+'''NOTE: The DiscFerret uses a PIC18F85J50 microcontroller, which uses 3.3V Low Voltage Programming. Make ABSOLUTELY SURE your PIC programmer supports this programming mode (the PICKit 2, PICKit 3 and ICD3 do; the ICD2 ''DOES NOT''), and that the device is set to "PIC18F85J50" (NOT auto-detect). Failure to follow these instructions WILL destroy the microcontroller IC!'''
 After reprogramming the bootloader, the Unit Serial Number must be reprogrammed using '''id_program.py''', which is included in the Firmware Source-Code Bundle, under the "test" directory. You will need to install the Python LibUSB wrapper library (on an Ubuntu Linux system, this is in the package `python-usb`) in order to use this tool.

@@ Line 59: / Line 59: @@
 Microcode bundles (RBF files) are included with release versions of the C and Python APIs. Generally speaking, you should only use the microcode version which was included with a given version of the API. To upgrade to a later microcode version, upgrade the API.
-For reference, the latest 'release' Microcode is '''version 0021''', which is available to download here: [http://www.discferret.com/downloads/microcode_0021.rbf microcode_0021.rbf].
+For reference, the latest 'release' Microcode is '''version 0026''', which is available to download here: [http://www.discferret.com/downloads/microcode_0026.rbf microcode_0026.rbf].
 === Microcode change log ===
 ==== Rev 0021 (2011-MAR-21) ====

@@ Line 27: / Line 27: @@
 ===== Release 1.3 =====
- <nowiki>
+* update microcode to REL_0026
-update microcode to REL_0026
+* fix bad syntax in register header (ahem)
-fix bad syntax in register header (ahem)
+* update registers for microcode 0025 and later
-update registers for microcode 0025 and later
+* fix building of test application
-fix building of test application
+* update udev rules for newer versions of udev
-update udev rules for newer versions of udev
+* Add udev rules file for DiscFerret devices
-Add udev rules file for DiscFerret devices
+* hide output from rm during solib link
-hide output from rm during solib link
+* fix makefile so libdiscferret also builds on Linux
-fix makefile so libdiscferret also builds on Linux
+* add idplatform.sh (req'd for new build system)
-add idplatform.sh (req'd for new build system)
+* Changes to allow libdiscferret to build on Mac OS X
-Changes to allow libdiscferret to build on Mac OS X
+* More fixes to use stdlib.h instead of malloc.h
-More fixes to use stdlib.h instead of malloc.h
+* use stdlib.h instead of malloc.h (ooops!)
-use stdlib.h instead of malloc.h (ooops!)
+* fix uninitialized value warning
-fix uninitialized value warning
+* tag release builds in the copyright notice, not just debug builds
-tag release builds in the copyright notice, not just debug builds
+* separate building of docs from main library
-separate building of docs from main library
+* Add missing microcode image (RBF file) and a README
-Add missing microcode image (RBF file) and a README
+* BUGFIX: fix issues with accidental double-stepping
-BUGFIX: fix issues with accidental double-stepping
+* increase USB timeout to 1 second (from 100ms)
-increase USB timeout to 1 second (from 100ms)
+* fix issue with discferret_microcode.o not being linked into solib
-fix issue with discferret_microcode.o not being linked into solib
+* fixes for const-correctness, bump version to 1.2r2
-fixes for const-correctness, bump version to 1.2r2
+* Include local copy of the DiscFerret microcode
-Include local copy of the DiscFerret microcode
+* use DISCFERRET_ERROR enum where appropriate
 ===== Release 1.1r1 =====

← Older revision	Revision as of 03:04, 23 December 2011
(No difference)

@@ Line 11: / Line 11: @@
 To build it:
-  <nowiki>
+  tar -zxf libdiscferret-1.1r1.tar.gz
-tar -zxf libdiscferret-1.1r1.tar.gz
+ make
 To install it:
-  <nowiki>
+  make install
 By default, the libraries and headers are installed in /usr/local/lib and /usr/local/include respectively. To change this, append "PREFIX=path" to both the "make" and "make install" commands. For example, to install in ''/opt/discferret'', use these commands:
-  <nowiki>
+  make PREFIX=/opt/discferret
-make PREFIX=/opt/discferret
+ make install PREFIX=/opt/discferret
 The latest version is '''Release 1.1r1''', which can be downloaded from here: [http://www.discferret.com/downloads/libdiscferret-1.1r1.tar.gz libdiscferret-1.1r1.tar.gz].
@@ Line 36: / Line 30: @@
 * Add support for the "Track 0 Reached During Seek" status bit
 * Add discferret_seek_* functions to simplify head seek operations
 == Microcode ==

← Older revision		Revision as of 17:01, 22 March 2011
Line 1:		Line 1:
	[[Category:DiscFerret]]		[[Category:DiscFerret]]
		+
		+	== Access libraries ==
		+
		+	=== libdiscferret (C library) ===
		+
		+	Libdiscferret allows applications written in C or C++ to access the DiscFerret, without having to worry about USB transaction management, packetisation and other low-level issues. It is known to run on any UNIX platform which provides the [http://www.libusb.org/ libusb-1.0] API. At the time of writing, this includes:
		+	* Linux
		+	* FreeBSD 8 (or later)
		+	* Mac OS X (Darwin)
		+
		+	To build it:
		+	<nowiki>
		+	tar -zxf libdiscferret-1.1r1.tar.gz
		+	make
		+	</nowiki>
		+
		+	To install it:
		+	<nowiki>
		+	make install
		+	</nowiki>
		+
		+	By default, the libraries and headers are installed in /usr/local/lib and /usr/local/include respectively. To change this, append "PREFIX=path" to both the "make" and "make install" commands. For example, to install in ''/opt/discferret'', use these commands:
		+
		+	<nowiki>
		+	make PREFIX=/opt/discferret
		+	make install PREFIX=/opt/discferret
		+	</nowiki>
		+
		+	The latest version is '''Release 1.1r1''', which can be downloaded from here: [http://www.discferret.com/downloads/libdiscferret-1.1r1.tar.gz libdiscferret-1.1r1.tar.gz].
		+
		+	==== Change history ====
		+
		+	===== Release 1.1r1 =====
		+
		+	* Add support for the "Track 0 Reached During Seek" status bit
		+	* Add discferret_seek_* functions to simplify head seek operations
		+

	== Microcode ==		== Microcode ==

@@ Line 22: / Line 22: @@
 ==== Version 001C (2011-FEB-13) ====
 * Fix a serious bug relating to USB hot-plugging. If the DiscFerret was powered up before the USB cable was connected, then the USB stack may not start up correctly. Additionally, if the USB cable is unplugged while the DiscFerret is powered up, the USB PHY may lose sync with the host.
 === Identifying the firmware version your DiscFerret is running ===
@@ Line 58: / Line 42: @@
 The Microcode Type and Microcode Version will only be valid if a microcode bundle has been uploaded to the DiscFerret (i.e. if an application which uses the DiscFerret has already been run). If the Microcode Type is anything other than `0xDD55`, then the microcode version will not be valid. Device information can only be queried when the DiscFerret is running the operating firmware; the bootloader has no support for firmware version querying.
 == Bootloader ==