Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
getting-started [2025/02/28 17:57] – snacsnocgetting-started [2025/03/10 03:03] (current) – [Install] snacsnoc
Line 1: Line 1:
 ====== Quick start ====== ====== Quick start ======
  
-==== Download ====+===== Download =====
 You have a few options: You have a few options:
   * Download the [[http://snacklinux.geekness.eu/download/|latest ISO]] (x86 only) and boot as a live system   * Download the [[http://snacklinux.geekness.eu/download/|latest ISO]] (x86 only) and boot as a live system
Line 9: Line 9:
 SnackLinux supports most generic vintage hardware out of the box. If you require specific drivers, please compile your own custom kernel. SnackLinux supports most generic vintage hardware out of the box. If you require specific drivers, please compile your own custom kernel.
  
-==== Install ==== +===== Install ===== 
-You can install SnackLinux from a live image to a local hard drive by runnning ''/root/install-snacklinux.sh'' or by booting from the hard drive img file. +You can install SnackLinux from a live  ISO image to a local hard drive by runnning ''/root/install-snacklinux.sh'', or by booting from the hard drive img file (easiest). 
-If you are using vintage hardware and an IDE to Compact Flash adapter, you can simply dd the img file to your CF card.+ 
 +If you are using vintage hardware and an IDE to Compact Flash adapter, you can simply dd the img file to your CF card.  
 +   dd if=snacklinux_cf_i486_01.03.25.img of=/dev/sda4
  
 Note for live install: you will need to setup networking and install dialog, ncurses and lilo with ''fbpkg'' Note for live install: you will need to setup networking and install dialog, ncurses and lilo with ''fbpkg''
    fbpkg install dialog && fbpkg install ncurses && fbpkg install lilo    fbpkg install dialog && fbpkg install ncurses && fbpkg install lilo
    bash install-snacklinux.sh /dev/hda    bash install-snacklinux.sh /dev/hda
-==== Networking ====+    
 +===== Networking =====
  
 To set up networking, you can either use a static IP To set up networking, you can either use a static IP
Line 34: Line 37:
 Run ''fbpkg update'' to update the latest packages list and to check if the network is up. Run ''fbpkg update'' to update the latest packages list and to check if the network is up.
  
-=== SSH ===+==== SSH ====
  
 Install dropbear via fbpkg by running ''fbpkg install dropbear'' Install dropbear via fbpkg by running ''fbpkg install dropbear''
Line 45: Line 48:
 Now run ''dropbear'' to start the dropbear SSH server. Now run ''dropbear'' to start the dropbear SSH server.
  
-=== Packages ===+==== Packages ====
  
 To see the available packages, run ''fbpkg search mypackage''. To see the available packages, run ''fbpkg search mypackage''.
Line 51: Line 54:
 Use ''fbpkg install <package>'' or ''fbpkg remove <package>'' for installation and removal. Run ''fbpkg --help'' for more information. Use ''fbpkg install <package>'' or ''fbpkg remove <package>'' for installation and removal. Run ''fbpkg --help'' for more information.
  
-=== Programming ===+==== Programming ====
 For compiling C/C++, install the essential tools: For compiling C/C++, install the essential tools:
    fbpkg install gcc    fbpkg install gcc
Line 58: Line 61:
    fbpkg install m4    fbpkg install m4
    # Other software that may be of value    # Other software that may be of value
-   # tcc, ncurses, pkgconf, nim+   # tcc, ncurses, pkgconf, [[nim-lang|nim]]
        
-=== Graphics (in-progress) ===+==== Graphics (in-progress) ==== 
 +**Requirements:** Built-in or ISA VGA video card
  
-The kernel does not have built-in graphics support to save on size and allow booting with 8MB of RAM. You must install ''linux-modules'' and load the appropriate interface modules.+**Graphics memory:** 512KB tested, possibly works with 256KB 
 + 
 +SnackLinux supports only the ISA bus and excludes any PCI-based devices including graphics cards. Most graphics drivers in the kernel (4.4) are aimed at PCI cards, so we are left with two choices: vga16fb or simpleframebuffer. The ''vesafb'' graphics driver only supports VESA 2.0+ cards, which do not encompass most ISA graphics cards (Cirrus GD54xx, Trident TVGA 8900/9000, Oak 067/077). 
 + 
 +The SnackLinux kernel does not have built-in graphics support to save on size and allow booting with 8MB of RAM. Boot SnackLinux by selecting any VGA text mode on boot (Extlinux), you may encounter issues loading the appropriate kernel module if "VESA" is selected.  
 +To install ''linux-modules'' and load the appropriate modules:
   fbpkg install linux-modules   fbpkg install linux-modules
      
   modprobe vga16fb   modprobe vga16fb
 +  fbset #confirm the current resolution
 +  ls /dev/fb0 #confirm we have a framebuffer
   modprobe mousedev #/dev/input/mice does not exist by default, this creates it   modprobe mousedev #/dev/input/mice does not exist by default, this creates it
   modprobe psmouse #for a PS/2 mouse   modprobe psmouse #for a PS/2 mouse
   modprobe sermouse #for a serial mouse   modprobe sermouse #for a serial mouse
  
-Builds of MicroWindows have been compiled but not ready for a full release. You can download the compiled packages here and extract to your local directory: +Builds of MicroWindows 0.92 have been compiled but not ready for a full release. As a note, Microwindow looks for a mouse at ''/dev/mouse'' 
-  wget http://snacklinux.geekness.eu/repo/testing/microwindows-serial-mouse.tgz #for using a serial mouse+You can download the compiled packages here, extract to your local directory and run ''launcher.sh'': 
 +  wget http://snacklinux.geekness.eu/repo/testing/microwindows-serial-mouse.tgz #for using a serial mouse. Create /dev/psaux or create a symbolic link to your mouse
      
-  wget http://snacklinux.geekness.eu/repo/testing/microwindows-gpm-mouse.tgz #for using gpm, including a keyboard driven mouse+  wget http://snacklinux.geekness.eu/repo/testing/microwindows-0.92-bin-gpm.tgz #for using gpm 
 +  fbpkg install gpm
      
- +   
-For Nim, see the [[nim-lang|Nim language page  ]] +**Work In Progress**: builds of an updated and refactored MicroWindows 0.92: https://github.com/ghaerr/microwindows/tree/master 
 +Currently unable to run in 4bit mode, even with grayscale enabled.