c83d149391
Add comprehensive documentation for 2038-compliant BSP migration: - README.md: Project overview, 2038 compliance verification - 2038-problem-analysis.md: Detailed technical analysis confirming Scarthgap (5.0) provides 64-bit time_t on 32-bit ARM - step-by-step-mirror-creation.md: Complete procedure for creating offline mirror on Ubuntu 22.04 outside corporate network - license-compliance.md: License categories, approval criteria, and table templates for military use approval - corporate-network-deployment.md: Installation and build setup for air-gapped corporate environment Target: TQMa6UL-AB (i.MX6 UltraLite) on MBa6x BSP: TQ scarthgap.TQ.ARM.BSP.0006 2038 Status: Verified compliant (kernel 6.6 + glibc 2.38+) Repo: https://code.gegen.autos/openclaw/tqma6-yocto-mirror
105 lines
3.3 KiB
Markdown
105 lines
3.3 KiB
Markdown
# 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
|