This project introduces how to develop, build, customize and package a Windows 10 IoT Core BSP for boards based on Allwinner aw1689(A64) SoC. Main contents:
.ffu image.ffu image Root
|-- .\loong Contains scipts&configuration files for building ffu
* |-- .\chips
* * |-- .\aw1689 aw1689(A64) model
* * * |-- .\bin
* * * * |-- .\EFI Boot Configuration Data(BCD)
* * * * |-- *.bin Legacy binaries
* * * |-- .\boot-resource boot resources(legacy)
* * * |-- .\devices Feature manifest & ACPI table
* * * * |-- .\BPI-M64 Configurations for BananaPi M64
* * * * * |-- .\acpi ACPI source code and generation directory
* * * * * * |-- .\ACPI ACPI generation directory
* * * * * * |-- .\inc Includes
* * * * * * |-- .\src Source code
* * * * * |-- .\logo Logo shown when boot
* * * * * |-- DeviceFM.xml Main device feature manifest(FM)
* * * * * |-- DeviceInfo.pkg.xml Pkg for device information
* * * * * |-- DeviceLayout.xml Partion configuration
* * * * * |-- DevicePlatform.xml Platform information
* * * * * |-- OemInput_RetailOS.xml FM file for building retail image
* * * * * |-- OemInput_TestOS.xml FM file for building test image
* * * * |-- .\default Common configurations and ACPI for aw1689 platform
* * * * |-- .\dingdong Test-inside board model
* * * * |-- .\perf2_v1_0 Test-inside board model
* * * * |-- .\pine64 Pine64 board
* * * * |-- .\r18 Test-inside board model
* * * |-- .\tools Some tools(legacy)
* |-- .\common Some common files(legacy)
* |-- .\ffu Directory for image generation
* |-- .\pctools Scripts & tools for compiling, packaging and deploying
* * |-- .\linux Scripts and tools in Linux(legacy)
* * |-- .\windows Scripts and tools in Windows
* * * |-- .\acpi
* * * * |-- .\acpi_extract.exe Tools for extracting acpi
* * * |-- .\buildscripts
* * * * |-- .\iot-adk-addonkit Reference from (https://github.com/ms-iot/iot-adk-addonkit)
* * * * |-- BuildAllAppx.cmd Build apps under .\src\app directory
* * * * |-- BuildAllComponent.cmd Build all component
* * * * |-- BuildBootloader.cmd Build bootloader(unused)
* * * * |-- BuildWindowsDrivers.cmd Build drivers and generate cabs
* * * * |-- PackAppx.cmd Generate cabs for appx
* * * * |-- PackBootloader.cmd Package bootloader
* * * * |-- PackBootresource.cmd Package resources for boot
* * * * |-- PackDeviceConfigs.cmd Package configuration files of device
* * * * |-- PackFfu.cmd Generate ffu image
* * * |-- .\UefiUpgrade Update UEFI binary separately
* * * |-- .\VirEth Debug tools for bridging virtual ethernet and USB
* * * * |-- VirEth_TH2.exe For Build 10586 1511 and previous version
* * * * |-- VirEth_RS1.exe For Build 14393 1607 and later version
* |-- .\prebuilt Contains generated cabs and UEFI binaries for building ffu image
* * |-- .\aw1689 Allwinner (aw1689)A64
* * * |-- .\CabPackages Common packages for aw1689 platform
* * * |-- .\devices Packages for differnent boards based on aw1689
|-- Build.cmd Build entry
|-- SetBuildEnv.cmd Set environment variables for building(called by Build.cmd)(1). Update OS of your PC to Windows 10 1703(build 15063) and ensure that there is enough space to install visual studio, WDK, SDK and ADK in your system partion(50GB at least).
(2). Install Visual Studio 2015
PS: Please check Universal Windows App Development Tools and its sub options and don't change the location for installation.
(3). Install Windows 10 Driver Kits(WDK)
(4). Install Windows ADK for Windows 10
(5). Install Windows 10 IoT Core Kits iso in MSDN subscription center.
PS: You need an account with msdn subscription
Run Visual Studio as Administrator. Select "File -> Open -> Project/Solution" in menu and select .\src\build\aw1689.sln solution file in explorer. Build solution and find generated drivers and cabs under .\src\build\ARM directory.
Learn how to develop Windows driver, please visit here and samples on github.
Open .\src\app\IoTDefaultApp\IoTCoreDefaultApp.sln with Visual Studio and build solution.
Learn how to develop apps for Universal Windows Platform, please visit here and samples on github.
Learn how to customize your IoT Core image, please visit here.
For your easy reference, we provide a serious of scripts to help to generate ffu. You can just run Build.cmd under root directory of the project and type a right number to excute any compiling or building operations.
For example: Type "1" to build all drivers and apps and package ffu image.
Attention: Before excuting the operation of generating ffu, ensure that you have remove all mass storage devices(USB disks or SD card) from your computer again and again. Because the dism.exe called by script will destroy your data in these devices!
After ffu generation complete, you can get the .ffu image file under .\loong\ffu for your board.
To change a board model, please modify the
DeviceNamevariable inSetBuidEnv.cmdscript.(Pine64 or BPI-M64)
For more information about developing and debugging Windows 10 IoT Core on Allwinner A64 platform, see Development Guide of Windows 10 IoT Core on A64.
Please refer to How to Flash FFU.