FluxEngine - Revision history

Tingo: /* Hardware setup */ Document that fe software can use gw hardware

2021-02-05T16:39:34Z

Hardware setup: Document that fe software can use gw hardware

← Older revision		Revision as of 16:39, 5 February 2021
Line 18:		Line 18:

	You also need a bit of storage space for the images you capture.		You also need a bit of storage space for the images you capture.

			'''Note''': Recent versions of the FluxEngine software allows you to use the [[Greaseweazle]] hardware, but at the time of writing this text, the Greaseweazle hardware need to have firmware <= 0.22 (there were incompatible changes in firmware 0.23), see pull-request #221<ref>[https://github.com/davidgiven/fluxengine/pull/221 github - davidgiven/fluxengine #221]</ref> for details. I have tested reading floppies with gw hw and fe sw, and it works, see testing subpage.

	== Software setup ==		== Software setup ==

Tingo: /* Hardware setup */ drive numbering has been fixed

2021-02-05T16:31:20Z

Hardware setup: drive numbering has been fixed

← Older revision		Revision as of 16:31, 5 February 2021
Line 18:		Line 18:

	You also need a bit of storage space for the images you capture.		You also need a bit of storage space for the images you capture.

	~~'''Note''': FluxEngine numbers drives differently from the usual way. When using FluxEngine, drive 0 is the drive before the twist in the floppy cable, and drive 1 is the drive after the twist.~~

	== Software setup ==		== Software setup ==

Tingo: /* Usage */ just bold text

2020-03-04T22:52:03Z

Usage: just bold text

← Older revision		Revision as of 22:52, 4 March 2020
Line 81:		Line 81:
	</pre>		</pre>
	fluxengine uses the default values, so specify options if you want to change them. Example: we want to read 77 tracks from the source, so we specify <code>-s :t=0-76</code>.		fluxengine uses the default values, so specify options if you want to change them. Example: we want to read 77 tracks from the source, so we specify <code>-s :t=0-76</code>.
	reading a ND format 17b floppy (the ND format is a variation of the IBM format)		reading a '''ND format 17b''' floppy (the ND format is a variation of the IBM format)

	<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 -o name.img</code>		<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 -o name.img</code>

Tingo: /* Usage */ add command for reading ND format 0b floppies

2020-03-04T22:51:18Z

Usage: add command for reading ND format 0b floppies

← Older revision		Revision as of 22:51, 4 March 2020
Line 88:		Line 88:

	<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 --revolutions=2 -o test-nd-525-210523g02-xx-01d_r2.img</code>		<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 --revolutions=2 -o test-nd-525-210523g02-xx-01d_r2.img</code>

			reading '''ND format 0b''' floppies - these are just single-sided version of the above, so

			<code>$ ../fluxengine read ibm -s :s=0:t=0-76 --retries=0 -o name.img</code>

	== Troubleshooting ==		== Troubleshooting ==

Tingo: /* Usage */ newer version of FluxEngine software complains if the output file doesn't have the extension '.img' - fixed

2020-03-04T22:48:54Z

Usage: newer version of FluxEngine software complains if the output file doesn't have the extension '.img' - fixed

← Older revision		Revision as of 22:48, 4 March 2020
Line 83:		Line 83:
	reading a ND format 17b floppy (the ND format is a variation of the IBM format)		reading a ND format 17b floppy (the ND format is a variation of the IBM format)

	<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 -o name.~~image~~</code>		<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 -o name.img</code>

	read with <code>--revolutions=2</code>		read with <code>--revolutions=2</code>

	<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 --revolutions=2 -o test-nd-525-210523g02-xx-01d_r2.~~image~~</code>		<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 --revolutions=2 -o test-nd-525-210523g02-xx-01d_r2.img</code>

	== Troubleshooting ==		== Troubleshooting ==

Tingo: Add Troubleshooting section

2020-02-16T12:54:49Z

Add Troubleshooting section

← Older revision		Revision as of 12:54, 16 February 2020
Line 88:		Line 88:

	<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 --revolutions=2 -o test-nd-525-210523g02-xx-01d_r2.image</code>		<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 --revolutions=2 -o test-nd-525-210523g02-xx-01d_r2.image</code>

			== Troubleshooting ==
			In this section we can share tips to fix problems.

			=== FluxEngine gets confused ===
			A couple of times FE (FluxEngine) has become confused and tried to write 254 tracks or something. The fix is to unplug FE from the usb port (which gives it power) and plug it back in, then retry.

	== References ==		== References ==

Tingo: link to the Greaseweazle page

2020-02-04T21:36:25Z

link to the Greaseweazle page

← Older revision		Revision as of 21:36, 4 February 2020
Line 1:		Line 1:
	The FluxEngine<ref>[http://cowlark.com/fluxengine/ FluxEngine]</ref> is not an ND product. It is interesting because it can be used as a [[ND media reader]] for floppies.		The FluxEngine<ref>[http://cowlark.com/fluxengine/ FluxEngine]</ref> is not an ND product. It is interesting because it can be used as a [[ND media reader]] for floppies. [[Greaseweazle]] is a similar tool.

	Subpages: [[FluxEngine/testing\|testing]],		Subpages: [[FluxEngine/testing\|testing]],

Tingo: /* Usage */ detail usage a bit

2019-07-12T14:56:05Z

Usage: detail usage a bit

← Older revision		Revision as of 14:56, 12 July 2019
Line 25:		Line 25:

	== Usage ==		== Usage ==
			Usage is simple (I'm using a Linux command line for this example, and the fluxengine binary is in the parent directory)
			<pre>
			$ ../fluxengine
			fluxengine: syntax: fluxengine <command> [<flags>...]
			Try one of these commands:
			erase: Permanently but rapidly erases some or all of a disk.
			inspect: Low-level analysis and inspection of a disk.
			rpm: Measures the disk rotational speed.
			seek: Moves the disk head.
			testbulktransport: Measures your USB bandwidth.
			upgradefluxfile: Upgrades a flux file from a previous version of this software.
			read: Reads a disk, producing a sector image.
			write: Writes a sector image to a disk.
			writeflux: Writes a raw flux file. Warning: you can't use this to copy disks.
			writetestpattern: Writes a machine-generated test pattern to a disk.
			</pre>
			to see help for the read command
			<pre>
			$ ../fluxengine read --help
			fluxengine: syntax: fluxengine read <format> [<flags>...]
			These formats are supported:
			adfs: Reads Acorn ADFS disks.
			aeslanier: Reads AES Lanier disks.
			amiga: Reads Commodore Amiga disks.
			ampro: Reads Ampro disks.
			apple2: Reads Apple II disks.
			brother: Reads 120kB and 240kB Brother word processor disks.
			c64: Reads Commodore 64 disks.
			dfs: Reads Acorn DFS disks.
			f85: Reads Durango F85 disks.
			fb100: Reads FB100 disks.
			ibm: Reads the ubiquitous IBM format disks.
			mac: Reads Apple Macintosh disks.
			mx: Reads MX disks.
			victor9k: Reads Victor 9000 disks.
			zilogmcz: Reads Zilog MCZ disks.
			</pre>
			help for the read ibm command
			<pre>
			tingo@kg-bsbox:~/personal/projects/psoc/fluxengine/tmp$ ../fluxengine read ibm --help
			FluxEngine options:
			--revolutions <default: "1">: read this many revolutions of the disk
			--pulse-debounce-threshold <default: "0.300000">: Ignore pulses with intervals short than this, in fractions of a clock.
			--bit-error-threshold <default: "0.200000">: Amount of error to tolerate in pulse timing, in fractions of a clock.
			--clock-interval-bias <default: "-0.020000">: Adjust intervals between pulses by this many clocks before decoding.
			--source, -s <default: ":d=0:s=0-1:t=0-79">: source for data
			--write-flux, -f <default: "">: write the raw magnetic flux to this file
			--just-read: just read the disk and do no further processing
			--dump-records: Dump the parsed records.
			--retries <default: "5">: How many times to retry each track in the event of a read failure.
			--high-density, --hd: set the drive to high density mode
			--output, -o <default: "ibm.img">: The output image file to write to.
			--sector-id-base <default: "1">: Sector ID of the first sector.
			--help, -h: Shows the help.
			</pre>
			fluxengine uses the default values, so specify options if you want to change them. Example: we want to read 77 tracks from the source, so we specify <code>-s :t=0-76</code>.
			reading a ND format 17b floppy (the ND format is a variation of the IBM format)

			<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 -o name.image</code>

			read with <code>--revolutions=2</code>

			<code>$ ../fluxengine read ibm -s :t=0-76 --retries=0 --revolutions=2 -o test-nd-525-210523g02-xx-01d_r2.image</code>

	== References ==		== References ==

Tingo: /* Hardware setup */ Note different drive numbering for FluxEngine

2019-07-12T14:43:59Z

Hardware setup: Note different drive numbering for FluxEngine

← Older revision		Revision as of 14:43, 12 July 2019
Line 18:		Line 18:

	You also need a bit of storage space for the images you capture.		You also need a bit of storage space for the images you capture.

			'''Note''': FluxEngine numbers drives differently from the usual way. When using FluxEngine, drive 0 is the drive before the twist in the floppy cable, and drive 1 is the drive after the twist.

	== Software setup ==		== Software setup ==

Tingo: /* Software setup */ Note that Windows is needed for PSoC Creator (it is not working in Wine)

2019-07-12T14:28:09Z

Software setup: Note that Windows is needed for PSoC Creator (it is not working in Wine)

← Older revision		Revision as of 14:28, 12 July 2019
Line 20:		Line 20:

	== Software setup ==		== Software setup ==
	The FluxEngine software and how to configure it is described on the FluxEngine webpage and will not be repeated here. If you need additional software, for example '''ndfs''' to work with ND filesystem format images, you should install and test it.		The FluxEngine software and how to configure it is described on the FluxEngine webpage and will not be repeated here. '''Note''': you need a Windows machine for the proprietary Cypress software (PSoC Creator) for compiling and loading firmware onto the FluxEngine. If you need additional software, for example '''ndfs''' to work with ND filesystem format images, you should install and test it.

	== Usage ==		== Usage ==