To program your Cato, use the following procedure.

Please connect your Cato to the computer with a USB-C Cable capable of Data Transfer

1. Go to https://github.com/aulitech/Cato/releases

2. Download the latest release to a convenient directory (such as /Downloads)

3. Unzip the release folder there

This gives access to our full source code, but you only need the subfolder "release"

There are 2 "Nodes" (i.e. subfolders) in the release folder, which will be used in different steps:

Firmware: a UF2 file DescriptiveName.UF2 To be used in STEP 2

Drag_and_Drop: the libraries and software for Cato operation To be Used in STEP 3

In this step, we ensure your Cato is in the correct mode before continuing

1. Plug your Cato into your computer with a USB-C Cable

   • (NOTE: Not all USB-C Cables are capable of data-transfer, so use one that is not a power-only cable)

2. If you are not updating firmware, or have a minor patch that is software only, skip to STEP 3

3. Look for the list of attached devices in file manager for your computer, or in the disk utility. Based on what you see, select the case below that applies and follow the instructions.

• Case 1: Completely Blank Cato (Internal Documentation Only)

  • When first plugged in, may not show as a connected USB Drive
  • Go To Step 2, continue as normal

• Case 2: Cato recognized as "Xiao Sense"

  • This is the "Bootloader" mode, Xiao Sense is the name of Cato's microcontroller
  • Cato is awaiting the latest firmware in this mode
  • Go To Step 2, and skip sub-step 1 (your cato is already in bootloader mode, no need to double tap reset)

• Case 3: Cato is recognized as "CircuitPy"

  • Your board is programmed with CircuitPython firmware, but isn't necessarily on the correct firmware or software
  • Go To Step 2, perform all steps as written

• Case 4: Cato is recognized as "AULI_CATO"

  • Your board is programmed with CircuitPython Firmware, but isn't necessarily updated to the latest firmware of software
  • Go To Step 2, perform all steps as written

1. Put your Cato into bootloader mode

   • Press the reset button 2x

   • Your board will restart and should show up as "Xiao Sense"

   

2. Move the provided Firmware file: (<FileName>.UF2) onto Xiao Sense

   • Cato will restart

   • It will reconnect named as either CircuitPy or AULI_CATO depending on Release Version (older versions: CircuitPy, newer versions, Auli_Cato)

3. The board is now running CircuitPython, and is ready for Cato software upload

1. Copy all the files from the Drag_And_Drop folder, include the lib folder

2. Paste all these files from Drag_And_Drop onto AULI_CATO, just like putting files on a USB drive. When prompted, select "Replace" as the action.

• Note: do not edit or unpack the /lib/ directory under Drag_And_Drop: library file structure is important for operation

At this point, your Cato should reboot, and (after a 3 second start up window) will be discoverable on Bluetooth under either a default name: Cato_[unique ID]

Or under the custom name that you set when configuring your device