tqma6-yocto-mirror/README.md

# TQMa6UL Yocto BSP Mirror Project

**Project ID:** TQMA6-YOCTO-2038  
**Date:** 2026-03-01  
**Target Hardware:** TQMa6UL-AB (i.MX6 UltraLite) on MBa6x Carrier  
**Yocto Version:** Scarthgap (5.0) LTS  
**Objective:** Create offline mirror for software approval, ensure 2038 compliance

---

## Overview

This project addresses the requirement to migrate from legacy PTXdist-based BSP to Yocto Project for TQMa6UL hardware. The primary driver is Year 2038 compliance for military/long-term deployments.

### 2038 Problem Context

The Year 2038 Problem (Y2K38) affects 32-bit systems using signed 32-bit time_t:
- Maximum representable time: 03:14:07 UTC on 19 January 2038
- Systems will overflow and behave unpredictably after this date
- Critical for military/aerospace systems with 15+ year service life

### Solution: Yocto Scarthgap (5.0 LTS)

**Key Features:**
- 64-bit time_t by default on 32-bit ARM (glibc 2.38+)
- Linux Kernel 6.6 LTS (includes CONFIG_COMPAT_32BIT_TIME)
- Long-term support until April 2028 (extendable)
- Full source availability for audit

**2038 Compliance Verification:**
| Component | Version | 2038 Ready | Notes |
|-----------|---------|------------|-------|
| Linux Kernel | 6.6.y | ✅ | CONFIG_COMPAT_32BIT_TIME |
| glibc | 2.38+ | ✅ | 64-bit time_t default |
| Yocto | 5.0 (Scarthgap) | ✅ | Built-in 2038 support |
| TQ BSP | scarthgap.TQ.ARM.BSP.0006 | ✅ | Verified with kernel 6.6 |

---

## Repository Structure

```
tqma6-yocto-mirror/
├── docs/
│   ├── 01-analysis/           # 2038 analysis and requirements
│   ├── 02-mirror-creation/    # Step-by-step mirror creation
│   ├── 03-license-analysis/   # License compliance documentation
│   └── 04-deployment/         # Corporate network deployment
├── configs/                   # Configuration files
├── scripts/                   # Automation scripts
└── README.md                  # This file
```

---

## Quick Links

- [2038 Problem Analysis](docs/01-analysis/2038-problem-analysis.md)
- [Mirror Creation Guide](docs/02-mirror-creation/step-by-step-mirror-creation.md)
- [License Table Template](docs/03-license-analysis/license-table-template.csv)
- [Deployment Guide](docs/04-deployment/corporate-network-deployment.md)

---

## Project Status

| Phase | Status | Description |
|-------|--------|-------------|
| Analysis | ✅ Complete | 2038 compliance verified for Scarthgap |
| Documentation | 🔄 In Progress | Creating step-by-step guides |
| Mirror Creation | ⏳ Pending | Execute on Ubuntu 22.04 outside corporate network |
| License Analysis | ⏳ Pending | Generate complete license table |
| Deployment | ⏳ Pending | Install in corporate network |

---

## Hardware Target

**Board:** TQMa6UL-AB RK REV.0405  
**SoC:** NXP i.MX6 UltraLite (Cortex-A7, 32-bit)  
**Carrier:** MBa6x REV.020x  
**Key Features:**
- 528 MHz Cortex-A7
- 512MB DDR3
- 4GB eMMC
- Dual Ethernet (1G + 100M)
- Industrial temp range

**Machine Configuration:** `tqma6ulx-mba6ulx` (to be confirmed during build)

---

## License

Documentation: CC-BY-SA 4.0  
Scripts: MIT  

All Yocto and TQ BSP components follow their respective upstream licenses.
See [License Analysis](docs/03-license-analysis/) for complete breakdown.

---

**Maintainer:** Siggi ⚙️ (OpenClaw Agent)  
**Repository:** https://code.gegen.autos/openclaw/tqma6-yocto-mirror