Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100755 103 lines (72 sloc) 3.562 kb
dc6ba06a »
2012-05-18 Fixed error in memory map documentation
1 Disk image manager for Brother Electroknit KH-940 knitting machine.
2
3 This program is capable of reading and writing:
4 * 80k disk image files (our proprietary format)
5 * Steve Conklin's Tandy PDD1 floppy drive emulator data folders.
6
7 Steve Conklin's emulator was designed for KH-930E,
8 but it works equally well with the KH-940.
9
10 == FILES =============================================================
11
12 src/ Source files for the disk image manager
13 sample/ Samples of disk images
14 1.img Three small designs (actual data from machine)
15 2.img Two wide/tall designs (actual data from machine)
16 3.img Seven very different designs (generated file)
17 doc/ File format documentation
18 mem_format.txt Description of the KH-940 memory layout
19 img_format.txt Description of the disk image formats
20 raw_format.txt Description of pattern file format
21 patterns/ Sample patterns as both bmp and raw
22
23 == HOW TO USE ========================================================
24
25 Compile and launch knit executable.
26
27 Typing ? or help will give
28
29 : ?/help show this
30 : r/read read in data from file
31 : w/write write out data to file
32 : f/format clear all contents
33 : a/add add pattern
34 : s/show display data content
35 : e/emulate emulate floppy
36 : i/info additional info
37 : q/quit end program
38
39 read - Reads image on disk to memory
40 The file can be either disk image or folder with emulator files.
41
42 Entering the name of a file will read it as a disk image, ie:
43 filename> sample/1.img
44
45 Entering a folder name, ending with a (back)slash, will read
46 Tandy FDD1 emulator file folder, ie:
47 filename> fddemu/img/
48
49
50 write - Write memory to image on disk
51 The file can be either disk image or folder with emulator files.
52 See "read" command for more info.
53
54
55 format - Clear computer ram contents
56 This will delete everything currently contained in memory and
57 ready the program for input of a new file.
58
59
60 add - Add a pattern to memory
61 The pattern is read from a raw image file, ie:See
62 filename> patterns/903.raw
63
64 See doc\raw_format.txt for a description of the format.
65
66
67 show - Show patterns contained in memory
68 This will list all available patterns and to into pattern
69
70 display mode. In this mode you get the following promt:
71 pattern #>
72 instead of the regular one.
73
74 To exit this mode enter d, done or simply enter a blank line.
75
76 While in this mode, enter the pattern number of an available
77 pattern to print out a graphical representation of the
78 pattern as well as it's binary data representation.
79
80
81 info - Shows additional non-pattern information
82 This will display all important fields in the currently
83 loaded file and run a verification suite against all of
84 the know values.
85
86 Verifications are done against the most common and verified
87 to work values that have been downloaded from the machine.
88
89 Therefore it MAY give FAIL on "write pointer" entries and/or
90 the "loaded head" entry for some files when entered and
91 loaded from knitting machine as the true meaning of these
92 parameters is not exactly known.
93
94 Additionally, MOST parameters WILL give FAIL on a blank
95 formatted file, regardless if done via device or this
96 program.
97
98 For a file generated using this program all parameters
99 should give OK before attempting download.
100
101
102 quit - Self explanatory
103 Go outside and enjoy the weather
Something went wrong with that request. Please try again.