-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
183 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,2 +1,184 @@ | ||
| # Kme900_Auto_ESP32_S2 | ||
| Modded Kameleon Auto Lite for PS4 9.00fw to work with ESP32-S2 chips Using Stooged project: https://github.com/stooged/ESP32-Server-900u | ||
| Modded Kameleon Auto Lite for PS4 9.00fw to work with ESP32-S2 chips Using Stooged project: | ||
|
|
||
| https://github.com/stooged/ESP32-Server-900u | ||
|
|
||
| <br> | ||
|
|
||
| This is a project designed for the <a href=https://www.espressif.com/en/products/socs/esp32-s2>ESP32-S2</a>, *<a href=https://www.espressif.com/en/products/socs/esp32-s3>ESP32-S3</a> and <a href=https://www.espressif.com/en/products/socs/esp32>ESP32</a> boards to provide a wifi http server, dns server and *<b>USB storage emulation</b>. | ||
|
|
||
| it is for the <a href=https://github.com/ChendoChap/pOOBs4>PS4 9.00 OOB Exploit</a> which is now combined with <a href=https://wololo.net/2023/12/04/psfree-webkit-exploit-for-ps4-6-00-to-9-60-and-ps5-1-00-to-5-50-quickhen-toolkit-announced/>PsFree</a>. | ||
|
|
||
|
|
||
| <br> | ||
|
|
||
| the only files required on the storage of the esp32 are the .bin payloads, everything else is handled internally including generating a list of payloads.<br> | ||
|
|
||
| you can still modify the html by uploading your own index.html, if there is no index.html on the storage the internal pages will be used.<br> | ||
|
|
||
| if you have problems compiling the sketch make sure the <a href=https://github.com/stooged/ESP32-Server-900u#libraries>ESP32 library</a> is up to date.<br> | ||
|
|
||
| the firmware is updatable via http and the payload files can be managed via http.<br> | ||
| if you select a `No OTA` partition the firmware update via http will not be available.<br> | ||
|
|
||
| you can access the main page from the userguide or the consoles webbrowser using any hostname.<br> | ||
|
|
||
|
|
||
| <br> | ||
|
|
||
| ## ESP32 Boards | ||
|
|
||
| if your board is a <a href=https://www.espressif.com/en/products/socs/esp32>ESP32</a> `the usb emulation will not be available` so you will need to wire a usb drive up to it like this project <a href=https://github.com/stooged/PS4-Server-900u>PS4-Server-900u</a> or you can manually plug and unplug a usb drive for exfathax.<br> | ||
| this is a <a href=https://github.com/stooged/ESP32-Server-900u/blob/main/Images/esp32_diag.jpg>wiring diagram</a> for the ESP32 boards. | ||
|
|
||
|
|
||
| ## ESP32-S2 Boards | ||
|
|
||
| if your board is a <a href=https://www.espressif.com/en/products/socs/esp32-s2>ESP32-S2</a> you do not need a usb drive with this project as it emulates a usb mass storage device to the console and triggers a filesystem bug to leverage the exploit(exfathax). | ||
|
|
||
|
|
||
| ## ESP32-S3 Boards | ||
|
|
||
| if your board is a <a href=https://www.espressif.com/en/products/socs/esp32-s3>ESP32-S3</a> you do not need a usb drive with this project as it emulates a usb mass storage device to the console and triggers a filesystem bug to leverage the exploit(exfathax).<br> | ||
|
|
||
| <br> | ||
|
|
||
|
|
||
| ## Libraries | ||
|
|
||
| the project is built using <b><a href=https://github.com/me-no-dev/ESPAsyncWebServer>ESPAsyncWebServer</a></b> and <b><a href=https://github.com/me-no-dev/AsyncTCP>AsyncTCP</a></b> so you need to add these libraries to arduino | ||
|
|
||
| <a href=https://github.com/me-no-dev/ESPAsyncWebServer>ESPAsyncWebServer</a><br> | ||
| <a href=https://github.com/me-no-dev/AsyncTCP>AsyncTCP</a><br> | ||
|
|
||
| <br> | ||
|
|
||
| install or update the ESP32 core by adding this url to the <a href=https://docs.arduino.cc/learn/starting-guide/cores>Additional Boards Manager URLs</a> section in the arduino "<b>Preferences</b>". | ||
|
|
||
| ` https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json ` | ||
|
|
||
| then goto the "<b>Boards Manager</b> and install or update the "<b>esp32</b>" core. | ||
|
|
||
| <br> | ||
|
|
||
| if you have problems with the board being identified/found in windows then you might need to install the <a href=https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers>USB to UART Bridge</a> drivers. | ||
|
|
||
|
|
||
| <br> | ||
|
|
||
| ## Tested Boards | ||
|
|
||
| these <a href=https://www.espressif.com/en/products/socs/esp32-s2>ESP32-S2</a> boards can be used for a plug and play setup(no wiring)<br> | ||
| <br> | ||
| 4MB boards<br> | ||
|
|
||
| :ok: <a href=https://www.wemos.cc/en/latest/s2/s2_mini.html>S2 Mini</a><br> | ||
| :ok: <a href=https://unexpectedmaker.com/tinys2>TinyS2</a><br> | ||
| :ok: <a href="https://www.adafruit.com/product/5325">Adafruit QT Py ESP32-S2</a><br> | ||
| :ok: <a href=https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/hw-reference/esp32s2/user-guide-s2-devkitc-1.html>ESP32-S2-DevKitC-1</a><br> | ||
| :ok: <a href="http://www.lilygo.cn/prod_view.aspx?TypeId=50063&Id=1320&FId=t3:50063:3">LILYGO TTGO T8 ESP32-S2 WOOR</a><br> | ||
| :ok: <a href="http://www.lilygo.cn/prod_view.aspx?TypeId=50063&Id=1300&FId=t3:50063:3">LILYGO TTGO T8 TF Card Slot</a><br> | ||
|
|
||
| 16MB boards<br> | ||
| :ok: <a href=https://feathers2.io/>FeatherS2</a><br> | ||
|
|
||
| <br> | ||
|
|
||
| <hr>these <a href=https://www.espressif.com/en/products/socs/esp32-s2>ESP32-S2</a> boards will need a usb A plug wired up to them.<br> | ||
| <br> | ||
| 4MB boards<br> | ||
|
|
||
| :ok: <a href=https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/hw-reference/esp32s2/user-guide-devkitm-1-v1.html>ESP32-S2-DevKitM-1</a> Wiring <a href=https://github.com/stooged/ESP32-Server-900u/blob/main/Images/esp32-s2-devkitm-1.jpg>Diagram</a><br> | ||
| :ok: <a href=https://docs.espressif.com/projects/esp-idf/en/latest/esp32s2/hw-reference/esp32s2/user-guide-saola-1-v1.2.html>ESP32-S2-Saola-1</a> Wiring <a href=https://github.com/stooged/ESP32-Server-900u/blob/main/Images/esp32-s2-saola-1.jpg>Diagram</a><br> | ||
| :ok: <a href=https://docs.ai-thinker.com/en/12k_development_board_esp32-s2>Ai-thinker ESP 12K</a> Wiring <a href=https://github.com/stooged/ESP32-Server-900u/blob/main/Images/ai-thinker-esp12k.jpg>Diagram</a><br> | ||
|
|
||
| <br> | ||
| <hr> | ||
|
|
||
| these <a href=https://www.espressif.com/en/products/socs/esp32-s3>ESP32-S3</a> boards can be used for a plug and play setup(no wiring)<br> | ||
|
|
||
| :ok: <a href=https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitc-1.html>ESP32-S3-DevKitC-1</a><br> | ||
|
|
||
| <br> | ||
|
|
||
| ## Uploading to board | ||
|
|
||
| installation is simple you just use the arduino ide to flash the sketch/firmware to the esp32 board.<br> | ||
| <br> | ||
| next you connect to the wifi access point with a pc/laptop, <b>PS4_WEB_AP</b> is the default SSID and <b>password</b> is the default password.<br> | ||
| then use a webbrowser and goto http://10.1.1.1/admin.html <b>10.1.1.1</b> is the defult webserver ip or http://ps4.local<br> | ||
| on the side menu of the admin page select <b>File Uploader</b> and then click <b>Select Files</b> and locate the <b>data</b> folder inside the <b>ESP32_Server_900u</b> folder in this repo and select all the files inside the <b>data</b> folder and click <b>Upload Files</b> | ||
| you can then goto <b>Config Editor</b> and change the password for the wifi ap. | ||
|
|
||
|
|
||
| alternatively if you install this <a href=https://github.com/stooged/arduino-esp32fs-plugin>plugin</a> to the arduino ide you can upload the files to the board storage with the arduino ide by selecting <b>Tools > ESP32 Sketch Data Upload</b> | ||
|
|
||
| <a href=https://github.com/stooged/arduino-esp32fs-plugin>Arduino ESP32-S2 filesystem uploader</a> | ||
|
|
||
| <img src=https://github.com/stooged/ESP32-Server-900u/blob/main/Images/dataup.jpg><br><br> | ||
|
|
||
| the files uploaded using this method are found in the <b>data</b> folder inside the <b>ESP32_Server_900u</b> folder. | ||
|
|
||
| <br> | ||
|
|
||
|
|
||
|
|
||
| ## Internal pages | ||
|
|
||
| * <b>admin.html</b> - the main landing page for administration. | ||
|
|
||
| * <b>index.html</b> - if no index.html is found the server will generate a simple index page and list the payloads automatically. | ||
|
|
||
| * <b>info.html</b> - provides information about the esp board. | ||
|
|
||
| * <b>upload.html</b> - used to upload files(<b>.bin</b>) to the esp board for the webserver. | ||
|
|
||
| * <b>update.html</b> - used to update the firmware on the esp board (<b>fwupdate.bin</b>). | ||
|
|
||
| * <b>fileman.html</b> - used to <b>view</b> / <b>download</b> / <b>delete</b> files on the internal storage of the esp board. | ||
|
|
||
| * <b>config.html</b> - used to configure wifi ap and ip settings. | ||
|
|
||
| * <b>format.html</b> - used to format the internal storage of the esp board. | ||
|
|
||
| * <b>reboot.html</b> - used to reboot the esp board | ||
|
|
||
|
|
||
| <br><br> | ||
|
|
||
|
|
||
|
|
||
| ## Cases | ||
|
|
||
| i have created some basic printable cases for the following boards.<br> | ||
| these cases can be printed in PLA without supports. | ||
|
|
||
| ### ESP32-S2 Boards | ||
|
|
||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/Adafruit_QT_Py>Adafruit QT Py</a><br> | ||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/UM_FeatherS2>UM FeatherS2</a><br> | ||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/UM_TinyS2>UM TinyS2</a><br> | ||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/Wemos_S2_Mini>Wemos S2 Mini</a><br> | ||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/DevKitM_1>DevKitM-1</a><br> | ||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/ESP32_S2_Saola_1>ESP32-S2-Saola-1</a><br> | ||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/LILYGO_TTGO_T8_TF_Card_Slot>LILYGO-TTGO-T8-TF-Card-Slot</a><br> | ||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/LILYGO_TTGO_T8_WOOR>LILYGO-TTGO-T8-WOOR</a><br> | ||
|
|
||
|
|
||
|
|
||
| ### ESP32-S3 Boards | ||
|
|
||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/S3_DevKitC_1>S3_DevKitC_1</a><br> | ||
|
|
||
|
|
||
| ### ESP32 Boards | ||
|
|
||
| <a href=https://github.com/stooged/ESP32-Server-900u/tree/main/3D_Printed_Cases/NodeMCU_32>NodeMCU-32</a><br> | ||
|
|
||
| <br> | ||
|
|
||
| if you wish to edit the cases you can import the `.stl` files into <a href=https://www.tinkercad.com/>Tinkercad<a/> and edit them to suit your needs. | ||
|
|
||
| <br> | ||
|
|
||
|
|