[[TOC(CATkit-proto, CATkit-board, CATkit-huds, CATkit-howto)]]
= CATkit how-to =

If you obtained a kit which has a programmed boot monitor, just copy the file 'current.state' into the directory brood/prj/CATkit.

== Step 1: initialisation ==

If you obtained a kit which has a programmed boot monitor, just copy the file 'current.state' into the directory brood/prj/CATkit and proceed to the next step.

If you don't have a chip programmed with the boot monitor, you need to create these files yourself typing the command 'scrap' in the interactive PURRR18 console. This will create the state file mentioned above, which includes all information necessary to interact with the chip, and a file 'monitor.hex' which contains the code for the boot monitor, which is code that interfaces a chip to a host PC using the serial cable.

{{{
> scrap
updated: 
 prj/krikit/current.state 
 prj/krikit/monitor.hex
}}}

The 'monitor.hex' file can be loaded into an empty chip using a device called a 'programmer'. See the [wiki:CATkit-ICD2 CATkit ICD2] page for more info on using the popular ICD2 programmer. There are a lot of cheaper and simpler alternatives. Consult your local PIC programming expert.

== Step 2: ping ==

If the monitor is on the chip, the board can be connected to your computer with the serial cable. Now you need to tell the interaction system which project to use. Tell it the board connected to the programming cable is the CATkit board using this command
{{{
> prj CATkit
}}}

This will load all state data, including names for code stored on the chip. When you run the command 'ping' in the console, the chip will reply giving its name.

{{{
> ping
CATkit 
}}}


Done! Time to start with the [wiki:CATkit-purrr CATkit Purrr] tutorial.