# `arctictis`

This crate implements the serial programming protocol for the [Uniden BC125AT "Bearcat" Radio Scanner][uniden]. You can
use this crate to modify the scanner's settings and program its channels. See [the documentation][docs] for more
details, as well as the [examples](/crates/arctictis/examples).

For details on the protocol anda list of possible commands, see [the spec] ([archived]).

## Naming

The [Bearcat's](https://en.wikipedia.org/wiki/Binturong) scientific name is *Arctictis binturong*.

https://youtu.be/2FspwOKfGPY

## AI Disclosure

With the below exceptions, all tests, code, and documentation, including this document as well as doc comments, was written by hand by a human being. All API design was done by a human being.

I like programming, I don't want to offload that to a computer. But I do want to evaulate the capabilities of AI agents in a narrow, limited scope.

AI was used for the following tasks, with close verification by a human (this may expand in the future):

### CTCSS/DCS code mappings

The scanner maps CTCSS frequencies and DCS codes to an internal code. There's 154 of these, and mapping them by hand would be tedious and error-prone. Since the mapping is in [a PDF][the spec] (see page 13) there wasn't really an easy way to parse this. I let Claude ingest the protocol document and fill out the match statements, then visually verified all mappings were correct.

[uniden]: https://uniden.com/products/bc125at
[the spec]: https://info.uniden.com/twiki/pub/UnidenMan4/BC125AT/BC125AT_PC_Protocol_V1.01.pdf
[archived]: http://archive.today/3x690
[docs]: https://docs.rs/arctictis