Go to file

OpenClaw (Siggi) 0e3463df39 Complete documentation update for UT project

Major changes based on user requirements:

1. Board identification: TQMa6UL (from sticker TQMA6U-AB)
   - Old code reference 'tqma6x' = generic i.MX6 family
   - Machine: tqma6ulx-mba6ulx

2. Build name: UT (Universität/Projekt)
   - All documentation updated with UT branding
   - Build directory: build_ut

3. ci-meta-tq workflow:
   - Replaced manual layer cloning with official TQ CI repo
   - Uses git submodules for all layers
   - ci/fill_mirror script for mirror population

4. License tables in 3 formats:
   - CSV: UT-license-table.csv
   - Markdown: license-summary.md
   - Excel-compatible: UT-license-table-excel.md

5. Air-gap deployment:
   - Complete offline build instructions
   - /srv/yocto/ premirror setup
   - BB_NO_NETWORK configuration

6. 2038 compliance:
   - Verified: Kernel 6.6 + glibc 2.38
   - 64-bit time_t on 32-bit ARM
   - Scarthgap 5.0 LTS confirmed suitable

All documents ready for mirror creation and approval process.

2026-03-01 18:45:19 +00:00

docs

Complete documentation update for UT project

2026-03-01 18:45:19 +00:00

README.md

Initial documentation for TQMa6UL Yocto mirror project

2026-03-01 18:39:21 +00:00

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

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 for complete breakdown.

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