Skip to main content

A tool for managing knitting machine patterns

Project description

Dropbox for knitting machines


Knitty-gritty manages your knitting machine patterns. You place all your pattern images a folder, and this folder will be uploaded to the machine each time you tell the machine to import patterns. You can of course pre-populate the folder with patterns downloaded from the machine.

Features

  • Reads or writes BMP, PNG, and JPEG images.

  • Compacts the memory used to avoid gaps (fragmentation!) in memory, allowing you to use (almost) 100% of your machine’s 32 kb memory.

What Doesn’t Work?

  • Adding data to the memo display.

  • Validating that the pattern fits within the machine’s working memory.

Platform Support

Only tested on OS X, but should work out of the box on both Windows and Linux given that you have the software requirements listed below installed. Please let me know if it does not - preferably with a pull request fixing the issue :-)

What You Will Need

Hardware:

  • Brother KH940 knitting machine. KH930 might work but is untested.

  • USB FTDI cable connected to the machine.

Software:

  • A Python (2.7) installation.

  • Preferably a Python virtual environment.

Installation Instructions

Knitty-gritty is distributed as a Python package. Install it via pip:

pip install knitty-gritty

If that completed successfully, you will now have a knitty-gritty executable, ready to do its thing!

Downloading Patterns from the Machine

# First, find your USB cable:
ls /dev/tty.usbserial-*

# Replace the file below with the name you found
# The last parameter `patterns` is the folder where your patterns should be saved
knitty-gritty emulate-folder /dev/tty.usbserial-A7XTW5YZ patterns

If this is the first time you run knitty-gritty, you should download all patterns from the machine first. On a KH940, this is done by entering CE, 552, STEP, 1, STEP. When this is done, the machine should beep (as it always does). Quit Knitty-gritty by pressing Control-C. The pattern images should appear in the folder you specified.

Now you can modify/add/remove patterns as much as you like. Just drop them in the folder together with the other patterns.

Uploading Patterns

When you’re done with fiddling with the images, you should upload them:

# Replace the TTY-parameter with the cable you found above.
knitty-gritty emulate-folder --no-save /dev/tty.usbserial-A7XTW5YZ patterns

The --no-save argument tells Knitty-gritty to not save any files to the folder on the computer. This is a safeguard against removing/overwriting patterns if anything goes wrong.

To load the patterns on the machine, enter CE, 551, STEP, 1, STEP and wait until it beeps.

Acknowledgements

  • The file format/memory dump file format documentation over at STG’s knittington repository was a huge help in writing the parser/serializer.

  • Steve Conklin’s PDDemulate.py in knitting_machine was very useful in filling the gaps in Tandy’s official floppy drive command documentation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

knitty-gritty-0.0.1.tar.gz (10.9 kB view details)

Uploaded Source

Built Distribution

knitty_gritty-0.0.1-py2-none-any.whl (12.4 kB view details)

Uploaded Python 2

File details

Details for the file knitty-gritty-0.0.1.tar.gz.

File metadata

File hashes

Hashes for knitty-gritty-0.0.1.tar.gz
Algorithm Hash digest
SHA256 3f6295e85f894c343f030d1b5369fc5a8ea694d8a346cc645a583baa357b0b71
MD5 4e1e7c011725f3e3b7b3d87c6ab3f9cb
BLAKE2b-256 a7a01fac84794621fd9ba685c64dcaf7676857c34ef50d8b8a26b79b8bf46354

See more details on using hashes here.

File details

Details for the file knitty_gritty-0.0.1-py2-none-any.whl.

File metadata

File hashes

Hashes for knitty_gritty-0.0.1-py2-none-any.whl
Algorithm Hash digest
SHA256 f9a62c2f97820a22618f153944fb005613bafb389c8ca2abfb84ca2d3f946527
MD5 a12a16dc8b72e9a1a49158fc9a8e8e33
BLAKE2b-256 62ba8164c0610e4033eb8fc73de935631afee7d29c5b8424c41345400a8aca51

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page