WiPhone firmware 0.8.27 source code
===================================

WHAT THIS IS
------------
Official source code of WiPhone firmware 0.8.27 as an Arduino sketch
(WiPhone.ino plus GUI, tinySIP, audio, LoRa, OTA and driver code, the data/
SPIFFS files, tools, CHANGELOG.txt and the WiPhone Public License v1.0).
Source files are dated 2021-04-14. It matches the 0.8.27 binary
(wiphone-firmware-0-8-27).

Licence: WiPhone Public License v1.0 (HackEDA, Inc.). Section 1.0 grants a
world-wide, royalty-free, non-exclusive licence to use, reproduce, make
available, modify and distribute the Covered Software, which it defines as
"any and all software, firmware and data released" under the licence;
section 3.0.2 requires that recipients be given a copy of the licence. The
full text is the file WiPhone_Public_License_v1.0.txt inside the firmware
source archives in this store (wiphone-firmware-source-0-8-27 and
wiphone-firmware-source-0-8-30); the licence URL cited in the source headers,
https://wiphone.io/WiPhone_Public_License_v1.0.txt, returned 404 on
2026-09-18. The changelog records that the licence was added in 0.8.26.

The firmware is an Arduino sketch built with the WiPhone Arduino core
(Arduino-ESP32 based), not an ESP-IDF project; HackEDA's GitHub repository
ESP32-WiPhone/wiphone-firmware has only ever held a README ("Currently nothing
here, just a place to keep track of issues"), so these vendor zips are the
official source releases.

APPLIES TO
----------
WiPhone (HackEDA) — boards "WiPhone N0C311" and "WiPhone Pro N0C311P" in the
Arduino core. Building for any other board is outside the vendor's
instructions.

BEFORE STARTING
---------------
- Arduino IDE 1.8 or later (vendor instructions).
- The WiPhone Arduino core: in File > Preferences add
  https://wiphone.io/static/releases/arduino_platforms/package_WiPhone_index.json
  to Additional Board Manager URLs, then install "WiPhone" from the Boards
  Manager; or use the archived core, entry wiphone-arduino-core-0-1-2. Which
  core version this source was built against is not stated in the archive.
- For data files: the arduino-esp32fs-plugin
  (https://github.com/me-no-dev/arduino-esp32fs-plugin/releases/download/1.0/ESP32FS-1.0.zip).
- The CP210x USB-UART driver and a micro-USB data cable.
- Record SIP accounts and the phonebook: "ESP32 Sketch Data Upload" overwrites
  every file in SPIFFS, and a different partition scheme overwrites flash
  (vendor warnings).

CONTENTS OF THIS ZIP
--------------------
The zip published on fubsypoly.com wraps the vendor file(s)
byte-for-byte, unmodified.

WiPhone-0.8.27.zip
    3,586,163 bytes
    SHA-256 c63eb6c9905de9382f888f5226ab4e9f789c92a08c33490ec63da8d9e6f02c2f
    The vendor's source archive, unmodified: folder WiPhone-0.8.27/ with the
    sketch, src/, data/, tools/, CHANGELOG.txt, INTERNAL_FLASH.txt and
    WiPhone_Public_License_v1.0.txt.
README.txt
    This file.
SHA256SUMS
    SHA-256 checksums of the files above.

INSTALLATION
------------
 1. Unzip and rename the folder to WiPhone (the vendor requires the project
    directory to be called "WiPhone").
 2. Open WiPhone.ino in the Arduino IDE; select the WiPhone board under Tools
    > Board. The default partition scheme is two 6.5 MB application slots and
    3.6 MB SPIFFS.
 3. Connect the phone and press Upload.
 4. Only if the data files are wanted (ringtone, background, default
    settings): Tools > ESP32 Sketch Data Upload. This erases the phone's
    SPIFFS contents.

VERIFYING
---------
Menu > Settings > Firmware settings shows "Device version"; it should read
0.8.27 (FIRMWARE_VERSION in config.h).

IF SOMETHING GOES WRONG
-----------------------
- A failed upload is repeated; the ESP32 ROM bootloader is not affected by a
  bad sketch.
- Force a shutdown by holding the power button for 10 seconds.
- If a phone boots an older image after an upload, it is running the other OTA
  slot; see the binary entries' READMEs (boot_app0.bin at 0xe000).

DOWNGRADING
-----------
Uploading older source is a normal serial upload; the same caveats as the
binary entries apply (no OTA downgrade; settings compatibility between
versions is not documented).

PROVENANCE
----------
- File: WiPhone-0.8.27.zip
- Retrieved from:
  https://wiphone.io/static/releases/firmware/WiPhone-0.8.27.zip
- Wayback copy: none found (the file was never captured)
- Date retrieved: 2026-09-18
- Official page: https://wiphone.io/docs/WiPhone/latest/technical_manual/software/programming_manual.html
- Status: verified (vendor download from the vendor's firmware server)

Not captured by the Wayback Machine. Its top-level folder entry is dated
2024-03-05, the same day as the re-packed 0.8.30 archive, so the vendor may
also have re-packed this one; no earlier copy was found to compare.

MORE INFORMATION
----------------
- https://radios.fubsypoly.com/wiphone/
- https://radios.fubsypoly.com/wiphone/vol-3/ (Configuration & Firmware)
- Firmware Updates (OTA): https://wiphone.io/docs/WiPhone/latest/user_manual/OTA.html
- Firmware Download Tool Instructions: https://wiphone.io/docs/WiPhone/latest/technical_manual/software/download_tool_instructions.html
- Programming Instructions (Arduino): https://wiphone.io/docs/WiPhone/latest/technical_manual/software/programming_manual.html
- Custom Firmware Server example: https://wiphone.io/docs/Examples/latest/FirmwareServer.html
