This is software to read and write data on a Stratasys cartridge EEPROM.
You can use this code to 'refill' an EEPROM or build a cartridge EEPROM image from scratch.
- python 2.7
- pycrypto
You have to provide the machine type (fox, prodigy, quantum, etc.) and the EEPROM uid, in hexadecimal form without the '0x' prefix. Note that the EEPROM uid to use ends with "23" (which is the family code for the EEPROM device).
$ ./stratasys-cli.py eeprom -t fox -e 6b0000014d476223 -i cartridge_dump.bin
The EEPROM uid should end with '23'. You may have to reverse the byte order. Say you have "233a38b1020000c0" - you should reverse it to be "c0000002b1383a23".
If you provide the '-r' option, arguments to pass to stratasys-cli will be printed to help you recreate the cartridge.
If you provide the '-D' option, the input file will be interpreted as an ASCII formatted file, containing lines of the form produced by the printers 'er' command, namely:
000096: 00 00 00 00 00 00 00 00 53 54 52 41 54 41 53 59 ........STRATASY
Otherwise, the input file must be a binary file.
By providing all the required information, this software will provide a new valid EEPROM image that you can write to a cartridge.
$ ./stratasys-cli.py eeprom --machine-type fox --eeprom-uid 6b0000014d476223 --serial-number 1234.0 --material-name ABS --manufacturing-lot 1234 --manufacturing-date "2001-01-01 01:01:01" --use-date "2002-02-02 02:02:02" --initial-material 11.1 --current-material 22.2 --key-fragment 4141414141414141 --version 1 --signature STRATASYS -o random_file.bin
All the dates are in international format: yyyy-mm-dd hh:mm:ss
You have to provide the correct machine-type and the valid eeprom uid. You can customize all the rest.
The EEPROM uid use to end with '23'. You may have to reverse it. Say you have
233a38b1020000c0
, you should reverse it to be c0000002b1383a23
.
The generated file will be 113 bytes in size. You can complete the file with zeroes if you want to make it 512 bytes long, the usual EEPROM size.a
Supplying the '-D' option will result in an output file containing a double-quoted string of space delimited bytes, expressed in hexadecimal. Otherwise, the output will be a binary file.
If you want a list of all known material, simply run the following:
$ ./stratasys-cli.py material --list
0 ABS
1 ABS_RED
2 ABS_GRN
[...]
Use those names when creating a new cartridge.
If you have an invalid checksum
error, the code was not able to decrypt your
EEPROM correctly. Verify that your EEPROM file is valid, double check the
EEPROM uid.
If it still doesn't work, fill a ticket on Github.
This script is able to generate configuration code for your printer. There are actually 3 different codes available:
- configuration
- setup
- clear
We're only able to generate configuration
code for now. These codes can
unlock specific features of your printer.
To decode a configuration code, simply run the following:
$ ./stratasys-cli.py setupcode -d AAAA-BBBB-CCCC-DDDD
You can create your own configuration code to enable specific features.
For example:
$ ./stratasys-cli.py setupcode -e -n 1234 -s 900mc -t configuration -l large -b 1x -m ABS-M30 NYLON PC-ABS -v 1
Will generate a configuration
code for a printer type 900mc.
The available options:
- -e : encode
- -n : serial number (format ABCD)
- -s : machine type
- -t : code type (put
configuration
unless you know what you're doing) - -l : envelope size
- -b : build speed
- -m : supported material (you can put a list of materials after the
-m
separated by space) - -v : version of the code (put
1
unless you know what you're doing) - -k : specify the key that should be used to encode (OPTIONAL)
For help on available values, you can run the following:
$ ./stratasys-cli.py setupcode --help
- slaytonrd/CartridgeWriter - rewritten in C# by slaytonrd
- Use the MISO wire (orange) for the data
- Use the GROUND wire (black) on the ground
- Connect the 5V (grey) on the pull-up voltage input (blue)
Use the following schematic as a reference:
Bus pirate
grey >---+
|
blue >---+
eeprom
+------+
orange >---| Data |
| |
black >---| Gnd |
+------+
Use the scripts available in the helper
directory.
To read an eeprom:
$ ./bp_read.py /dev/ttyUSB0 eeprom.bin
To write an eeprom:
$ ./bp_write.py /dev/ttyUSB0 eeprom_new.bin
- Use the GPIO 4 (pin 7) for the data
- Use any GROUND (pin 6,9,14,20 or 25) on the ground
- Use the 5V Power (pin 2) to pull-up the data line using a ~4.7k resistor
Use the following schematic as a reference:
Raspberry pi
5V >---+
|
4.7k Z eeprom
| +------+
GPIO4 >---+---| Data |
| |
GROUND >-------| Gnd |
+------+
Then you'll need to probe 2 kernel modules:
$ sudo modprobe w1-gpio gpiopin=4
$ sudo modprobe w1-ds2433
You should now see your eeprom appearing:
$ ls -l /sys/bus/w1/devices/w1_bus_master1
23-xxxxxxxxxxxx/
[...]
To print the eeprom uid:
$ xxd -p /sys/bus/w1/devices/w1_bus_master1/23-xxxxxxxxxxxx/id
23xxxxxxxxxxxx
To read an eeprom:
$ cp /sys/bus/w1/devices/w1_bus_master1/23-xxxxxxxxxxxx/eeprom ~/eeprom.bin
To write an eeprom:
$ cp ~/eeprom_new.bin /sys/bus/w1/devices/w1_bus_master1/23-xxxxxxxxxxxx/eeprom
Special thanks to the Stratahackers group. Without them, nothing like this could be possible. They provided moral and technical support!
Thanks to ashanin for the uPrint support.