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.
This commit is contained in:
19
docs/03-license-analysis/UT-license-table-excel.md
Normal file
19
docs/03-license-analysis/UT-license-table-excel.md
Normal file
@@ -0,0 +1,19 @@
|
||||
Package|Version|Recipe|License|MilitaryUse|SourceLocation|Notes
|
||||
---|---|---|---|---|---|---
|
||||
linux-yocto|6.6.y|linux-yocto_6.6|GPL-2.0-only|Yes|sources/poky/meta/recipes-kernel/linux/|Kernel with 2038 support
|
||||
u-boot-tq|2023.10|u-boot-tq_2023.10|GPL-2.0+|Yes|sources/meta-tq/recipes-bsp/u-boot/|Bootloader
|
||||
glibc|2.38|glibc_2.38|LGPL-2.1+|Yes|sources/poky/meta/recipes-core/glibc/|C library with 64-bit time_t
|
||||
busybox|1.36.1|busybox_1.36|GPL-2.0-only|Yes|sources/poky/meta/recipes-core/busybox/|Core utilities
|
||||
systemd|254|systemd_254|LGPL-2.1+|Yes|sources/poky/meta/recipes-core/systemd/|Init system
|
||||
e2fsprogs|1.47.0|e2fsprogs_1.47|GPL-2.0+|Yes|sources/poky/meta/recipes-devtools/e2fsprogs/|Filesystem tools
|
||||
iptables|1.8.9|iptables_1.8|GPL-2.0+|Yes|sources/poky/meta/recipes-extended/iptables/|Firewall
|
||||
openssl|3.1.4|openssl_3.1|Apache-2.0|Yes|sources/poky/meta/recipes-connectivity/openssl/|Crypto library
|
||||
dropbear|2022.83|dropbear_2022.83|MIT|Yes|sources/poky/meta/recipes-core/dropbear/|SSH server
|
||||
util-linux|2.39|util-linux_2.39|GPL-2.0+|Yes|sources/poky/meta/recipes-core/util-linux/|System utilities
|
||||
gcc|13.2|gcc_13.2|GPL-3.0+|Review|sources/poky/meta/recipes-devtools/gcc/|Compiler suite
|
||||
binutils|2.40|binutils_2.40|GPL-3.0+|Review|sources/poky/meta/recipes-devtools/binutils/|Linker/assembler
|
||||
coreutils|9.3|coreutils_9.3|GPL-3.0+|Review|sources/poky/meta/recipes-core/coreutils/|Core GNU utils
|
||||
bash|5.2|bash_5.2|GPL-3.0+|Review|sources/poky/meta/recipes-extended/bash/|Shell
|
||||
imx-firmware|N/A|firmware-imx|NXP-SLA|Review|sources/meta-tq/recipes-bsp/firmware/|NXP firmware blobs
|
||||
imx-gpu-viv|6.4.11|imx-gpu-viv|Proprietary|Review|sources/meta-tq/recipes-graphics/|Vivante GPU driver
|
||||
linux-firmware|N/A|linux-firmware|Various|Review|sources/poky/meta/recipes-kernel/linux-firmware/|Various vendor blobs
|
||||
18
docs/03-license-analysis/UT-license-table.csv
Normal file
18
docs/03-license-analysis/UT-license-table.csv
Normal file
@@ -0,0 +1,18 @@
|
||||
Package,Version,Recipe,License,LicenseFile,MilitaryUse,SourceLocation,Notes
|
||||
linux-yocto,6.6.y,linux-yocto_6.6,GPL-2.0-only,COPYING,Yes,sources/poky/meta/recipes-kernel/linux/,Kernel with 2038 support
|
||||
u-boot-tq,2023.10,u-boot-tq_2023.10,GPL-2.0+,Licenses/README,Yes,sources/meta-tq/recipes-bsp/u-boot/,Bootloader
|
||||
glibc,2.38,glibc_2.38,LGPL-2.1+,LICENSES,Yes,sources/poky/meta/recipes-core/glibc/,C library with 64-bit time_t
|
||||
busybox,1.36.1,busybox_1.36,GPL-2.0-only,LICENSE,Yes,sources/poky/meta/recipes-core/busybox/,Core utilities
|
||||
systemd,254,systemd_254,LGPL-2.1+,LICENSE.LGPL2.1,Yes,sources/poky/meta/recipes-core/systemd/,Init system
|
||||
e2fsprogs,1.47.0,e2fsprogs_1.47,GPL-2.0+,NOTICE,Yes,sources/poky/meta/recipes-devtools/e2fsprogs/,Filesystem tools
|
||||
iptables,1.8.9,iptables_1.8,GPL-2.0+,COPYING,Yes,sources/poky/meta/recipes-extended/iptables/,Firewall
|
||||
openssl,3.1.4,openssl_3.1,Apache-2.0,LICENSE,Yes,sources/poky/meta/recipes-connectivity/openssl/,Crypto library
|
||||
dropbear,2022.83,dropbear_2022.83,MIT,LICENSE,Yes,sources/poky/meta/recipes-core/dropbear/,SSH server
|
||||
util-linux,2.39,util-linux_2.39,GPL-2.0+,COPYING,Yes,sources/poky/meta/recipes-core/util-linux/,System utilities
|
||||
gcc,13.2,gcc_13.2,GPL-3.0+,COPYING3,Review,sources/poky/meta/recipes-devtools/gcc/,Compiler suite
|
||||
binutils,2.40,binutils_2.40,GPL-3.0+,COPYING3,Review,sources/poky/meta/recipes-devtools/binutils/,Linker/assembler
|
||||
coreutils,9.3,coreutils_9.3,GPL-3.0+,COPYING,Review,sources/poky/meta/recipes-core/coreutils/,Core GNU utils
|
||||
bash,5.2,bash_5.2,GPL-3.0+,COPYING,Review,sources/poky/meta/recipes-extended/bash/,Shell
|
||||
imx-firmware,N/A,firmware-imx,NXP-SLA,SLA,Review,sources/meta-tq/recipes-bsp/firmware/,NXP firmware blobs
|
||||
imx-gpu-viv,6.4.11,imx-gpu-viv,Proprietary,EULA,Review,sources/meta-tq/recipes-graphics/,Vivante GPU driver
|
||||
linux-firmware,N/A,linux-firmware,Various,LICENCE,Review,sources/poky/meta/recipes-kernel/linux-firmware/,Various vendor blobs
|
||||
|
154
docs/03-license-analysis/license-summary.md
Normal file
154
docs/03-license-analysis/license-summary.md
Normal file
@@ -0,0 +1,154 @@
|
||||
# License Compliance Table - UT Project
|
||||
|
||||
**Project:** UT (Universität/Projekt)
|
||||
**Target:** TQMa6UL Yocto BSP
|
||||
**Date:** 2026-03-01
|
||||
**Scope:** Complete license analysis for military use approval
|
||||
|
||||
---
|
||||
|
||||
## Military Use Guidelines
|
||||
|
||||
- ✅ **Approved**: Open source licenses without military restrictions
|
||||
- ⚠️ **Review Required**: Check specific license terms
|
||||
- ❌ **Excluded**: Explicit military use prohibition
|
||||
|
||||
**Note:** GPL licenses are approved WITH source code provision requirement.
|
||||
|
||||
---
|
||||
|
||||
## License Summary by Category
|
||||
|
||||
### Approved for Military Use (✅)
|
||||
|
||||
| License | Type | Notes |
|
||||
|---------|------|-------|
|
||||
| MIT | Permissive | No restrictions |
|
||||
| BSD-2-Clause | Permissive | No restrictions |
|
||||
| BSD-3-Clause | Permissive | No restrictions |
|
||||
| Apache-2.0 | Permissive | Patent grant included |
|
||||
| ISC | Permissive | No restrictions |
|
||||
| GPL-2.0-only | Copyleft | Source must be provided |
|
||||
| GPL-2.0-or-later | Copyleft | Source must be provided |
|
||||
| LGPL-2.1-only | Weak Copyleft | Library source must be provided |
|
||||
| LGPL-2.1-or-later | Weak Copyleft | Library source must be provided |
|
||||
|
||||
### Requires Review (⚠️)
|
||||
|
||||
| License | Reason | Action |
|
||||
|---------|--------|--------|
|
||||
| GPL-3.0 | Anti-tivoization clause | Legal review |
|
||||
| Proprietary | Closed source | Review vendor terms |
|
||||
| Binary Firmware | No source available | Check distribution rights |
|
||||
|
||||
### Build System (Not in Final Product)
|
||||
|
||||
| Component | License | Notes |
|
||||
|-----------|---------|-------|
|
||||
| Poky/Yocto | MIT | Build system only |
|
||||
| BitBake | GPL-2.0 | Build tool only |
|
||||
| OpenEmbedded | MIT | Metadata only |
|
||||
|
||||
---
|
||||
|
||||
## Key Packages for TQMa6UL
|
||||
|
||||
### Core System (GPL/LGPL)
|
||||
|
||||
| Package | Version | License | Military | Source Included |
|
||||
|---------|---------|---------|----------|-----------------|
|
||||
| linux-yocto | 6.6.y | GPL-2.0-only | ✅ Yes | ✅ Yes |
|
||||
| u-boot-tq | 2023.10 | GPL-2.0+ | ✅ Yes | ✅ Yes |
|
||||
| glibc | 2.38+ | LGPL-2.1+ | ✅ Yes | ✅ Yes |
|
||||
| busybox | 1.36.x | GPL-2.0-only | ✅ Yes | ✅ Yes |
|
||||
| gcc | 13.x | GPL-3.0+ | ⚠️ Review* | ✅ Yes |
|
||||
|
||||
*GPL-3.0 requires review of anti-tivoization clause for embedded devices
|
||||
|
||||
### Hardware Support
|
||||
|
||||
| Package | License | Military | Notes |
|
||||
|---------|---------|----------|-------|
|
||||
| firmware-imx | Proprietary | ⚠️ Review | NXP firmware blobs |
|
||||
| linux-firmware | Mixed | ⚠️ Review | Various vendors |
|
||||
| imx-gpu-viv | Proprietary | ⚠️ Review | Vivante GPU driver |
|
||||
|
||||
### Base System
|
||||
|
||||
| Package | License | Military |
|
||||
|---------|---------|----------|
|
||||
| systemd | LGPL-2.1+ | ✅ Yes |
|
||||
| util-linux | GPL-2.0+ | ✅ Yes |
|
||||
| e2fsprogs | GPL-2.0+ | ✅ Yes |
|
||||
| coreutils | GPL-3.0+ | ⚠️ Review |
|
||||
| bash | GPL-3.0+ | ⚠️ Review |
|
||||
|
||||
### Network
|
||||
|
||||
| Package | License | Military |
|
||||
|---------|---------|----------|
|
||||
| iptables | GPL-2.0+ | ✅ Yes |
|
||||
| iproute2 | GPL-2.0+ | ✅ Yes |
|
||||
| openssl | OpenSSL | ✅ Yes |
|
||||
| openssh | OpenSSH/ISC | ✅ Yes |
|
||||
| dropbear | MIT | ✅ Yes |
|
||||
|
||||
### Filesystems
|
||||
|
||||
| Package | License | Military |
|
||||
|---------|---------|----------|
|
||||
| mtd-utils | GPL-2.0+ | ✅ Yes |
|
||||
| dosfstools | GPL-3.0+ | ⚠️ Review |
|
||||
| e2fsprogs | GPL-2.0+ | ✅ Yes |
|
||||
|
||||
---
|
||||
|
||||
## Proprietary Components Requiring Review
|
||||
|
||||
### NXP/Freescale Components
|
||||
|
||||
| Component | License Type | Military Use | Source Available |
|
||||
|-----------|--------------|--------------|------------------|
|
||||
| imx-firmware | NXP SLA | ⚠️ Review required | ❌ No |
|
||||
| imx-gpu-viv | Proprietary | ⚠️ Review required | ❌ No |
|
||||
| imx-vpu | Proprietary | ⚠️ Review required | ❌ No |
|
||||
| ddr-stress-test | NXP | ⚠️ Review required | ❌ No |
|
||||
|
||||
### Alternative Open-Source Options
|
||||
|
||||
Where proprietary components pose issues:
|
||||
|
||||
| Proprietary | Open Alternative | License |
|
||||
|-------------|------------------|---------|
|
||||
| imx-gpu-viv (Vivante) | etnaviv | MIT/GPL |
|
||||
| NXP VPU codec | Software decode | Various |
|
||||
|
||||
---
|
||||
|
||||
## License Manifest Location
|
||||
|
||||
After build, license information is located at:
|
||||
|
||||
```
|
||||
build_ut/tmp/deploy/licenses/
|
||||
├── package/ # Per-package license files
|
||||
├── image_license.manifest # Image-level manifest
|
||||
├── host-tools_license.manifest # Host tool licenses
|
||||
└── target-tools_license.manifest # Target tool licenses
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Compliance Checklist
|
||||
|
||||
- [ ] All GPL packages have source code archived
|
||||
- [ ] Proprietary components reviewed for military clauses
|
||||
- [ ] License manifest generated for every build
|
||||
- [ ] No "UNKNOWN" license entries in manifest
|
||||
- [ ] Commercial licenses documented separately
|
||||
|
||||
---
|
||||
|
||||
**Generated by:** Siggi ⚙️
|
||||
**Project:** UT
|
||||
**Date:** 2026-03-01
|
||||
Reference in New Issue
Block a user