arm-sdk

os build toolkit for various embedded devices
git clone https://git.parazyd.org/arm-sdk
Log | Files | Refs | Submodules | README | LICENSE

README.md (2514B)


      1 arm-sdk
      2 =======
      3 
      4 arm-sdk is simple distro build system aimed at embedded ARM devices. It was
      5 first conceived as a component of the Devuan SDK, but now it aims to
      6 support multiple Linux distributions.
      7 
      8 ## Requirements
      9 
     10 arm-sdk is designed to be used interactively from a terminal, as well as
     11 from shell scripts. It requires the following packages to be installed, as well
     12 as [libdevuansdk dependencies](https://github.com/parazyd/libdevuansdk/blob/master/README.md#requirements):
     13 
     14 
     15 ### Devuan
     16 
     17 ```
     18 curl git wget qemu-user-static build-essential rsync gcc-arm-none-eabi gcc-multilib lib32z1 u-boot-tools device-tree-compiler lzop dosfstools vboot-utils vboot-kernel-utils libftdi-dev libfdt-dev swig libpython-dev bc bison flex libssl-dev
     19 ```
     20 
     21 ### Gentoo
     22 ```
     23 net-misc/curl net-misc/wget sys-boot/vboot-utils app-emulation/qemu(static-user) net-misc/rsync sys-libs/zlib dev-embedded/u-boot-tools sys-apps/dtc app-arch/lzop sys-fs/dosfstools sys-devel/flex sys-devel/bison
     24 ```
     25 
     26 `sudo` permissions are required for the user that is running the build.
     27 
     28 
     29 ## Quick start
     30 
     31 Edit the `config` file to match your crosscompile toolchains.  Then run
     32 zsh. In case you have conflicting extensions on your zsh configuration,
     33 safest way would be to run a vanilla one, using:
     34 
     35 ```
     36 ; zsh -f
     37 ```
     38 
     39 then step inside the sdk, "source" it:
     40 
     41 ```
     42 ; cd arm-sdk && source sdk
     43 ```
     44 
     45 Now is the time you choose the device and OS you want to build the image for.
     46 
     47 ### Currently supported distros
     48 
     49 * `devuan`
     50 
     51 ### Currently supported boards
     52 
     53 * `beagleboneblack` - BeagleBone Black
     54 * `chromeacer` - Acer ARM Chromebook
     55 * `chromeveyron` - Veyron ARM Chromebook (RK3288)
     56 * `n900` - Nokia N900
     57 * `n950` - Nokia N950
     58 * `n9` - Nokia N9
     59 * `droid` - Motorola Droid 4
     60 * `bionic` - Motorola Droid Bionic
     61 * `odroidxu` - ODROID-XU
     62 * `odroidxu4` - ODROID-XU4
     63 * `ouya` - OUYA gaming console
     64 * `raspi1` - Raspberry Pi 1 and 0 (armel)
     65 * `raspi2` - Raspberry Pi 2 and 3
     66 * `raspi3` - Raspberry Pi 3 (64bit)
     67 * `raspi4` - Raspberry Pi 4 (64bit)
     68 * `rock64` - Rock64 (64bit) (EXPERIMENTAL)
     69 * `pinephone-dontbeevil` - Pinephone Dontbeevil devkit
     70 * `pinephone` - Pine64 Pinephone
     71 * `pinetab` - Pine64 Pinetab
     72 * `sunxi` - Allwinner-based boards
     73 * `turbox-twister` - TurboX Twister tablet
     74 
     75 ```
     76 ; load devuan sunxi
     77 ```
     78 
     79 Once initialized, you can run the helper command:
     80 
     81 ```
     82 ; build_image_dist
     83 ```
     84 
     85 The image will automatically be build for you. Once finished, you will be
     86 able to find it in the `dist/` directory in arm-sdk's root.
     87 
     88 For more info, see the `doc/` directory.