This is where you'll find information on using Flipper Blackhat. The Blackhat is undergoing continuous software development, so please understand things are buggy but will improve over time. Important links...

• Flipper Blackat OS - The Linux build for the Blackhat.
  • Continuous Builds
• Flipper Blackhat Hardware - The hardware files.
• Flipper App - The App that runs on the flipper.
  • Continuous Builds
  • Release

Getting Started

Getting a Shell

First, we will flash the OS to the SD card to ensure things come up. Grab the OS build from here. Flash this to your SD card using dd...

sudo dd if=~/Downloads/sdcard.img of=/dev/sdX

If you're using Windows, there are various other ways to do this I hear win32diskimager works fine.

One the SD card is flashed, navigate to the GPIO app on the Flipper. Select...

1. "USB-UART Bridge"
2. Config
3. Baudrate (set to 115200)
4. Hit back.

Plug your flipper into your PC. On your machine you should see a device at /dev/ttyACMX or maybe /dev/ttyUSBX ... or maybe /dev/tty.usbmodemX. Connect to this with a serial emulator...

screen /dev/ttyUSB0 115200

If you're on Windows, I hear Putty works fine. You should see your device at COMX, set the baud rate to 115200 and connect to it.

At this point, you should have a blank serial terminal. Plug the SD card into the Flipper Blackhat, then plug the Flipper Blackhat into the Flipper (if it's already plugged into the Flipper, unplug/replug it).

You should now see a booting Linux kernel and eventually end up with a bash shell. You should be able to execute commands like ls, mkdir etc... I recommend you play around with the bh app. This is used to control the Blackhat from the Flipper App itself.

Installing the app

Using your computer to control the Blackhat is quite silly. This is just for initial testing, development and debugging. Using the Flipper Blackhat App to control the blackhat is recommended when you're in the field.

Grab the latest release from here (blackhat_vX.fap). Open the qFlipper app...

Drag the app into the SD Card/apps directory. You should now see the app on your Flipper Zero.

Config

It's important to know there's a fat32 partition on the sdcard you flashed earlier. If you plug that card into a PC it will mount, and can configure files! This directory will get mounted at /mnt/ in Linux. You should see a file called blackhat.conf Moving forward you will be able to do a lot of config through this file.

Troubleshooting

• Q: I'm only getting the first few lines of Linux output.
• A: Try a better/different SD card. You need at least a "UHS Class 3 card"
  • I have been using Sandisk Extreme.