GenieDiag Manual - CatGenius/catgenius GitHub Wiki
Introduction
GenieDiag is a diagnostics application for people who have converted their CatGenie catbox into a CatGenius. It allows you to test separate functions of the hardware. It also allows Beta testers to drain their box and check the status of the water sensor in case a bad software version has messed things up.
Usage
Just program the GenieDiag application into your catbox, overwriting the CatGenius application. Once programmed, the test mode can be selected using the setup button. The level indicator LEDs will indicate the actual test mode:
- LED1: Test the bowl, start button will alternate between CW, CCW and stop.
- LED2: Test the arm, start button will alternate between down, up and stop.
- LED1 & LED2: Test the dosage pump, start button will alternate between on and off.
- LED3: Test the hopper pump, start button will alternate between on and off.
- LED1 & LED3: Test the dryer, start button will alternate between on and off.
- LED2 & LED3: Test the water valve, start button will alternate between on and off. In this state, the water sensor IR LED will be on permanently to verify its intensity using a digital camera.
Please note that selecting another test will not stop the currently test. So you can test the arm while the bowl is rotating.
When testing the water valve, the water will go in protection when the maximum level is reached, but the test will not be turned off. If you don't turn it off by pressing the start button again, and the water gets below the maximum, the protection will go off and the water will start running again.
The Cat LED will indicates when the cat detector sees something. The Error LED will indicates if water is detected.
Serial port
GenieDiag offers a command line interface on the serial port of the CatGenie box. The serial parameters are as follows:
- 19200 b/s bit rate
- 8 data bits
- No parity
- 1 stop bit
- No local echo
When powering up your box with GenieDiag installed, it will present itself with a prompt, inviting you to type a command:
*** GenieDiag *** Power-on reset #
The command set offers commands to fully control your box. With these commands, you could in theory run your own washing program from a PC, sending these commands to GenieDiag. To make communication easier for a PC (yet more difficult for a person), you can turn remote echo off, using the echo command:
# echo Echo: on
# echo off Echo: off
As shown above, most commands can be used to request the current state if no argument is given.
Box control commands
- bowl, shows the status of the bowl
- bowl cw, starts turning the bowl in clockwise direction
- bowl ccw, starts turning the bowl in counter-clockwise direction
- bowl stop, stops the bowl from turning
- arm, shows the status of the arm
- arm down, starts moving the arm down
- arm up, starts moving the arm up
- arm stop, stops moving the arm
- dosage, shows that status of the dosage pump
- dosage on, switches on the dosage pump
- dosage off, switches off the dosage pump
- tap, shows the status of the water tap
- tap on, turns on the water tap (until water is detected)
- tap off, turns off the water tap
- drain, shows the status of the drain pump
- drain on, turns on the drain pump (don't let it run for longer than 60 seconds or it will overheat)
- drain off, turns off the drain pump
- dryer, shows the status of the dryer
- dryer on, turns on the dryer
- dryer off, turns off the dryer
- cat, queries the cat sensor status
- water, queries the water sensor status
- heat, queries the dryer overheat detector status
Both cat sensor, water sensor and overheat detector state changes are reported as they occur, without the need to query them.
Cartridge tag reader commands
- tag uid, reports the chip's Unique ID
- tag dump, dumps all cartridge chip contents, including the Unique ID