FoundriesFactory Documentation

The FoundriesFactory™ platform is a comprehensive tool set for building, testing, deploying, and maintaining updatable, security focused IoT and Edge products.

Combined with the Linux microPlatform (LmP) and utilizing open source software projects including U-Boot, OP-TEE, OE/Yocto Project, and Docker®, The FoundriesFactory Platform brings together key features and functions for developing professional embedded devices.

User Guide

Fioctl
- Prerequisites
- Auto Updating
- Enabling/Disabling Apps
- Inspecting Targets
- Common Commands
Qemu
- x86_64
- arm
- arm64
- riscv64
Factory & Account Management
- Factory Account Roles
- Managing Your Subscription
- Team Based Factory Access
- Setting When Devices are Considered Offline
Intellectual Property Protection
Custom CI
- Custom CI for RootFS
- Custom CI To Build Compose App Targets
Configuring Automatic Git Mirroring
- Creating Token
- Configuring GitHub
- Configuring Bitbucket
Working With Git Submodules
- Create a GitHub Repository
- Preparing the GitHub Repository
- Adding the Submodule
- Updating the Submodule Manually
- Updating the Submodule Automatically
Remote Access
- WireGuard VPN
Foundries.io REST API
- Prerequisites
- Creating Token
- Getting Started
- Device List
- Targets List
- Configure Device
- Enabling/Disabling Application
- Learning More About the REST API
Containers and Docker
- Containers
- Docker Credential Helper
- Compose Apps
- Container Preloading
- Multi-Stage Container Builds
Using Third-Party Private Container Registries
- Configuring for CI Azure Container Registry (ACR)
- Configuring CI for AWS ECR
- Configuring for CI Google Artifact Registry (GAR)
Customizing the LmP
- Building From Source
- Extending the Linux microPlatform
- LmP Customization
Auto Hostname
- Adding the Recipe
- LmP Auto Hostname Variables
- Configuring the LmP Auto Hostname
- Testing Auto Hostname
Auto Register
- Prerequisites
- Creating Token
- Enabling Recipe
- Configuring the LmP Auto Register
- Additional Configuration
- Testing Auto Register
Customizing Over the Air Updates
- Callbacks
- Custom Update Agents
- Command Line Interface - CLI (Aktualizr-lite Manual Mode)
Offline Updates
- Prerequisites
- Obtaining Offline Update Content
- Signing the Offline Update Bundle
- Performing the Offline Update
- Usage Details
- Offline Update Considerations
- Controlling the Expiration Time of the Offline Update Bundle
Disk Encryption Support
- Prerequisites
- Enabling Support for Disk Encryption
- Implementation Details for OP-TEE PKCS#11 Support
Factory Reset
- Full Factory Reset
- Partial Factory Reset
Updating the Linux microPlatform Core
- Updating Your Factory
- Verifying Your Work
- Merging Back to Development
- Common Errors and Tips
Machines with Secure Aspects Enabled by FoundriesFactory
- Supported Machines
- Enabling
- Using the Secure Machine
- Using Custom Keys
- Accessing Secure Storage
Offline Factory TUF Keys
- How to Rotate Offline TUF Root Key
- How to Rotate Offline TUF Targets Key
- How to View Offline TUF Keys
- How to Backup Offline TUF Keys
- Expert Mode
Crypto Keys Used by FoundriesFactory at Build Time
- Secure Boot Flow
- FoundriesFactory Keys
Software Bill of Materials
- SBOMs and Builds
- Working With SBOMs
- Going Further
Integrating NXP EdgeLock 2GO
- Prerequisites
- Enabling Auto-connect to Your Factory
- Optional: Enabling Devices to Connect With AWS IoT
- Creating an LmP Build With EdgeLock 2GO
- Enlisting Devices
- Testing AWS IoT
- EdgeLock 2GO Concepts
- Installing Additional Secure Objects
- Further Details
Production Targets
- Performing a Production OTA
- Advanced Usage
Details Of Device Gateway PKI Settings
- Taking Ownership of Factory PKI Using the API
- Registering Factory Devices Using the API
Rotating Device Certificate
- Choosing an EST Server
- Performing a Certificate Rotation
Troubleshooting and FAQ
- Errors and Solutions
- How Tos
- Tips and Abouts

Reference Manual

Porting Guide

Factory Porting Guide
- Introduction

Glossary

Glossary

Release Notes