slitaz-arm view README @ rev 207

tazbian: check for model 1 in postinstall
author Pascal Bellard <pascal.bellard@slitaz.org>
date Sat Aug 08 23:42:01 2015 +0200 (2015-08-08)
parents 7cd9a38c0e9b
children 3b857a987d2b
line source
1 SliTaz ARM
2 ================================================================================
5 SliTaz ARM tools and files
8 Build tools installation
9 --------------------------------------------------------------------------------
10 To install 'sat' and 'sat-rpi' you need to have make installed or copy the 2
11 files to /usr/bin:
13 # make install
16 Sat quickstart
17 --------------
18 Sat is a tool in the spirit of all SliTaz tools, all commands and options are
19 accessible via: sat usage or help. To create a distro you first need to have
20 some ARM packages. You can use custom cook or the one from the SliTaz mirror.
21 Put all your custom *.tazpkgs in the packages/ directory and sat will install
22 them. To use the official packages you need to sync the mirror with:
24 # sat mirror
26 Generate the distro initramfs with your custom --options:
28 # sat gen --flavor=base --kmap
30 To boot the distro with Qemu you can run:
32 # sat emu
35 ARM packages mirror
36 --------------------------------------------------------------------------------
37 Sat lets you clone the ARM cooking mirror to let you debug and try official ARM
38 packages. Sat will create a mirror directory in the working path and download
39 all lists and packages. After a first clone it will only check the repo ID
40 file and download any modified or new packages.
43 Custom SliTaz system files: rootfs/
44 --------------------------------------------------------------------------------
45 Custom SliTaz ARM scripts and files used to generate a distro. These files
46 and any other system files can be erased or added via the flavors support. The
47 rootfs files can also be directly modified before generating a new distro.
49 The rootfs/ files are all packaged into: slitaz-configs-*.tazpkg
52 CGI Admin web interface: cgi-adm/
53 --------------------------------------------------------------------------------
54 Very small and fast CGI SHell admin/info web interface for ARM devices with
55 plugins support. The goal is not to rewrite TazPanel but to have a light CGI
56 toolkit to code specific ARM devices plugins such as boot configs for the
57 Raspberry Pi. In the plugins directory you will find a skeleton to start
58 your custom plugin. You can also create general purpose or hardware specific
59 plugins.
61 The root directory is: /var/www/adm and the default web server is Busybox HTTPd.
62 So just start the web server and connect to the IP address of your machine:
64 # startd httpd
66 URL form: http://192.rpi.ip/adm/
68 On SliTaz i486 you can also use Busybox HTTPd and install the cgi-adm files
69 under /var/www and code directly then copy or upload your plugin to your ARM
70 devices.
72 # make install-cgi
75 Bugs
76 --------------------------------------------------------------------------------
77 Please report bugs on the Slitaz Bug Tracker: http://bugs.slitaz.org/
80 History
81 --------------------------------------------------------------------------------
82 While I was porting SliTaz to ARM I ended up by creating a lot of initramfs'
83 to test the SliTaz boot, packages and so on. So I first wrote a small script,
84 then improved it by just having to put include packages in a single directory
85 and all custom files in a rootfs directory. I also wanted virtual disk support
86 so I can code under Qemu and save my work. This is how sat was born, one day
87 we may use TazLito or have a new SliTaz Live tool, but for the time being 'sat'
88 and the way it works fits all my needs to build custom distros and then boot
89 with qemu-system-arm.
91 - Pankso 24 May 2012
94 ================================================================================