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