Repository files navigation

Custom flash software for Flipper Dev Board exposing the WIFI and HTTP methods via serial (UART) that can be picked up by the flipper zero device for building web enabled applications.

*image taken fromhttps://docs.flipper.net/development/hardware/wifi-developer-board/schematics

• Connect / Disonnect to WiFi networks
• List available WiFi networks
• Make HTTP GET, POST, PATCH and STREAM requests
• Custom HTTP request builder with all the methods GET, POST, HEAD, DELETE, PATCH, PUT, attach custom headers (Authorization), show and hide response headers
• Stream serial responses for large payloads.
• UDP communication, send commands and messages over the network via UDP packets
• LED indicators for different states

After you establish wifi the board listens to UDP packets you can use mobile apps (with TCP/UDP) or use cmd line tools likeecho -n "GET https://api.spacexdata.com/v3/rockets" | nc -u 192.168.0.115 1234.

The board will transmit the local port and into the serial

You can also send custom messages to the flipper, type MESSAGE: for transmitting whatever you want to your flipper device.

You can use thehttps://github.com/cool4uma/UART_Terminal to communicate directly with the board. You don't have to writehttps:// it will be auto added by the board.

Communication via usb to flipperzero (GPIO->USB-UART Bridge) with Arduino Ide Serial Monitor

0. Git clone the project
1. InstallArduino IDE
2. Arduino IDE -> Settings (Preferences)

Copy and paste thehttps://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

3. Wait for installation
4. Arduino IDE -> Tools -> Board -> Board Manager -> look foresp32 by Expressif systems and install
5. Arduino IDE -> Tools -> Manage Libraries -> find ArduinoJSON package and install
6. Arduino IDE -> Select Board -> choose esp32s2 dev board

UART Terminal Application. You can also connect flipper to your computer via usb cable then enter GPIO and enable the UART-USB Bridge to communicate directly to board via Arduino IDE Serial Monitor orminicom cmd line program

7. Set the SSID and password for the WiFi connection using theSET_SSID andSET_PASSWORD commands.
8. Activate the WiFi connection using theACTIVATE_WIFI command.
9. Use theGET,POST, orGET_STREAM commands to make HTTP requests.
10. Build custom HTTP requests using theBUILD_HTTP_* commands.
11. Execute custom HTTP requests using theEXECUTE_HTTP_CALL command.
12. Use the? orHELP commands to print help information.

This section provides detailed information about the available commands, their descriptions, arguments, responses, and response types. It also includes the possible serial responses that the receiver can expect.

To set the SSID for the WiFi connection:

SET_SSID MyWiFiNetwork

To make an HTTP GET request:

GET https://api.example.com/data

To make an HTTP GET request and stream the response:

GET_STREAM https://api.example.com/data

To make an HTTP POST request with a JSON payload:

POST https://api.example.com/data {"key":"value"}

The firmware holds a http config you can manipulate and then execute the call.Check the flags in the table above.

HTTP builder if set for showing headers will only transmit the headers from this list"Content-Type", "Content-Length", "Connection", "Date", "Server"

BUILD_HTTP_METHOD HEADBUILD_HTTP_URLhttps://api.com/EXECUTE_HTTP_CALL

When you send aGET_STREAM command, you will receive the following responses:

GET_STREAM request to: https://api.example.com/dataSTREAM:<streamed data>STREAM_END

When you list available WiFi networks:

WIFI_LIST: Available WiFi networks: <list>

• The firmware currently follow strict redirects (HTTPC_STRICT_FOLLOW_REDIRECTS - strict RFC2616, only requests using GET or HEAD methods will be redirected (using the same method), since the RFC requires end-user confirmation in other cases.)
• Website crawls will print html only on smaller websites.
• You should be able to stream files and images to flipper via stream (untested)
• Simple get call will make a head call first and determine the possible size of the content, that will not always be possible, if the content length is unknown, firmware will choose safer stream method

• ESP32 Arduino Setup
• ESP-IDF
• ESP32S2 Specs

Author: SpaceGhost @ spaceout.pl