LakeShark

FIELD SETUP WIKI ROADMAP

LakeShark 2.23.2 is a handheld radio on the ESP32-P4. Use an RTL-SDR or HackRF, or the onboard LR2021. Decodes P25, ADS-B, POCSAG and FM. A Flipper Zero can drive it over Bluetooth.

New, experimental: LakeShark Desktop. Every app in windows on your PC from an ESP32-P4-NANO, and LakeShark Studio for writing your own. Install it below: choose ESP32-P4-NANO LakeShark Desktop. See LakeShark Desktop

ARADIO
Which board

Select your device to see its firmware and connection steps.

Coming soon M5Stack Tab5X LakeShark support coming soon. Upcoming P4 revision

Illustrations are simplified. Check the model printed on your board.

What you need
BoardPick one above.
ReceiverAn RTL-SDR with an R820T2 or R828D tuner, or a HackRF. LR2021 boards also receive P25, FM, pagers and ADS-B without a dongle. LakeShark LR uses only the LR2021.
AntennaUse an antenna suited to the signal you want to receive.
CablesPick a board above.
Install firmware
To install, open this page in Chrome or Edge on a computer.

Choose your board above.

Flashing needs a secure connection.

It said "Failed to initialize"

The browser has one attempt at putting the board into its bootloader. Hold the BOOT button down, click Connect and install, and keep holding until it says connected. Then let go.

If that does not take, switch the board off with the slider beside the P4U port, hold BOOT, switch it back on, and click Connect and install while still holding.

Close anything else that has the port open first, such as a serial monitor or a second copy of this page. On Linux, your user needs to be in the dialout group.

The terminal route below does its own retries and does not need the button held.

New to LakeShark? Start here. This installs the P4 firmware, on a new board or over an existing install. Back up files first: a full install rewrites internal storage. A new T-Display-P4 then updates its C6 radio firmware from the SD card, with no cable: copy network_adapter.bin to /lakeshark/c6/ and use HOME > SYSTEM > UPDATE > C6 > INSTALL. See the first-flash guide.
Updating to 2.23.2: on the AMOLED build, connect in LINK, then open HOME > SYSTEM > UPDATE and choose CHECK and INSTALL. From 2.8 or earlier, install once by USB first. LakeShark LR and LakeShark NET each have their own Wi-Fi update channel. The experimental TFT build has its own Wi-Fi update channel from 2.19.1: a TFT board on 2.19.0 or older installs 2.23.2 by USB once. If both update servers are unreachable, UPDATE tries the newest GitHub release. 2.23.2 release notes.
Sending me a log when something goes wrong

The flasher can read the board's log. Nothing to install, same button, same browser.

  1. Connect the board and press Connect and install, then choose Logs & Console instead of Install.
  2. Press the board's reset, or unplug and replug its power, so the log starts from the beginning of a boot.
  3. Wait about a minute, then click Download Logs and attach the file.

The first thirty seconds after a reset are the useful part. Close any other program holding the port first, and please send the whole file rather than the lines that look relevant.

Do it from a terminal instead

With esptool installed, from the unpacked firmware bundle:

Pick a board above.

Checksums are in SHA256SUMS. Use the complete install for USB updates. Do not write later application-only updates at a fixed offset: the running app can be in either of two slots.

Slower is more reliable. If a write stalls or the board will not sync, drop the speed with --baud 460800, then --baud 115200.

Archived recovery build · T-Display-P4 C6 link
LilyGO T-Display-P4 only. Every board here reports as an ESP32-P4, so the installer cannot tell them apart. Do not use this on the LCD-4.3 or the NANO.

Use 2.23.2 above for a current install. It can keep running without Wi-Fi or Bluetooth when the C6 link fails. The P4 updates its C6 from the SD card, as the first-flash guide describes. The older workaround below is retained for reference.

This archived build stops the failed C6 link taking the board down with it. It waits about twenty seconds at boot, gives up, and carries on with no Wi-Fi or Bluetooth. The Flipper remote is Bluetooth-only on this board, so it is out too until the C6 is updated. Released builds do that over the board's own link from an SD card image, so no cable is needed. The cable steps, for a dead C6 link only, are in the flashing guide.

Connect the P4U USB-C port, as usual:

Flashing needs a secure connection.

Built from efca324, and confirmed on a board that was stuck in that loop. Once your C6 is updated, install 2.23.2 above.

Do it from a terminal instead

From the unpacked workaround bundle:

esptool --chip esp32p4 --baud 921600 write_flash   --flash_mode dio --flash_freq 80m --flash_size 16MB   0x2000    bootloader.bin   0x8000    partition-table.bin   0x10000   lakeshark.bin   0x910000  storage.bin
Archived RC · 2.1.0-rc2 · superseded

This release candidate is retained for reference. Use 2.23.2 above.

Archived release record

BFLIPPER REMOTE
OPTIONAL COMPANION

Use a Flipper Zero as a remote.

Control LakeShark from your Flipper over Bluetooth. Tune the receiver and check its status while the LakeShark device stays in your bag or on the desk.

LakeShark receives and decodes the signals. The Flipper runs the companion app and provides the buttons and display. You can also use LakeShark's touchscreen without a Flipper.

Flipper Zero remote control
FLIPPER ZERO / CONTROLS & DISPLAY / flipper.net
Set up the Flipper app
  1. On your computer, download the Flipper companion app, lakeshark_p25.fap (app 2.8, Momentum 430a3d50 / API 87.1). Copy it to /ext/apps/GPIO/ on the Flipper's SD card.
  2. Turn Bluetooth on in the Flipper's own Settings → Bluetooth. The app cannot turn it on for you.
  3. On the Flipper, open GPIO → LakeShark SDR.
  4. Inside the Flipper app: Settings → Link → Transport, set it to Bluetooth.

Keep the LakeShark receiver powered on nearby. Leave the Flipper app open while it connects. In the app, advertising means waiting for the receiver, connected means Bluetooth is connected, and linked means the control connection is ready.

Every page of the app, its buttons and all 44 screenshots are in the Flipper guide.

Keep the LakeShark SDR app open on the Flipper. Closing it ends the companion connection. The Flipper's normal Bluetooth connection is separate from this app.
Flipper shows NO SDR? Check that the LakeShark receiver is powered on, Bluetooth is enabled on the Flipper, and the app's Settings → Link → Transport is set to Bluetooth. The message alone does not identify the cause.
Wired instead of Bluetooth

Set Transport to UART and wire radio TX to Flipper RX, radio RX to Flipper TX, common GND. Do not feed the board from Flipper 5 V while it is also on USB.

CMAPS

Optional offline maps for MAP and ADS-B. On 2.23.2, open HOME > FIELD > MAP > TILES to download maps over Wi-Fi. The tools below also prepare map files for the Flipper.

Where
    Size
    ZoomGridTilesDownloadOn card
    Command

    Unzip lakeshark-maps.zip, run these in that folder. Needs Python 3.

    
                    
    
                    
                    
                    

    On the P4, put the file in /maps on the SD card. In MAP, use STYLE > Map file on the card to select a .pmtiles archive or a CartoCore map.

    On the Flipper, it goes to apps_data/lakeshark_p25/map.pmtiles. Running ZeroMesh already? Skip it.

    Map area

    Pan and zoom to frame the area you want to download.

    DPRESETS

    Made in your browser. Nothing is uploaded.

    P25 system profile

    In P25, open OPTIONS > Profile from card, or press L. Control channels from RadioReference.

    /sdcard/p25_profile.txt

    GPS scan list ยท P25 + FM

    Conventional channels. GPS selects channels by coverage. P25 profiles that carry site coordinates follow the nearest site by GPS.

    Coverage applies to all rows unless the imported file supplies its own coordinates and radius.

    Load onto the P4

    Copy nearby.lscan to the SD card. In the console, run:

    ch load /sdcard/nearby.lscan

    This replaces the saved scan list. Then open SCAN > CHANNEL LIST and turn on GPS FILTER. Use MIXED AUDIO for P25 and FM together.

    Channel memories

    One list per receiver.

    apps_data/lakeshark_p25/ch_fm.txt

    EUSING IT
    First run
    1. Attach a suitable antenna. Connect an RTL-SDR or HackRF to USB-A, or select the onboard LR2021. LakeShark LR does not use USB SDRs. Power the P4 from its own USB-C input.
    2. Start with ADS-B. No frequency to guess. Aircraft appearing means the whole chain works.
    3. Then FM, on a station you know is there. Audio proves the speaker path.
    4. P25 last. It needs a system actually on the air near you.
    Aircraft appearing confirms reception and decoding on the selected radio.
    Getting files off it

    Open the LakeShark hub in Chrome or Edge and connect by USB. FILES browses and copies files on the SD card. The hub also shows the screen and provides a console.

    When something is wrong
    Flipper says NO SDR
    Keep the Flipper app open and the LakeShark receiver powered on. Check Bluetooth and the app's Transport setting. See FLIPPER REMOTE for setup.
    No aircraft on ADS-B
    Give it two minutes, it needs an aircraft to transmit. Check the selected radio and its antenna. If using a USB SDR, connect it to USB-A host.
    "Low memory. Tap an app to retry."
    Internal RAM ran out while loading. Go back to HOME and open the app again. If it repeats, power-cycle.
    An app opens but nothing is received
    Check RADIO for the selected receiver and any reason it is unavailable. Check the frequency and antenna, and stop another app using the same radio before trying again.
    P25 shows activity but no speech
    Control-channel traffic is not voice. Valid NACs and TSBKs only mean you found the system; voice needs a talkgroup actually in use, and unencrypted.
    Source, issues and the other board targets: github.com/SAMS0N1TE/LakeShark. GPLv3. What you are allowed to listen to is local law and yours to check.