193 lines
6.8 KiB
Plaintext
Executable File
193 lines
6.8 KiB
Plaintext
Executable File
lets create project save point in the form of a master project manifest with extra notes and code snippets and prestage instructions following directly. for a clean printable timestamp of the project before we continue since i didnt sign in
|
|
|
|
Here is your permanent project save point. This document acts as an unauthenticated, local Master Project Manifest for Project WH-1. It contains the system specification, complete structural templates, and explicit environment-staging scripts.
|
|
|
|
You can copy-paste this raw Markdown text directly into a plain text file (e.g., README.md or MANIFEST.txt) or print it out to freeze your work baseline in time.
|
|
PROJECT WH-1 MASTER MANIFEST
|
|
|
|
Timestamp Baseline: 2026-05-27 / 18:05 UTC
|
|
|
|
Target Hardware Platform: HIFI WALKER H2 (SoC: Ingenic X1000E MIPS32r2)
|
|
|
|
Host Architecture: Arch Linux Workstation
|
|
|
|
Containment State: Rootless Podman OCI Engine
|
|
|
|
Execution Context: Emulated Virtual Pipeline (QEMU System MIPS)
|
|
1. System Topology & Architecture
|
|
|
|
The layout configuration isolates compilation and software-in-the-loop validation strictly within the Arch Host ecosystem before dealing with raw physical flash logic.
|
|
|
|
+--------------------------------------------------------------------------+
|
|
| ARCH LINUX HOST ENGINE |
|
|
| |
|
|
| +-------------------------+ +-----------------------------+ |
|
|
| | PODMAN OCI CONTAINER | | QEMU SYSTEM EMULATOR | |
|
|
| | (wh-builder Image) | | (qemu-system-mipsel) | |
|
|
| | | | | |
|
|
| | [Buildroot Source] | | Simulates: | |
|
|
| | [mipsel-musl-gcc] | | - Malta Dev Board | |
|
|
| | | | - MIPS 24Kf Core | |
|
|
| +------------+------------+ | - 64MB Hard Ram Limit | |
|
|
| | +--------------^--------------+ |
|
|
| | (Outputs Assets) | |
|
|
| v | (Executes) |
|
|
| +-----------------------------------------------------+--------------+ |
|
|
| | HOST WORKSPACE SHADOW TREE (~/h2-project/workspace/) | |
|
|
| | | |
|
|
| | /buildroot/ ......... Complete compiler engine and toolchain tree | |
|
|
| | /overlay/usr/bin/ ... Injected target executables (main.c -> bin) | |
|
|
| | /images/ ............ Output target execution files (vmlinux, cpio)| |
|
|
| +--------------------------------------------------------------------+ |
|
|
+--------------------------------------------------------------------------+
|
|
|
|
2. Immutable Code Snippet Registry
|
|
Asset A: The Environment Blueprint (Dockerfile)
|
|
|
|
File Location on Host: ~/h2-project/wh-build-env/Dockerfile
|
|
Dockerfile
|
|
|
|
FROM ubuntu:22.04
|
|
|
|
ENV DEBIAN_FRONTEND=noninteractive
|
|
|
|
RUN apt-get update && apt-get install -y \
|
|
bash \
|
|
bc \
|
|
binutils \
|
|
build-essential \
|
|
bzip2 \
|
|
ca-certificates \
|
|
cpio \
|
|
g++ \
|
|
gcc \
|
|
git \
|
|
gzip \
|
|
libncurses5-dev \
|
|
make \
|
|
patch \
|
|
perl \
|
|
python3 \
|
|
rsync \
|
|
sed \
|
|
tar \
|
|
unzip \
|
|
wget \
|
|
file \
|
|
&& apt-get clean \
|
|
&& rm -rf /var/lib/apt/lists/*
|
|
|
|
RUN useradd -ms /bin/bash hacker
|
|
USER hacker
|
|
|
|
WORKDIR /home/hacker/workspace
|
|
|
|
Asset B: Target Test Entrypoint (main.c)
|
|
|
|
File Location on Host: ~/h2-project/workspace/main.c
|
|
C
|
|
|
|
#include <stdio.h>
|
|
#include <unistd.h>
|
|
|
|
int main() {
|
|
printf("\n\n========================================\n");
|
|
printf(" PROJECT WH-1: INITIAL BOOT SUCCESSFUL \n");
|
|
printf("========================================\n");
|
|
printf("The MIPS X1000E core is executing code natively.\n\n");
|
|
|
|
while(1) {
|
|
printf("[WH-1] Heartbeat active...\n");
|
|
sleep(5);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
Asset C: Cross-Compilation Pipeline Driver (Makefile)
|
|
|
|
File Location on Host: ~/h2-project/workspace/Makefile
|
|
Makefile
|
|
|
|
CC = ./buildroot/output/host/bin/mipsel-linux-musl-gcc
|
|
CFLAGS = -march=mips32r2 -mhard-float -O3 -Wall -s
|
|
TARGET = overlay/usr/bin/h2_test
|
|
SRC = main.c
|
|
|
|
all: $(TARGET)
|
|
|
|
$(TARGET): $(SRC)
|
|
@mkdir -p $(shell dirname $(TARGET))
|
|
$(CC) $(CFLAGS) $(SRC) -o $(TARGET)
|
|
@echo "----------------------------------------"
|
|
@echo "Success! Binary compiled and injected into overlay: $(TARGET)"
|
|
@echo "----------------------------------------"
|
|
|
|
clean:
|
|
rm -f $(TARGET)
|
|
|
|
Asset D: Headless Emulation Bootstrapper (run_qemu.sh)
|
|
|
|
File Location on Host: ~/h2-project/run_qemu.sh
|
|
Bash
|
|
|
|
#!/bin/bash
|
|
|
|
IMAGE_DIR="$HOME/h2-project/workspace/buildroot/output/images"
|
|
|
|
qemu-system-mipsel \
|
|
-M malta \
|
|
-cpu 24Kf \
|
|
-m 64 \
|
|
-kernel "$IMAGE_DIR/vmlinux" \
|
|
-initrd "$IMAGE_DIR/rootfs.cpio" \
|
|
-append "console=ttyS0 quiet" \
|
|
-nographic
|
|
|
|
3. Prestage Instructions (The Execution Protocol)
|
|
|
|
When you return to your Arch Linux host workstation terminal to resume active development, follow this sequence exactly to boot up your system:
|
|
Step 1: Fire up the Toolchain Engine
|
|
|
|
Initialize your rootless containment shell workspace environment:
|
|
Bash
|
|
|
|
cd ~/h2-project
|
|
podman run -it --rm -v ./workspace:/home/hacker/workspace:Z wh-builder /bin/bash
|
|
|
|
Step 2: Compile App and System Bundles
|
|
|
|
Run these compilation commands directly within your interactive container terminal prompt:
|
|
Bash
|
|
|
|
# 1. Compile your custom C payload into the filesystem shadow tree
|
|
cd /home/hacker/workspace
|
|
make -f Makefile
|
|
|
|
# 2. Trigger the Buildroot system compilation engine
|
|
cd buildroot
|
|
make
|
|
|
|
Note: To exit the container workspace cleanly when compilation is complete, simply type exit.
|
|
Step 3: Run the Non-Destructive Virtual Deployment Test
|
|
|
|
From your native Arch Linux host shell terminal prompt (outside the container environment), run the virtualization harness script:
|
|
Bash
|
|
|
|
cd ~/h2-project
|
|
./run_qemu.sh
|
|
|
|
Emulation Escape Route: To instantly kill the headless QEMU testing screen, press Ctrl + A then tap X.
|
|
4. Feature Backlog (The System Blueprint Extension)
|
|
|
|
These features are verified as theoretically viable for the H2's underlying hardware platform and are paused under BACKLOG.md:
|
|
|
|
Module A ("Vault"): Air-gapped cold cryptographic storage utilizing on-chip security registers.
|
|
|
|
Module B ("AcousticScalpel"): Ultrasonic FSK Data Modem utilizing the 20 kHz-40 kHz analog output performance capability of the ESS9218PC DAC.
|
|
|
|
Module E ("BlueStalker"): Low-level UART HCI scanning routines on the Qualcomm/CSR8811 chip for passive BLE device presence logging.
|
|
|
|
Project Save Point Confirmed.
|
|
|
|
Your workspace is completely documented. When you are ready to resume, we will drop back down to the hardware storage layers to look at how the physical MicroSD card filesystem coordinates execution handshakes. |