ShipWr3ck Suite – Device Documentation

What is this device?

Device specifications

• Hardware: ESP32-C3 microcontroller

• Display: 0.42″ OLED (128×64, active window 72×40)

• Controls: Single button (supports external GPIO2 + onboard GPIO9 BOOT button)

• Firmware: SWK-OLED-04 (Advanced v2.0)

• Connectivity: WiFi 2.4GHz, Bluetooth Low Energy (BLE)

Features and capabilities

1. WiFi Scan

• Scans and lists nearby WiFi networks

• Shows SSID, signal strength (RSSI), encryption type, MAC address

• Supports sorting (by signal strength or name) and filtering (WPA only, open only, strong signals)

• Controls: Short press = next network, Long press = rescan, Double press = change sort mode

2. BLE Scan

• Scans and lists nearby Bluetooth Low Energy devices

• Shows device name, MAC address, signal strength

• Supports sorting and filtering

• Controls: Short press = next device, Long press = rescan, Double press = change sort mode

3. WiFi Heat

• Tracks signal strength of a selected WiFi network over time

• Real-time RSSI graph

• Dynamic display contrast based on signal strength

• Controls: Short press = select network, Long press = rescan networks

4. BLE Prox

• Tracks proximity to a selected BLE device

• Shows distance states: NEAR, FAR, WEAK, LOST

• Real-time signal graph

• Controls: Short press = select device, Long press = start/refresh tracking

5. Sys HUD

• System information display

• Shows free memory (heap), uptime, WiFi connection status

• Controls: Short/Long press = exit to menu

6. RF Meter

• Shows WiFi and BLE activity levels

• Displays count of detected access points and BLE advertisements

• Activity graph over time

• Controls: Short press = exit, Long press = rescan

7. Logs

• View recent system log entries (last 10 entries)

• Controls: Short press = exit, Long press = clear logs

8. ID Card

• Displays device MAC address, IP address (if connected), and firmware version

• Controls: Short/Long press = exit

9. Device Fingerprint

• Identifies and categorizes devices by manufacturer

• Tracks device presence history (first seen, last seen, seen count)

• Categories: Phone, Laptop, IoT, Router, Tablet, Watch, TV

• Shows average signal strength

• Controls: Short press = next device, Long press = rescan

10. People Finder

• Tracks specific devices (phones, laptops) by MAC address

• Visual radar sweep animation

• Proximity states: NEAR, FAR, WEAK, LOST

• Works with both WiFi and BLE devices

• Controls: Short press = select device/stop tracking, Long press = start tracking/rescan

11. Hidden Net

• Detects hidden WiFi networks (networks with no broadcast SSID)

• Shows MAC address, signal strength, encryption type

• Controls: Short press = next network, Long press = rescan

12. BLE Spoof

• Detects BLE devices using randomized/spoofed MAC addresses

• Shows how many times each spoofed MAC was seen

• Controls: Short press = next device, Long press = rescan

13. BLE Sniffer

• Continuously captures BLE advertisements

• Shows device names, MAC addresses, signal strength

• Circular buffer of last 30 devices

• Controls: Short press = next device, Long press = start/stop sniffing

14. Smart Home

• Identifies smart home/IoT devices

• Recognizes: Philips Hue, Sonoff, TP-Link/Kasa, Wemo, Nest, Ring, Ecobee, ESP devices

• Shows device type and signal strength

• Controls: Short press = next device, Long press = rescan

15. Auto Connect

• Automatically connects to the strongest open (unencrypted) WiFi network

• Once connected, scans and displays nearby devices (BLE and WiFi)

• Shows connected network name and IP address

• Controls: Short press = next device, Long press = reconnect/rescan

16. WPS Cracker

• Attempts to crack WiFi Protected Setup (WPS) PINs

• Brute force attempts with alphanumeric and symbol combinations

• Shows progress percentage and current PIN being tried

• Controls: Short press = select target network, Long press = start/stop cracking

17. Packet Sniffer

• Monitors WiFi packet types (Beacon, Probe, Data, ACK, Deauth)

• Shows packet counts by type

• Controls: Short press = next packet type, Long press = start/stop sniffing

18. Beacon Spoofer

• Creates fake WiFi access points

• Broadcasts custom SSID names (e.g., “Free WiFi – 1234″)

• Can be used for security testing/education

• Shows connection status and device count

• Controls: Short press = change SSID name, Long press = start/stop spoofing

19. BLE Beacon Scan

• Scans for iBeacon and Eddystone beacons

• Shows UUID, Major, Minor values, signal strength

• Controls: Short press = next beacon, Long press = rescan

20. Morse Chat (Mesh Chat)

• Sends and receives Morse code messages via ESP-NOW mesh network

• Works with other compatible devices

• Supports character picker mode or Morse code input

• Controls: Short press = dot (Morse) / next char (picker), Long press = dash (Morse) / select char (picker), Double press = switch input mode

21. Settings

• Configure device behavior:

• WiFi sort mode (RSSI desc/asc, name, none)

• BLE sort mode (RSSI desc/asc, name, none)

• WiFi filter (none, WPA only, open only, strong only)

• Show/hide graphs

• Auto scan (automatic scanning in RF Meter)

• Display contrast (150, 200, 255)

• Power save mode (disables dynamic contrast)

• Controls: Short press = next setting, Long press = change value, Double press = back to menu

How to use

Basic navigation

1. Power on: Device shows animated splash screen, then enters main menu

2. Main menu: Navigate with short press, select with long press

3. END page: Hold button to return to main menu

Button controls

• Short press (< 850ms): Navigate/next item

• Long press (≥ 850ms): Select/enter/activate

• Double press (within 400ms): Special functions (sort mode, input mode switch)

General workflow

1. Select an app from the main menu (long press)

2. Use short press to navigate options

3. Use long press to activate features (scan, connect, start tracking, etc.)

4. Press short/long to exit most apps (returns to END page)

5. Hold button on END page to return to main menu

Important notes

Legal and ethical use

• Use only on networks you own or have explicit permission to test

• Unauthorized access to networks is illegal in many jurisdictions

• This device is for security research, education, and authorized testing

Technical limitations

• WiFi range: ~50-100 meters (depends on environment)

• BLE range: ~10-30 meters

• Display: Small OLED, text scrolls automatically if too long

• Battery: Not included; requires external power supply

Best practices

• Start with WiFi Scan or BLE Scan to see what’s available

• Use Device Fingerprint to identify unknown devices

• People Finder works best when tracking devices you’ve seen before

• Settings can be customized for your preferences

Troubleshooting

• No networks found: Move to a different location, ensure WiFi/BLE is enabled

• Display blank: Check contrast in Settings, ensure power connection

• Button not responding: Try both button locations (GPIO2 external, GPIO9 onboard)

• App frozen: Hold button to return to menu, or power cycle device

Support