Home
Hey! This is the main location for all information relating to the flipper blackhat. The Blackhat is undergoing continuous software development, so please understand things are buggy but will improve over time. Here are some repositories and links that are required in the Getting Started guide below.
- Flipper Blackat OS - The Linux build for the Blackhat.
- Flipper Blackhat Hardware - The hardware files.
- Flipper App - The App that runs on the flipper.
First, we will flash the OS to the SD card and then ensure things come up manually with the serial port. 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...
- "USB-UART Bridge"
- Config
- Baudrate (set to 115200)
- Hit back.
Plug your flipper into your PC. On your machinee 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.
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.
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.
- Q: I'm only getting the first few lines of Linux output.
- A: Try a better/different SD card.
- I have been using Sandisk Ultra or Extreme.