# Welcome to Hell.

## Installation instructions

No need to clone this repo manually. You'll just need to install the Rust toolchain and SDCC.

```bash
# All OSes
cargo install --git https://git.zumepro.cz/michal.prochazka/tulflash
```

## Running the example program

```bash
# Generate the example program (only needed to run once):
tulflash example

# Compile, flash and monitor the example program:
tulflash run example.c:

# note: `tulflash run example.c` is the thing as `tulflash write --cmd "sdcc example.c" --monitor example.ihx`
```

If the flash fails, try to add `--slow` before `run` (should not be needed though).

## Manually flashing Intel HEX binaries

```bash
# All OSes, automatically detects the correct serial port
tulflash write <path-to-hex>
```

The tool also allows reading and erasing the chip, figure that out on your own if you need that (although `tulflash --help` might guide you if you ask it nicely).