Debug Probe

the flipper one debug probe enables debugging of flipper one without fully disassembling the device it connects via a ribbon cable to the debug port located behind the back plate of flipper one debug probe connection to flipper one the flipper one debug probe is based on the rp2350 microcontroller its hardware design, manufacturing files, and firmware source code are fully open features the debug probe provides the following functionality debug probe for flipper one mcu (rp2350) via swd (serial wire debug) it supports cmsis dap and allows control over cpu execution, access to memory and peripherals, and programming of the mcu flash the mcu firmware vs code project is preconfigured for cmsis dap debugging, allowing you to start a debug session using debug probe immediately usb serial #1 for access to the flipper one linux terminal usb serial #2 for access to the flipper one mcu cli (command line interface) usb serial #3 for real time reading of flipper one mcu logs usb serial #4 for access to the debug probe cli (command line interface) usb gpio bridge providing access to several gpio pins of the flipper one cpu and mcu these pins can be read and write through the debug probe cli buttons and leds debug probe buttons and leds the debug probe has 2 buttons cpu reset — resets the flipper one cpu (rk3576) mcu reset & probe boot — resets the flipper one mcu (rp2350) and puts the debug probe into bootsel mode for firmware flashing the debug probe has the following leds mcu power led (3 3v) mcu uart activity leds (tx and rx) mcu io40 and io41 pin state leds cpu uart activity leds (tx and rx) cpu gpio0 d2 and gpio0 d3 pin state leds debug probe io20 pin state led connectors the flipper one debug probe has usb port for connection to a pc debug port for connecting to the flipper one debug port 5 pin header for connecting a logic analyzer or oscilloscope to cpu and mcu pins pinout of the debug port and 5 pin header on the debug probe schematics the debug probe hardware is open source and available as a public altium 365 project https //flipper 365 altium com/designs/14b8ca82 b532 4581 bf6f 641fed8af7f5 you can view and export the schematic, pcb layout, 3d model, manufacturing drawings, and bom (bill of materials) viewing the debug probe project in altium 365 firmware the flipper one debug probe firmware is open source the full firmware source code and prebuilt firmware binaries ( uf2 ) are available in the flipperone debug probe https //github com/flipperdevices/flipperone debug probe repository below are instructions on how to build the firmware docid sztz3zvgs4oloqvugz3p how to flash the firmware via usb docid sztz3zvgs4oloqvugz3p how to build firmware in this guide, you will learn how to build the firmware ( uf2 ) from source code the resulting file can be uploaded to the flipper one debug probe mcu via usb to build the firmware install visual studio code https //code visualstudio com/ , python https //www python org/downloads/ , and git https //git scm com/ open a terminal in the folder where you want to store the debug probe firmware source code clone the mcu firmware repository to your computer git clone recursive https //github com/flipperdevices/flipperone debug probe open visual studio code and go to file → open folder and select the flipperone debug probe folder you just cloned visual studio code will prompt you to install the recommended extensions click install to accept, and wait until the process is complete vs code prompt to install recommended extensions click raspberry pi pico project in the left sidebar click configure cmake click compile project after a successful build, the resulting uf2 file will be located in the flipperone debug probe/build folder how to flash firmware in this guide, you will learn how to flash the firmware ( uf2 ) to the flipper one debug probe via usb get the uf2 firmware file download the file from the repository https //github com/flipperdevices/flipperone debug probe/releases or build the file from source code docid sztz3zvgs4oloqvugz3p — if you modified the firmware switch the debug probe mcu to bootsel mode by holding the mcu reset & probe boot button while connecting the debug probe to a pc via usb switching debug probe mcu to bootsel mode after switching the debug probe mcu to bootsel mode, the device appears on your pc as a mass storage device named rp2350 if it does not appear, try a different usb cable and repeat the bootsel procedure upload the uf2 firmware file to the rp2350 mass storage device once the uf2 file upload is complete, the debug probe will automatically reboot and the mass storage device will disconnect from your pc — the ddebug probe has been successfully updated usage serial ports the flipper one debug probe is detected by the operating system as four serial ports port names and paths may vary depending on your operating system example device paths on macos port device path description baud rate port 1 /dev/tty usbmodemflip one debug2 rk3576 cpu console 1500000 port 2 /dev/tty usbmodemflip one debug4 flipper one mcu cli 230400 port 3 /dev/tty usbmodemflip one debug6 mcu debug log 230400 port 4 /dev/tty usbmodemflip one debug8 debug probe mcu cli 230400 connect to the rk3576 cpu console on macos this example shows how to connect to the rk3576 cpu console on macos we recommend using tio https //github com/tio/tio , because it is lightweight and stable you can install it with brew install tio basic connection tio b 1500000 /dev/tty usbmodemflip one debug2 connection with timestamps use timestamps to see delays between boot log lines and identify where the boot process slows down tio timestamp timestamp format 24hour delta b 1500000 /dev/tty usbmodemflip one debug2