A Hardware Hacking Tool with Web-Based CLI That Speaks Every Protocol
C arduinobluetoothcan-busdebuggingeepromesp32flipperzerogpiohardware-hackingi2cjtagopenocdprotocolspwmradiorfidspisubghzuartwifi
complete spi eeprom shell
Geoab5807819633
diff --git a/src/Controllers/EthernetController.cpp b/src/Controllers/EthernetController.cppindex 4d551185..5be3ff3e 100644--- a/src/Controllers/EthernetController.cpp+++ b/src/Controllers/EthernetController.cpp@@ -148,7 +148,7 @@ Resetvoid EthernetController::handleReset(){// ethernetService.disconnect();- terminalView.println("Ethernet: Interface reset. Disconnected. [NYI]");+ terminalView.println("Ethernet: Interface reset. Disconnected. [NYI].");}/*diff --git a/src/Controllers/SpiController.cpp b/src/Controllers/SpiController.cppindex e297ec54..5ab4638c 100644--- a/src/Controllers/SpiController.cpp+++ b/src/Controllers/SpiController.cpp@@ -62,8 +62,6 @@ void SpiController::handleFlash(const TerminalCommand& cmd) {EEPROM*/void SpiController::handleEeprom(const TerminalCommand& cmd) {- terminalView.println("\n[WARNING] SPI EEPROM is not fully implemented. Don't use it for real operations.");- terminalInput.waitPress();spiEepromShell.run();ensureConfigured();}diff --git a/src/Services/SpiService.cpp b/src/Services/SpiService.cppindex cc6db2ca..f0483681 100644--- a/src/Services/SpiService.cpp+++ b/src/Services/SpiService.cpp@@ -301,13 +301,19 @@ std::vector<std::vector<uint8_t>> SpiService::getSlaveData() {// #### EEPROM ######-bool SpiService::initEeprom(uint8_t mosi, uint8_t miso, uint8_t sclk, uint8_t cs, uint16_t pageSize, uint32_t memSize, uint16_t wp) {+bool SpiService::initEeprom(+ uint8_t mosi,+ uint8_t miso, uint8_t+ sclk, uint8_t cs,+ uint16_t pageSize,+ uint32_t memSize,+ uint16_t wp,+ bool small)+{if (eepromInitialized) return true;SPI.end();- csPin = cs;// Init eeprom- eeprom = EEPROM_SPI_WE(csPin);if (!eeprom.init(sclk, miso, mosi, cs, wp)) return false;// Size@@ -320,10 +326,19 @@ bool SpiService::initEeprom(uint8_t mosi, uint8_t miso, uint8_t sclk, uint8_t csEEPROM_PAGE_SIZE_256);+ if (small) {+ eeprom.setSmallEEPROM();+ }+eepromInitialized = true;return true;}+bool SpiService::probeEeprom() {+ if (!eepromInitialized) return false;+ return eeprom.probe();+}+bool SpiService::writeEeprom(uint32_t address, uint8_t value) {if (!eepromInitialized) return false;eeprom.write(address, value);diff --git a/src/Services/SpiService.h b/src/Services/SpiService.hindex 240b0a39..a5237e9f 100644--- a/src/Services/SpiService.h+++ b/src/Services/SpiService.h@@ -31,7 +31,8 @@ public:void writeFlashPatch(uint32_t address, const std::vector<uint8_t>& data, uint32_t freq);// EEPROM- bool initEeprom(uint8_t mosi, uint8_t miso, uint8_t sclk, uint8_t cs, uint16_t pageSize, uint32_t memSize, uint16_t wp=999);+ bool initEeprom(uint8_t mosi, uint8_t miso, uint8_t sclk, uint8_t cs, uint16_t pageSize, uint32_t memSize, uint16_t wp=999, bool small=false);+ bool probeEeprom();bool writeEeprom(uint32_t address, uint8_t value);uint8_t readEeprom(uint32_t address);bool writeEepromBuffer(uint32_t address, const uint8_t* data, size_t len);@@ -59,8 +60,10 @@ private:uint8_t csPin;uint32_t spiFrequency = 1000000;bool slaveConfigured = false;- EEPROM_SPI_WE eeprom;+ EEPROM_SPI_WE eeprom = EEPROM_SPI_WE(&SPI, SPI_CS_PIN, 999, 8000000);bool eepromInitialized = false;+ uint32_t eepromFrequency = 8000000;+};diff --git a/src/Shells/SpiEepromShell.cpp b/src/Shells/SpiEepromShell.cppindex a9399699..a74d3eba 100644--- a/src/Shells/SpiEepromShell.cpp+++ b/src/Shells/SpiEepromShell.cpp@@ -5,13 +5,15 @@ SpiEepromShell::SpiEepromShell(ITerminalView& view,IInput& input,ArgTransformer& argTransformer,- UserInputManager& userInputManager+ UserInputManager& userInputManager,+ BinaryAnalyzeManager& binaryAnalyzeManager) :spiService(spiService),terminalView(view),terminalInput(input),argTransformer(argTransformer),- userInputManager(userInputManager)+ userInputManager(userInputManager),+ binaryAnalyzeManager(binaryAnalyzeManager){}@@ -26,15 +28,22 @@ void SpiEepromShell::run() {// Get paramseepromSize = memoryLengths[selectedModelIndex];pageSize = pageLengths[selectedModelIndex];+ eepromModel = models[selectedModelIndex];+ size_t p = eepromModel.find('|'); // Remove everything after the first '|'+ eepromModel.resize(p);+ bool isSmall = selectedModelIndex < 3; // Models 25X010, 25X020, 25X040 are small+auto mosi = state.getSpiMOSIPin();auto miso = state.getSpiMISOPin();auto sclk = state.getSpiCLKPin();auto cs = state.getSpiCSPin();+ auto wp = 999; // Default write protect pin// Initialize EEPROM- bool ok = spiService.initEeprom(mosi, miso, sclk, cs, pageSize, eepromSize);+ bool ok = spiService.initEeprom(mosi, miso, sclk, cs, pageSize, eepromSize, wp, isSmall);if (!ok) {- terminalView.println("Failed to initialize EEPROM. Please check connections.");+ terminalView.println("\nFailed to initialize EEPROM. Please check connections.");+ terminalView.println("HOLD pin must be connected to VCC to detect EEPROM.\n");return;}@@ -45,17 +54,18 @@ void SpiEepromShell::run() {int index = userInputManager.readValidatedChoiceIndex("Select EEPROM action", actions, 0);// Quit- if (index == -1 || actions[index] == "πͺ Exit Shell") {+ if (index == -1 || actions[index] == " πͺ Exit Shell") {terminalView.println("Exiting SPI EEPROM Shell...\n");break;}// Run selected actionswitch (index) {case 0: cmdProbe(); break;- case 1: cmdRead(); break;- case 2: cmdWrite(); break;- case 3: cmdDump(); break;- case 4: cmdErase(); break;+ case 1: cmdAnalyze(); break;+ case 2: cmdRead(); break;+ case 3: cmdWrite(); break;+ case 4: cmdDump(); break;+ case 5: cmdErase(); break;default:terminalView.println("Unknown action.");break;@@ -65,7 +75,18 @@ void SpiEepromShell::run() {}void SpiEepromShell::cmdProbe() {- terminalView.println("\n[NYI] π SPI EEPROM Probe...");+ terminalView.println("\n[INFO] Probing SPI EEPROM...");++ const bool ok = spiService.probeEeprom();++ if (ok) {+ terminalView.println("\n β EEPROM detected.");+ terminalView.println(" Model :" + eepromModel);+ terminalView.println(" Size : " + std::to_string(eepromSize / 1024) + " Kbytes");+ terminalView.println(" Page Size : " + std::to_string(pageSize) + " bytes");+ } else {+ terminalView.println("\n β No EEPROM found.");+ }}void SpiEepromShell::cmdRead() {@@ -157,7 +178,7 @@ void SpiEepromShell::cmdDump() {}void SpiEepromShell::cmdErase() {- terminalView.println("\nπ£ EEPROM Erase: Writing 0x00 to entire memory...");+ terminalView.println("\nπ£ EEPROM Erase: Writing 0xFF to entire memory...");if (!userInputManager.readYesNo("Confirm erase?", false)) {terminalView.println("Erase cancelled.");@@ -166,18 +187,64 @@ void SpiEepromShell::cmdErase() {const uint32_t totalSize = eepromSize;const uint32_t blockSize = 64;- uint8_t zeros[blockSize] = {0};-+ uint8_t ff[blockSize];+ std::fill_n(ff, blockSize, 0xFF);++ terminalView.print("Erasing");for (uint32_t addr = 0; addr < totalSize; addr += blockSize) {- bool ok = spiService.writeEepromBuffer(addr, zeros, blockSize);+ bool ok = spiService.writeEepromBuffer(addr, ff, blockSize);if (!ok) {terminalView.println("\n β Write failed at 0x" + argTransformer.toHex(addr, 6));return;}// Progression feedback- if (addr % 512 == 0) terminalView.print(".");+ if (addr % 1024 == 0) terminalView.print(".");+ }++ terminalView.println("\r\n\n β EEPROM Erase Done.");+}++void SpiEepromShell::cmdAnalyze() {+ terminalView.println("\nSPI EEPROM Analyze: from 0x00000000... Press [ENTER] to stop.");++ if (!spiService.probeEeprom()) {+ terminalView.println("\n β No EEPROM found. Aborting.");+ return;+ }++ // Analyze EEPROM in chunks+ auto result = binaryAnalyzeManager.analyze(+ 0,+ eepromSize,+ [&](uint32_t addr, uint8_t* buf, uint32_t len) {+ if (!spiService.readEepromBuffer(addr, buf, len)) {+ memset(buf, 0xFF, len);+ }+ }+ );++ // Summary+ auto summary = binaryAnalyzeManager.formatAnalysis(result);+ terminalView.println(summary);++ // Secrets+ if (!result.foundSecrets.empty()) {+ terminalView.println("\n Detected sensitive patterns:");+ for (const auto& entry : result.foundSecrets) {+ terminalView.println(" " + entry);+ }+ }++ // Files+ if (!result.foundFiles.empty()) {+ terminalView.println("\n Detected file signatures:");+ for (const auto& entry : result.foundFiles) {+ terminalView.println(" " + entry);+ }+ } else {+ terminalView.println("\n No known file signatures found.");}- terminalView.println("\n β EEPROM Erase Done.");+ terminalView.println("\n β SPI EEPROM Analyze: Done.");}diff --git a/src/Shells/SpiEepromShell.h b/src/Shells/SpiEepromShell.hindex 3c88ae91..a0a375ae 100644--- a/src/Shells/SpiEepromShell.h+++ b/src/Shells/SpiEepromShell.h@@ -5,6 +5,7 @@#include "Interfaces/IInput.h"#include "Transformers/ArgTransformer.h"#include "Managers/UserInputManager.h"+#include "Managers/BinaryAnalyzeManager.h"#include "States/GlobalState.h"class SpiEepromShell {@@ -14,7 +15,8 @@ public:ITerminalView& view,IInput& input,ArgTransformer& argTransformer,- UserInputManager& userInputManager+ UserInputManager& userInputManager,+ BinaryAnalyzeManager& binaryAnalyzeManager);void run();@@ -25,17 +27,20 @@ private:IInput& terminalInput;ArgTransformer& argTransformer;UserInputManager& userInputManager;+ BinaryAnalyzeManager& binaryAnalyzeManager;GlobalState& state = GlobalState::getInstance();uint32_t eepromSize = 8192; // defaultuint16_t pageSize = 64; // default+ std::string eepromModel;const std::vector<std::string> actions = {- "π Probe EEPROM",- "π Read bytes",- "βοΈ Write bytes",- "ποΈ Dump EEPROM",- "π£ Erase EEPROM",- "πͺ Exit Shell"+ " π Probe EEPROM",+ " π Analyze EEPROM",+ " π Read bytes",+ " βοΈ Write bytes",+ " ποΈ Dump EEPROM",+ " π£ Erase EEPROM",+ " πͺ Exit Shell"};std::vector<std::string> models = {@@ -94,4 +99,5 @@ private:void cmdWrite();void cmdDump();void cmdErase();+ void cmdAnalyze();};