fbs annotate README @ rev 3
fbsplash freezes its progressbar if fifo isn't a real fifo but plain file
| author | Aleksej Bobylev <al.bobylev@gmail.com> |
|---|---|
| date | Fri May 02 11:23:55 2014 +0000 (2014-05-02) |
| parents | 8bb34ff7b4c0 |
| children |
| rev | line source |
|---|---|
| pankso@0 | 1 Fbs - Framebuffer Boot Splash toolkit |
| pankso@0 | 2 ================================================================================ |
| pankso@0 | 3 |
| pankso@0 | 4 |
| pankso@0 | 5 Fbs is a rewrite of the old SliTaz Fbsplash tool for the SliTaz ARM and |
| paul@1 | 6 Raspberry Pi flavors. SliTaz ARM uses radically simple boot scripts so |
| pankso@0 | 7 the integration was very easy. Enabling/disabling fbsplash on boot and |
| pankso@0 | 8 managing themes can be done with the fbs utility. |
| pankso@0 | 9 |
| paul@1 | 10 In time or if someone gives a hand. It may be possible to have a |
| pankso@0 | 11 GTK or/and Ncurses frontend to handle themes. |
| pankso@0 | 12 |
| pankso@0 | 13 |
| pankso@0 | 14 Overview |
| pankso@0 | 15 -------- |
| pankso@0 | 16 |
| pankso@0 | 17 * Use Busybox fbsplash applet for image and progress bar |
| pankso@0 | 18 * Use Linux kernel options 'quiet' at boot time |
| paul@1 | 19 * Enable FBSPLASH in /etc/rcS.conf config file |
| pankso@0 | 20 * Tweak /etc/inittab to hide and log text messages |
| paul@1 | 21 * The SliTaz theme can fit in a very small screen since the image |
| paul@1 | 22 goes top/left and has a black bg such as the Linux Framebuffer |
| pankso@0 | 23 |
| pankso@0 | 24 |
| pankso@0 | 25 Install & setup |
| pankso@0 | 26 --------------- |
| pankso@0 | 27 Fbs is packaged for SliTaz but should work on any GNU/Linux with some |
| pankso@0 | 28 modifications to the boot scripts, patches are welcome! To install the |
| pankso@0 | 29 fbs utility and default theme: |
| pankso@0 | 30 |
| pankso@0 | 31 # make && make install |
| pankso@0 | 32 |
| paul@1 | 33 Boot splash is activated on some SliTaz ARM flavors but not on the i486 |
| paul@1 | 34 standard distribution so you need enable fbs to have a graphical boot: |
| pankso@0 | 35 |
| pankso@0 | 36 # fbs on [theme] |
| pankso@0 | 37 |
| paul@1 | 38 All fbs configuration variables can be found in: /etc/rcS.conf. These are: |
| pankso@0 | 39 |
| pankso@0 | 40 FBSPLASH="on" |
| pankso@0 | 41 FBTHEME="slitaz" |
| pankso@0 | 42 |
| pankso@0 | 43 Testing |
| pankso@0 | 44 ------- |
| paul@1 | 45 Let's test the environment, first make sure you have the Linux Framebuffer |
| paul@1 | 46 device node with: 'ls /dev/fb0'. The Raspberry Pi uses the Linux framebuffer |
| pankso@0 | 47 so Fbs will work out of the box. |
| pankso@0 | 48 |
| al@2 | 49 Then press Ctrl+Alt+F2 to open a text mode session (back to X with Alt+F7) |
| pankso@0 | 50 and run as root the Fbs testsuite: |
| pankso@0 | 51 |
| pankso@0 | 52 # fbs test |
| pankso@0 | 53 |
| pankso@0 | 54 Theming |
| pankso@0 | 55 ------- |
| pankso@0 | 56 Fbs provide a nifty theming mechanism designed to easily handle installed |
| paul@1 | 57 themes as well has creating and sharing new themes. A theme exists in |
| pankso@0 | 58 a small and human readable configuration and in a gzip ppm image. |
| pankso@0 | 59 |
| pankso@0 | 60 # fbs themes |
| pankso@0 | 61 # fbs set-theme [theme] |
| pankso@0 | 62 # fbs pack-theme [theme] |
| pankso@0 | 63 # fbs add-theme [theme] |
| pankso@0 | 64 |
| pankso@0 | 65 Code example |
| pankso@0 | 66 ------------ |
| pankso@0 | 67 #!/bin/sh |
| pankso@0 | 68 # |
| pankso@0 | 69 export fifo=/tmp/fbs.fifo |
| al@3 | 70 rm -f $fifo; mkfifo $fifo |
| al@3 | 71 |
| al@2 | 72 fbsplash -c -f ${fifo} \ |
| al@2 | 73 -s /usr/share/fbs/default/fbsplash.ppm.gz \ |
| al@2 | 74 -i /usr/share/fbs/default/fbsplash.cfg & |
| al@2 | 75 |
| pankso@0 | 76 echo 25 > ${fifo} |
| pankso@0 | 77 sleep 1 |
| pankso@0 | 78 echo 50 > ${fifo} |
| pankso@0 | 79 sleep 1 |
| pankso@0 | 80 echo 75 > ${fifo} |
| pankso@0 | 81 sleep 1 |
| pankso@0 | 82 echo "exit" > ${fifo} |
| al@2 | 83 |
| pankso@0 | 84 =============================================================================== |