A high-performance, bare-metal embedded private cloud and networked storage server built on the STM32F411 (ARM Cortex-M4).
DataVault turns an STM32 microcontroller, an ESP8266 Wi-Fi module, a MicroSD card, and an OLED display into a standalone personal cloud server. It serves a responsive, dark-mode web portal over HTTP with multi-user role-based authentication, drag-and-drop atomic file uploads, real-time file viewing/downloading, and synchronized hardware display telemetry.
Very Important Note
This case study is submitted as part of the academic requirements of the Embedded Systems course. The following details acknowledge the student contributors, academic mentor, and institutional affiliation under which this project was carried out.
| Student Name | Registration Number |
|---|---|
| SH Nihil Mukkesh | CB.SC.U4CSE24531 |
| P Dakshin Raj | CB.SC.U4CSE24534 |
| Shre Raam PJ | CB.SC.U4CSE24548 |
| Vibin Ragav S | CB.SC.U4CSE24556 |
- Mentor: Dr. A. Baskar
- Course: 23CSE304 – Embedded Systems
- Department: Department of Computer Science and Engineering
- Institution: School of Computing, Amrita Vishwa Vidyapeetham, Coimbatore, India.
The project DataVault: Mini Multi-User Networked Data Center was developed as part of the academic coursework for 23CSE304 – Embedded Systems under the guidance of Dr. A. Baskar.
The team sincerely acknowledges the academic mentorship, guidance, and institutional support provided by the Department of Computer Science and Engineering, School of Computing, Amrita Vishwa Vidyapeetham, Coimbatore, India, throughout the development of this case study.
- Overview & Core Features
- System Architecture
- Hardware Specifications & BOM
- Pinout & Hardware Wiring
- Firmware & Software Subsystems
- Web Portal Experience
- HTTP RESTful API Reference
- Power-On Self-Test (POST) Diagnostics
- Memory Footprint & Resource Utilization
- Getting Started & Build Instructions
- Troubleshooting & Diagnostics
- Repository Directory Structure
- Team Members & Credits
Traditional cloud storage systems depend on remote servers, external subscriptions, and high-power computers. DataVault demonstrates how a high-efficiency 32-bit ARM Cortex-M4 microcontroller can deliver a complete, multi-user networked storage experience in a compact, low-power embedded form factor.
- Embedded HTTP Web Server (Port 80): Fully handled via non-blocking multi-connection TCP (
AT+CIPMUX=1/AT+CIPSERVER=1,80) on the ESP8266. - FAT32 MicroSD Storage: Full filesystem capabilities powered by ChaN FatFs R0.14+ over hardware SPI1 with partition metric computation, volume size tracking, and cluster management.
- Multi-User Role-Based Access Control (RBAC):
- Admin: Full control — file browsing, downloading, live in-browser editing/creation, appending, and deletion.
- User: Standard collaboration — file browsing, downloading, editing/creation, and appending.
- Guest: Secure read-only access — public file browsing, in-browser viewing, and downloading.
- Atomic File Uploads (Up to 2 MB): Chunked data reception with progress telemetry, written to an intermediate staging file (
UPLOAD.TMP) and atomically renamed upon CRC/close verification to prevent partial-write corruption. - Live In-Browser Code & Text Viewer: Previews
.TXT,.LOG,.CSV,.HEX,.C,.H,.MD, and.DATfiles with HTML entity escaping to protect against XSS injection. - Real-Time OLED Hardware Monitor: SSD1306 128x64 display driven over I2C1 showing startup self-tests, Wi-Fi status, DHCP station IP, live file operations, and system health metrics.
- Power-On Self-Test (POST): Automatic file read-back validation at boot to confirm card health and filesystem integrity before accepting network traffic.
graph TD
subgraph "Host Microcontroller (STM32F411CEU6)"
MCU["ARM Cortex-M4 @ 100MHz<br/>512KB Flash | 128KB SRAM"]
I2C["I2C1 Controller<br/>(PB6 / PB7)"]
USART["USART2 Controller<br/>(PA2 / PA3 @ 115200 Baud)"]
SPI["SPI1 Controller<br/>(PA4 / PA5 / PA6 / PA7)"]
SYSTICK["SysTick Timer<br/>(1 ms Global Timebase)"]
MCU --- I2C
MCU --- USART
MCU --- SPI
MCU --- SYSTICK
end
subgraph "Peripherals"
OLED["SSD1306 0.96'' OLED<br/>128x64 Monochrome Display<br/>(Address: 0x3C)"]
ESP["NodeMCU ESP8266 (ESP-12E)<br/>AT Command Firmware<br/>TCP Server Engine (Port 80)"]
SD["MicroSD Card Module<br/>FAT32 File Storage<br/>(SDSC / SDHC / SDXC)"]
end
I2C -->|I2C Clock / Data @ 100kHz| OLED
USART <-->|Bidirectional Serial AT Packets| ESP
SPI <-->|Full-Duplex Block Transfers| SD
subgraph "Network & Clients"
AP["Wi-Fi Access Point / Hotspot"]
CLIENT["Web Browser / Client Device<br/>(Laptop, Phone, Tablet)"]
end
ESP <-->|802.11 b/g/n RF| AP
AP <-->|HTTP / TCP| CLIENT
graph BT
subgraph "Hardware Layer"
HW_MCU["STM32F411CEU6 Hardware Registers"]
HW_SD["MicroSD Physical Bus"]
HW_ESP["ESP8266 Serial Bus"]
HW_OLED["SSD1306 Display Controller"]
end
subgraph "Hardware Abstraction & Drivers (LL / Register)"
DRV_RCC["RCC Clock & Reset Driver"]
DRV_GPIO["GPIO Alternate Function Driver"]
DRV_SPI["Bare-Metal SPI1 Driver (sd_spi.c)"]
DRV_UART["Polled USART2 Driver"]
DRV_I2C["Hardware I2C1 Master Driver"]
end
subgraph "Middleware & Libraries"
LIB_FATFS["ChaN FatFs FAT32 Library (ff.c, diskio.c)"]
LIB_OLED["SSD1306 Font Renderer (5x7 ASCII Bitmap)"]
LIB_AUTH["RBAC Session & Hash Token Manager"]
LIB_ESP["AT Command Parser & Network Manager"]
end
subgraph "Application Layer (code.c)"
APP_HTTP["HTTP 1.1 Web Server & URL Decoder"]
APP_ROUTER["Route Dispatcher (/, /files, /read, /write, /upload, /status)"]
APP_UPLOAD["Atomic Staged File Upload Engine"]
APP_POST["Power-On Self-Test (POST) Engine"]
end
HW_MCU --> DRV_RCC
HW_MCU --> DRV_GPIO
HW_SD --> DRV_SPI
HW_ESP --> DRV_UART
HW_OLED --> DRV_I2C
DRV_SPI --> LIB_FATFS
DRV_I2C --> LIB_OLED
DRV_UART --> LIB_ESP
LIB_FATFS --> APP_HTTP
LIB_ESP --> APP_HTTP
LIB_AUTH --> APP_ROUTER
APP_HTTP --> APP_ROUTER
APP_ROUTER --> APP_UPLOAD
APP_ROUTER --> APP_POST
| Component | Specification / Part Number | Key Characteristics | Quantity |
|---|---|---|---|
| Microcontroller | STM32F411CEU6 ("BlackPill") | ARM Cortex-M4 with FPU, 512 KB Flash, 128 KB SRAM, up to 100 MHz clock | 1 |
| Wi-Fi Module | NodeMCU ESP8266 (ESP-12E / CP2102) | 802.11 b/g/n, onboard 3.3V LDO, CP2102 USB-UART, Ai-Thinker AT firmware (v1.7+), UART @ 115200 baud | 1 |
| Storage Media | MicroSD Card Module | SPI interface with onboard 3.3V LDO / buffer, supports SDSC & SDHC (FAT32) | 1 |
| MicroSD Card | 8 GB – 32 GB Class 10 | Formatted to FAT32 with 32 KB cluster size | 1 |
| Status Display | SSD1306 0.96" OLED | 128x64 resolution, I2C interface, address 0x3C, monochrome blue/white |
1 |
| Power Supply | 5V USB / 3.3V Rail (>= 800 mA) | NodeMCU includes onboard AMS1117-3.3V regulator; can be powered via Vin (5V) or 3V3 pin | 1 |
| Debugger | ST-Link V2 / CMSIS-DAP | SWD interface (SWCLK, SWDIO) for flashing and debugging |
1 |
Important
NodeMCU ESP8266 Power & Wiring: The NodeMCU development board integrates an onboard AMS1117 3.3V LDO regulator, power smoothing capacitors, and an internal pull-up on the EN (CH_PD) pin. It can be powered either from the system 3.3V rail (into 3V3) or directly from a 5V supply (into Vin or via its Micro-USB port). Unlike basic ESP-01 modules, no external pull-up resistors or jumpers are required on EN.
Tip
A scalable vector version is also available at circuit_diagram.svg for infinite zoom and high-resolution printing.
Watch the complete demonstration of DataVault, showcasing the hardware setup, Wi-Fi connectivity, multi-user authentication, file uploads, file management, and real-time OLED telemetry.
https://github.com/Dakshin10/datacenter_embedded_systems/blob/main/assets/demo_video.mp4
| Peripheral | Signal | STM32F411 Pin | Mode / Alternate Function | Electrical Characteristics | Target Device Pin |
|---|---|---|---|---|---|
| MicroSD Card | CS | PA4 |
GPIO Output (MODER=01) |
Push-Pull, High-Speed, Active LOW | CS |
| SCK | PA5 |
Alternate Function 5 (AFR[0]=5) |
Push-Pull, High-Speed (SPI1_SCK) | SCK / CLK |
|
| MISO | PA6 |
Alternate Function 5 (AFR[0]=5) |
Input with Internal Pull-Up (SPI1_MISO) | MISO / DO |
|
| MOSI | PA7 |
Alternate Function 5 (AFR[0]=5) |
Push-Pull, High-Speed (SPI1_MOSI) | MOSI / DI |
|
| SSD1306 OLED | SCL | PB6 |
Alternate Function 4 (AFR[0]=4) |
Open-Drain, Pull-Up (I2C1_SCL) | SCL |
| SDA | PB7 |
Alternate Function 4 (AFR[0]=4) |
Open-Drain, Pull-Up (I2C1_SDA) | SDA |
|
| NodeMCU ESP8266 | TX (MCU) | PA2 |
Alternate Function 7 (AFR[0]=7) |
Push-Pull, High-Speed (USART2_TX) | RX (GPIO3 / UART0_RXD) |
| RX (MCU) | PA3 |
Alternate Function 7 (AFR[0]=7) |
Input Floating (USART2_RX) | TX (GPIO1 / UART0_TXD) |
|
| Power | 3.3V / 5V |
Power Rail | Regulated 3.3V DC (or 5V to Vin) | 3V3 (or Vin) |
|
| Ground | GND |
Ground Reference | Common System Ground | GND |
|
| EN / RST | — | Internal Pull-Up on NodeMCU | Hardware enabled by default | EN (Internal 10k Pull-Up) |
|
| Debug / SWD | SWDIO | PA13 |
Dedicated Debug Port | Serial Wire Data Input/Output | ST-Link SWDIO |
| SWCLK | PA14 |
Dedicated Debug Port | Serial Wire Clock | ST-Link SWCLK | |
| Power | 3.3V | 3.3V |
Power Rail | Regulated 3.3V DC (Common VCC) | All Modules VCC |
| GND | GND |
Ground Reference | Common System Ground | All Modules GND |
All peripherals on the STM32F411 are configured directly through memory-mapped CMSIS registers without the overhead of heavy third-party HALs:
- SysTick Timer: Sourced from the processor clock, configured for 1 ms tick interrupts (
SysTick_Handler) providing monotonic time tracking (g_ms) for delays and session expiration. - GPIO Clock & Moder: AHB1 clock gating enabled for
GPIOAandGPIOB. Alternate function registers (AFR[0]) route peripherals to their corresponding pads. - I2C1 Controller: Configured for Standard Mode (100 kHz) at 16 MHz APB1 clock (
CR2=16,CCR=80,TRISE=17). Implements robust bus-busy checks, START/ADDR/TXE/BTF flag timeouts, and automatic bus recovery. - USART2 Controller: Configured for 115200 baud, 8 data bits, 1 stop bit, no parity (
CR1_TE | CR1_RE | CR1_UE), with a software circular receive buffer.
The SD card subsystem communicates over SPI1 in Motorola Mode 0 (CPOL=0, CPHA=0):
- Card Initialization Protocol:
- Sends 80+ dummy clock pulses with
CShigh to enter native SPI mode. - Sends
CMD0(Software Reset) until card replies with0x01(Idle state). - Sends
CMD8(Send Interface Condition) to query voltage compatibility (checks for0x1AApattern). - Periodically sends
ACMD41(Init Card) with HCS bit set until the card exits idle state (0x00). - Sends
CMD58(Read OCR) to distinguish between Standard Capacity (SDSC - byte addressing) and High/Extended Capacity (SDHC/SDXC - block addressing).
- Sends 80+ dummy clock pulses with
- FatFs Glue Layer (
diskio.c): Bridges the ChaN FatFs core (ff.c) withsd_spi.c. Implementsdisk_initialize,disk_status,disk_read,disk_write, anddisk_ioctl(CTRL_SYNC,GET_SECTOR_COUNT,GET_BLOCK_SIZE).
Network connectivity is established using standard AT commands:
- Initialization Sequence:
AT: Sanity ping; verifies baud rate synchronization.ATE0: Disables local echo to minimize UART buffer parsing overhead.AT+CWMODE_CUR=1: Sets station mode (STA).AT+CWJAP_CUR="SSID","PASS": Connects to the target Wi-Fi access point.AT+CIFSR: Extracts the dynamically assigned station IP address via string token parsing.AT+CIPMUX=1: Enables multiple TCP connections (links 0 to 4).AT+CIPSERVER=1,80: Starts the TCP HTTP server on port 80.
- Incoming Packet Demultiplexing: Parses incoming
+IPD,<link_id>,<len>:streams from the ESP8266, buffering HTTP request lines and handling chunked transmissions.
Security is enforced at the HTTP dispatch layer:
stateDiagram-v2
[*] --> RequestReceived: Incoming HTTP Request
RequestReceived --> ExtractCookie: Parse "session=" or "auth="
ExtractCookie --> ValidateToken: Check against Active Session Table
ValidateToken --> GuestRole: No Token / Invalid / Expired (>15m)
ValidateToken --> UserRole: Valid User Session
ValidateToken --> AdminRole: Valid Admin Session
GuestRole --> CheckRouteGuest: Route Authorization
UserRole --> CheckRouteUser: Route Authorization
AdminRole --> CheckRouteAdmin: Route Authorization
CheckRouteGuest --> ServeContent: GET /, /files, /read, /status
CheckRouteGuest --> Reject403: POST /write, /upload, /delete
CheckRouteUser --> ServeContent: GET *, POST /write, POST /upload
CheckRouteUser --> Reject403: GET /delete
CheckRouteAdmin --> ServeContent: Full Access to All Routes
Reject403 --> [*]: 403 Forbidden Response
ServeContent --> [*]: 200 OK Response
- Credential Database:
admin:Admin@2026(Role:ROLE_ADMIN)user:User@2026(Role:ROLE_USER)
- Session Tokens: 8-character hexadecimal random tokens generated using a dynamic hash seeded by hardware timer ticks and the
SysTick->VALregister. Sessions automatically time out after 15 minutes (900 seconds) of inactivity. - Path Traversal Protection (
HTTP_ValidateFilename): Strips/rejects any characters outside[a-zA-Z0-9_.-() ], disallows leading.or/, and restricts filenames to 32 characters, preventing directory traversal attacks (../).
Uploading files to flash/FAT storage over microcontrollers can risk filesystem corruption if the client disconnects halfway through. DataVault implements an atomic staging pipeline:
- When
POST /upload?name=<filename>begins, the server creates0:/UPLOAD.TMP. - As
+IPDstream buffers arrive, they are staged in a 256-byte cache and committed in block increments usingf_write(). - If the connection drops or errors,
HTTP_AbortUpload()deletesUPLOAD.TMP. - When all bytes are received and verified,
HTTP_FinishUpload()flushes the file, deletes any preexisting file with the target name, and renamesUPLOAD.TMPto the target name.
The OLED driver maintains an ASCII text renderer using an embedded 5x7 bitmap font:
- Memory Addressing: Implements Page Addressing Mode (8 pages of 128 bytes each).
- Diagnostics Display:
- Splash screen:
DATAVAULT / PRIVATE CLOUD / STM32 + FAT32 / WIFI STARTING - POST diagnostics:
SD FILE TEST / WRITE READ OK / DATA MATCH YES - Network status: Assigned IP address displayed clearly for easy browser discovery.
- Real-time activity ticker:
LOGIN OK,UPLOAD OK,DELETED,DOWNLOAD OK,RBAC BLOCKED. - System Telemetry Mirror: Mirrored live view of uptime, storage usage percentage, and active user role.
- Splash screen:
The web interface is served directly from microcontroller Flash with modern CSS styling:
- Ultra-Lightweight (~1.5 KB): Inlined vanilla CSS with zero external CDN dependencies — works completely offline on isolated local networks.
- Dark-Mode Aesthetic: Minimalist deep black
#000with subtle border contrasts (#262626), card grouping, and status badges. - Mobile-Responsive: Designed with flexible viewport tags and grid systems that scale cleanly from smartphones to desktop browsers.
Displays real-time storage metrics, volume card type, total and free space in megabytes, a dynamic HTML/CSS usage bar, a drag-and-drop file upload zone (supporting files up to 2 MB), active user role badge, and quick navigation.
+--------------------------------------------------+
| DataVault [ Admin ] [ Logout ] |
| Private Cloud |
+--------------------------------------------------+
| Storage FAT32 |
| TOTAL: 29724 MB FREE: 29540 MB |
+--------------------------------------------------+
| Upload |
| +----------------------------------------------+ |
| | Drop a file here | |
| | or tap to choose (max 2MB) | |
| +----------------------------------------------+ |
+--------------------------------------------------+
| Navigation |
| [ Files ] [ Write ] [ Status ] [ Home ] |
+--------------------------------------------------+
| Signed in as admin |
+--------------------------------------------------+
Tabulates every file stored on the MicroSD card, displaying exact file size in bytes or KB, with quick actions:
View: Opens the text/code viewer.Get: Streams binary file download to client.Del: Deletes file from card (Admin role only, with confirmation alert).
Provides real-time hardware vitals:
- Server station IP address
- System uptime (
Xh Ym Zs) - Microcontroller identifier (
STM32F411) - Storage utilization breakdown and percentage bar
- Simultaneously synchronizes and mirrors this telemetry onto the physical OLED screen!
| Method | Endpoint | Parameters / Payload | Auth Level | Responses | Description |
|---|---|---|---|---|---|
GET |
/ |
— | Any | 200 OK |
Serves main DataVault dashboard and upload portal. |
GET |
/files |
— | Any | 200 OK |
Lists files and directories on the SD card root. |
GET |
/read |
?name=<filename> |
Any | 200 OK, 400, 404, 415 |
Previews readable text/code files with HTML escaping. |
GET |
/download |
?name=<filename> |
Any | 200 OK, 400, 404 |
Streams raw binary file attachment (application/octet-stream). |
GET |
/write |
— | User, Admin | 200 OK, 403 |
Renders file creator and text editor form. |
POST |
/write |
name, mode, content, auth |
User, Admin | 200 OK, 400, 403, 500 |
Creates or appends text content to a specified file. |
POST |
/upload |
?name=<filename> + raw stream |
User, Admin | 200 OK, 400, 403, 500 |
Atomically uploads binary or text file (up to 2 MB). |
GET |
/delete |
?name=<filename>&auth=<tok> |
Admin Only | 302 Found, 400, 403, 500 |
Unlinks and deletes the specified file from the SD card. |
GET |
/status |
— | Any | 200 OK |
Returns hardware telemetry and mirrors to OLED screen. |
GET |
/login |
— | Any | 200 OK |
Renders the authentication login form. |
POST |
/login |
user, pass |
Any | 302 Found, 200 OK (fail) |
Validates credentials, sets session cookie, and redirects. |
GET |
/logout |
— | Any | 302 Found |
Invalidates active session token and clears cookie. |
During startup, the system executes a comprehensive self-diagnostic routine before entering the main loop:
sequenceDiagram
participant Boot as Reset Handler
participant OLED as SSD1306 Display
participant SD as MicroSD Card
participant ESP as ESP8266 Wi-Fi
Boot->>OLED: Initialize I2C1 & Display Splash Screen
Boot->>SD: disk_initialize(0) (SPI CMD0, CMD8, ACMD41)
alt SD Initialization Failed
Boot->>OLED: Display "SD TEST FAILED / MOUNT FAIL"
else SD Mount Successful
Boot->>SD: f_open("0:/TEST.TXT", FA_CREATE_ALWAYS | FA_WRITE)
Boot->>SD: f_write("SD card test passed!") & f_close()
Boot->>SD: f_open("0:/TEST.TXT", FA_READ) & f_read()
alt Data Match Verified
Boot->>OLED: Display "SD TEST PASSED / DATA MATCH YES"
else Data Corruption Detected
Boot->>OLED: Display "SD TEST FAILED / DATA MISMATCH"
end
end
Boot->>ESP: Send "AT" Ping over USART2 (115200 Baud)
alt No Response from ESP
Boot->>OLED: Display "ESP NOT READY / CHECK UART / PA2 PA3 GND" (Halt)
else ESP Responds OK
Boot->>ESP: Connect to Wi-Fi ("AT+CWJAP_CUR") & Query IP
Boot->>ESP: Start TCP Server ("AT+CIPSERVER=1,80")
Boot->>OLED: Display "HTTP SERVER / READY / [IP Address]"
end
The application is compiled using ARM Compiler 6 (ARMCLANG) with -Oz (extreme size optimization):
| Memory Region | Target Device Limit | Firmware Utilization | Headroom Remaining |
|---|---|---|---|
| Flash Memory (ROM) | 512 KB (0x08000000 - 0x08080000) | ~68 KB (~13.3% utilized) | > 440 KB free |
| SRAM Memory (RAM) | 128 KB (0x20000000 - 0x20020000) | ~24 KB (~18.8% utilized) | > 100 KB free |
http_request: 2048 Bytes (stores complete+IPDMTU chunk and HTTP request headers)http_response: 5200 Bytes (transmits chunked HTML output with headers)http_body: 4800 Bytes (assembles dynamic templates and directory file lists)upload_staging: 256 Bytes (intermediate flash alignment buffer for SD writes)g_sessions: 2 active slots with LRU eviction and 15-minute expiration
- Keil MDK-ARM v5.x (with Arm Compiler Version 6 enabled).
- Keil STM32F4xx DFP Pack (
Keil.STM32F4xx_DFP.2.17.1or newer). - Hardware: STM32F411CEU6 board, ESP8266 module, MicroSD SPI adapter, SSD1306 OLED, ST-Link V2.
git clone https://github.com/Dakshin10/datacenter_embedded_systems.git
cd datacenter_embedded_systemsOpen code.c and update the Wi-Fi credentials at the top of the file:
#define WIFI_SSID "Your_Hotspot_Name"
#define WIFI_PASSWORD "Your_Hotspot_Password"- Double-click
datacenter_project.uvprojxto launch Keil uVision. - Verify that ARMCLANG (Arm Compiler 6) is active under Project -> Options for Target -> Target.
- Under the C/C++ (AC6) tab, confirm optimization is set to -Oz.
- Press
F7(or click Project -> Build Target). - Ensure 0 Errors and 0 Warnings.
- Directly from Keil: Connect ST-Link and press
F8(or click Flash -> Download). - Using STM32CubeProgrammer CLI (with the pre-built
datacenter_project.hex):STM32_Programmer_CLI -c port=SWD -w datacenter_project.hex -v -rst
- Power up the board. The OLED will show the boot sequence and self-test.
- Wait for the OLED to display:
HTTP SERVER SERVER READY 192.168.X.Y - Open any web browser on a phone, laptop, or PC connected to the same Wi-Fi network and navigate to:
http://192.168.X.Y - Sign in with the Admin (
admin/Admin@2026) or User (user/User@2026) credentials to begin storing, reading, and managing your files!
| Symptom / OLED Message | Probable Root Cause | Resolution |
|---|---|---|
ESP NOT READY / CHECK UART / PA2 PA3 GND |
Baud rate mismatch or wiring issue on UART2. | Verify ESP8266 TX is connected to MCU PA3, RX to PA2, and both share a common GND. Confirm the ESP8266 firmware baud rate is 115200. |
SD TEST FAILED / MOUNT FAIL |
SPI bus wiring fault, unformatted card, or unsupported capacity. | Check SPI1 connections (PA4=CS, PA5=SCK, PA6=MISO, PA7=MOSI). Ensure the MicroSD card is formatted to FAT32 with 32 KB clusters (exFAT/NTFS are not supported). |
SD TEST FAILED / WRITE FAIL |
Write-protect lock or corrupted card cluster. | Ensure the SD card adapter write-protect switch is unlocked. Try re-formatting or testing with another card. |
| OLED Remains Blank | I2C address conflict or bus lockup. | Confirm SSD1306 I2C address is 0x3C. Ensure pull-up resistors (4.7 kΩ) are present on PB6 (SCL) and PB7 (SDA) if the OLED breakout module lacks onboard pull-ups. |
| ESP Brownout / Reboot during Wi-Fi join | Current starvation from 3.3V rail during RF transmit bursts. | Power the ESP8266 from an external 3.3V regulator capable of at least 500 mA. Add a 100 µF electrolytic capacitor across ESP8266 VCC and GND. |
CIPSERVER REJECTED / Restart |
Port 80 socket was already bound or left unclosed from a prior boot. | The firmware automatically attempts an ESP_Restart() reset routine to restore clean server link states. Power cycle if persistent. |
datacenter_embedded_systems/
├── .gitignore # Git exclusions for Keil MDK artifacts, logs, and temp files
├── README.md # Complete system engineering documentation
├── circuit_diagram.png # Rendered high-resolution circuit & wiring interconnect diagram
├── circuit_diagram.svg # Scalable vector graphics source for schematic/wiring
├── code.c # Main firmware: HTTP engine, RBAC, OLED UI, web portal
├── sd_spi.c # Low-level bare-metal SPI1 driver for MicroSD card
├── sd_spi.h # SPI command macros, card types, and return codes
├── datacenter_project.uvprojx # Keil uVision 5 project definition file
├── datacenter_project.uvoptx # Keil uVision 5 debugger and target options
├── datacenter_project.hex # Production Intel HEX binary ready for flashing
├── DebugConfig/
│ └── Target_1_STM32F411CEUx.dbgconf # Keil debugger target configuration
├── FatFs/ # ChaN FatFs FAT32 filesystem library
│ ├── diskio.c # Low-level storage interface glue layer
│ ├── diskio.h # Disk I/O function prototypes and status flags
│ ├── ff.c # FatFs core file operations implementation
│ ├── ff.h # FatFs API declarations and data structures
│ ├── ffconf.h # Filesystem configuration (buffers, LFN, code page)
│ ├── ffunicode.c # Unicode / Long Filename (LFN) lookup tables
│ └── sd_spi.h # SPI interface header binding
└── RTE/ # Keil CMSIS Run-Time Environment
├── Device/STM32F411CEUx/
│ ├── startup_stm32f411xe.s # Cortex-M4 vector table and assembly startup
│ ├── system_stm32f4xx.c # System initialization and clock configuration
│ └── STM32F401xBCDE_411xCE.dbgconf # CMSIS-DAP debugger script
└── _Target_1/
└── RTE_Components.h # Keil RTE component header
| Member | GitHub Handle | Profile Link | Role / Domain |
|---|---|---|---|
| Dakshin Raj | @Dakshin10 |
Dakshin10 | Lead Developer · Firmware Architecture, Bare-Metal Drivers & HTTP Engine |
| Nihil Mukkesh | @SH-Nihil-Mukkesh-25 |
SH-Nihil-Mukkesh-25 | Team Member · Hardware Prototyping & Module Interfacing |
| Shre Raam P J | @SHRE-RAAM-P-J |
SHRE-RAAM-P-J | Team Member · Network Protocol & Serial Communication Testing |
| Vibin R | @VibinR-code |
VibinR-code | Team Member · System Integration, Filesystem & Diagnostics |
- Course: Embedded Systems (Semester 5)
- Target Platform: STMicroelectronics STM32F411CEU6 (ARM Cortex-M4)
- Filesystem Core: ChaN FatFs by ChaN
- Wi-Fi Subsystem: NodeMCU ESP8266 (ESP-12E / CP2102) with AT Command Firmware
Built with passion for embedded hardware, bare-metal C programming, and low-power distributed systems.
