Hello, I wonder, how people trying to "Add link to Collie installation instruction (for creation of this page)" manage to make so many changes to the text and break formatting on the way?
Few suggestions for editing wiki pages: 1. Please do NOT use funky editing modes like "GUI". 2. Please do NOT use funky options like "Remove trailing whitespace from each line" 3. Use a decent browser to make edits (Firefox works well). Unfortunately, to much of my own displeasure, I have to revert edits which, while add a small piece of info, break formatting thruout the doc. Thanks for your understanding. Quoting MoinMoin itself, "Your attention to detail is appreciated." Begin forwarded message: Date: Sat, 02 Feb 2008 10:04:15 -0000 From: Linux-To-Go.org Wiki <[EMAIL PROTECTED] To: Linux-To-Go.org Wiki <[EMAIL PROTECTED] Subject: [GoWiki] Update of "AngstromManual" by 77.202.68.239 Dear Wiki user, You have subscribed to a wiki page or wiki category on "GoWiki" for change notification. The following page has been changed by 77.202.68.239: http://www.linuxtogo.org/gowiki/AngstromManual?action=diff&rev2=159&rev1=158 The comment on the change is: Add link to Collie installation instruction (for creation of this page) ------------------------------------------------------------------------------ . See the home page: http://www.angstrom-distribution.org - ---- == Getting Started == @@ -34, +33 @@ Ångström is currently in Release Candidates phase. Most of features and bugfixes set for the release have been implemented, and there is wide public testing to find and fix as much as possible remaining bugs. Current RCs are available for download at: . http://www.angstrom-distribution.org/releases/2007.12/images/ - Under this web directory you will find subdirectories for individual machines (both supported and untested). Within each machine directory, there are directories for individual RCs, for example, "RC1.5". There are also may be snapshot directories, named by the build date, YYYYMMDD. Snaphost directories are deprecated - RCs should be used instead. Within each directory, you will find few kinds of images representing different Ångström configurations. + . - ||<tablewidth="75%"> base-image || Very minimal system without GUI. SSH login over builtin networking (e.g. usbnet, ethernet port). This is indended for headless devices with very small amount of flash (e.g., routers) or for special-purpose installs (like standalone portable servers, automation controllers, data loggers, etc.). || + ||<tablewidth="75%"> base-image || Very minimal system without GUI. SSH login over builtin networking (e.g. usbnet, ethernet port). This is indended for headless devices with very small amount of flash (e.g., routers) or for special-purpose installs (like standalone portable servers, automation controllers, data loggers, etc.). || || console-image || Usable system without GUI. Can connect to net via BT/!WiFi/USB. Should handle devices connected via CF or USB Host. || || minimalist-gpe-image || Very minimal system with X11 GUI, on which you may install software you need. Suitable for devices with minuscule amount of flash and for DIY fans. NOT suitable for first-time users. || || x11-image || Like console-image but with X11 environment. || || x11-gpe-image || x11-image with [http://gpe.linuxtogo.org/projects/GPE-Contacts.shtml GPE PIM suite] preinstalled. || || x11-pimlico-image || x11-image with [http://www.pimlico-project.org/ OpenedHand Pimlico PIM suite] preinstalled (VGA screen is recommended) || || x11-office-image || x11-image with [http://www.gnome.org/gnome-office/ Gnome Office] preinstalled (Abiword, Gnumeric, etc.) || - x11-gpe and following images are big and provided for selected devices which come with large secondary storage (like microdrive). If there are no such images for your device, you do not lose anything: you can easily install any software you need from the feeds (see below). If you are in doubt which image to choose, use x11-image, it is intended as a starting point for majority of users, offering basic GUI tools to control the device, and devoid of application software which not every user may need, thus offering good compromise between usability, size required, and free space available. Each image type is provided in different formats, among them: + . - ||<tablewidth="75%"> tar.gz, tar.bz2, or cpio.gz || An archived root filesystem (rootfs), suitable for installing to a secondary storage (CF/SD cards, microdrive, etc) by simply unpacking (note that the secondary storage must be already formatted appropriately, usually with ext2 filesystem) || + ||<tablewidth="75%"> tar.gz, tar.bz2, or cpio.gz || An archived root filesystem (rootfs), suitable for installing to a secondary storage (CF/SD cards, microdrive, etc) by simply unpacking (note that the secondary storage must be already formatted appropriately, usually with ext2 filesystem) || || ext2, ext2.bz2, img, img.bz2 || An integral filesystem image, which can be copied (using dd) to a secondary storage partition directly. || || jffs2 || A flash image, which can be flashed to internal flash ROM of the specific device || || summary.jffs2 || like above, but with extended "summary" information allowing to mount flash filesystem quicker. Suggested if space allows. || || exe || Executables for WinCE devices. Bigger files are LiveRamdisks, allowing interested users to get quick preview of Angstrom without need to install anything (a-la LiveCD); smaller images are bootmanagers, allowing to boot root filesystem from various locations. || || zImage || A standalone kernel image for ad-hoc boot-loaders || - Note that some specific device may not use all of the image formats above. Please follow installation instructions for your device and use the image format as described there. On the other hand, advanced users may need another image format for advanced setups. Generally, builds available for individual devices, as well as image kinds and formats may vary from machine to machine, though Ångström maintainers and machine mentors strive to provide consistent and complete coverage for each machine. @@ -72, +70 @@ * [http://www.angstrom-distribution.org/c1000-install-instructions Sharp Akita (c1000)] * [http://www.angstrom-distribution.org/zaurus-c7x0-c8x0 Sharp Corgi, Shepherd, Husky, Boxer (c7x0-c8x0)] * [http://linuxtogo.org/gowiki/PoodleInstall Sharp Poodle (SL-5600)] + * [http://linuxtogo.org/gowiki/PoodleInstall Sharp Collie (SL-5500)] * [http://linuxtogo.org/gowiki/TosaInstall Sharp Tosa (SL-6000)] * PocketPC and !WindowsMobile family - * [wiki:WinCeQuickInstall Quick Installation Instructions for any supported PocketPC/WM device] + * [:WinCeQuickInstall:Quick Installation Instructions for any supported PocketPC/WM device] * [http://www.angstrom-distribution.org/ipaq-h2200-series IPAQ H2200 series] (installing to flash - for advanced users) * Psion Teklogix [:NetbookPro:NetBook Pro] See also the UsingAngstrom page. === First Steps After Installing === - - Once you installed Angstrom and booted into the system, you are highly recommended to upgrade system from the feed to get the latest security and bug fixes since the release has been made. To do this, you need to run the following commands in terminal: + Once you installed Angstrom and booted into the system, you are highly recommended to upgrade system from the feed to get the latest security and bug fixes since the release has been made. To do this, you need to run the following commands in terminal: + {{{ ipkg update ipkg upgrade }}} - However, for this to work, you must be connected to the Internet to be able to download updates. See "Networking" section below to help with setting it up. === Known Issues === @@ -102, +100 @@ If Angstrom was installed with only the console UI, it is possible to add GPE by installing the relevant packages, after which a reboot should bring up the GPE setup and login screens. === Internationalization and Localization === - Few definitions: + * Internationalization (i18n) - Having support in the system for different character sets (both for input and output), fonts, and using well-known locale-neutral standards for representing data like time/date, and numbers. * Localization (l9n) - Having support in the system for particular locality, from time and monetary data to messages output by applications. - Angstrom is targetted at the wide user community thruout the world, so provides good i18n and l19n support, with basic i18n support available out of the box with standard X11 GUI images. As a contemporary Linux system, Angstrom uses UTF-8 encoding. Angstrom iamges come with English UTF-8 locale (en_GB) which is suitable to get good i18n support. Make sure that you select "English(Great_Britain)" when logging into X11 session. ==== Fonts ==== @@ -117, +114 @@ * xkbd * matchbox-keyboard - Each of them allows to install and configure additional localized layouts for different languages. Few layouts are shipped by default with the both keyboards. ==== Physical Keyboard ==== <to be filled in> ==== Internationalized Filenames Support ==== - Angstrom supports i18n filenames out of the box, as long as they are UTF-8 encoded. Most X11 GUI applications display and allow to use such names without any issues. There are some important exception however, please see below. Of course, there should fonts available for teh characters used in filenames, see Fonts above. ==== Libc Locale Configuration ==== @@ -137, +132 @@ {{{ ipkg install locale-base-en-us }}} - Once package installed, a new choice will be available in X11 login. ==== I18n Input in X Terminal ==== - Make sure you have real locale, not "C" one to have i18n filenames to be printed properly. There's known issue with i18n input in gpe-terminal (included in Angstrom images) and rxvt. In short, it doesn't really work. @@ -151, +144 @@ Only vte is known to work, in the sense that doing "cat >foo" you can then type i18n chars. However, even with vte you cannot type i18n characters in the ''shell prompt''. This is assumed to be shell issue, which filters such chars (note that using tab completion, one can get i18n filename into commandline). ==== Localized messages for applications ==== - For this to work, you must install locale for the corresponding language. Then, for each application you are interested in, you should install package {{{<app>-locale-LL}}} to get translated messages. + For this to work, you must install locale for the corresponding language. Then, for each application you are interested in, you should install package {{{<app>-locale-LL}}} to get translated messages. ---- == Communications & Networking == - === General Networking Setup === - ==== Router/Host setup ==== One of the first things you want to do after installing an Angstrom release is to connect to Angstrom's site on the Internet and get the latest updates for security and important bug fixes. If you will connect to internet "directly" (for example, via GPRS) or via a dedicated router (for example, using WiFi or Ethernet), you usually don't need to do additional configuration "on the other end", assuming your GPRS account is enabled and router already setup to serve other computers. However, many people with conventional PDA devices will connect using USB to the desktop or laptop computer. In this scenario, your host computer will serve as a router for your Angstrom device, and so must be configured accordingly: you must enable IP forwarding and NAT (Network Address Translation, also known as "masquerading") on it. Please consult your Linux distribution manual on how to make such changes permanent, to be able to connect the device to the Internet without manual setup in the future. Following commands will work for any Linux system (root priveleges required), but only until reboot. NAT all outgoing traffic to the internet (eth0 would be the external interface): + {{{ iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE echo "1" >/proc/sys/net/ipv4/ip_forward }}} + Windows users need to enable ICS ([http://support.microsoft.com/kb/306126 Internet Connection Sharing]) to achieve the similar functionality. Note: * windows will change your LAN's IP address and set up DHCP * you can only share internet access with one internal interface (which could be the LAN, bluetooth, or wireless), unless you find a third party tool to set it up * if you are already using ICS for a different interface, consider the use of a simple proxy such as AnalogX's, for giving other networks access to the internet - - Windows users need to enable ICS ([http://support.microsoft.com/kb/306126 Internet Connection Sharing]) to achieve the similar functionality. Note: - * windows will change your LAN's IP address and set up DHCP - * you can only share internet access with one internal interface (which could be the LAN, bluetooth, or wireless), unless you find a third party tool to set it up - * if you are already using ICS for a different interface, consider the use of a simple proxy such as AnalogX's, for giving other networks access to the internet ==== Angstrom device setup ==== To access Internet using domain names, you need to setup DNS server properly (unless you use DHCP and it will be provided by the server). @@ -181, +169 @@ X11 GUI configuration: Main menu -> Settings -> Network Setup, enter root password if being asked for, select '''global''' tab. Fill in "DNS server" field. - === Networking using USB === A USB networking is so far the most common network methods available for embedded devices. If a device has USB port, it usally can use USB networking too. Subsection below describe how to configure support both on an Angstrom device and host to which it connects. @@ -210, +197 @@ }}} ==== USB Host (usually a PC) ==== * When using a Windows host, you have two choices: use Windows-provided RNDIS protocol driver, or install 3rd-party driver for Linux-standard CDC protocol. The second option is completely unsupported (unless 3rd party vendor does support for you), but may be useful in case RNDIS doesn't work.While RNDIS driver comes with Windows, you need to use a special .inf file to install it. It can be found in {{{Documentation/usb/linux.inf}}} of the official Linux kernel release tarball, or fetched from kernel git: [http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob_plain;f=Documentation/usb/linux.inf;hb=HEAD linux.inf] (right-click and "save as...", name "linux.inf"). - * When using a Linux host, ensure that the usbnet, cdc_ether (for PC) or g_ether (if your host is also a device) modules are loaded. - {{{ modprobe cdc_ether modprobe usbnet @@ -235, +220 @@ netmask 255.255.255.0 broadcast 192.168.129.255 }}} - ===== Gentoo ===== - Entry to {{{/etc/conf.d/net}}}: + {{{ config_usb0=( "192.168.129.1" ) }}} - ===== SuSE ===== Create file {{{/etc/sysconfig/network/ifcfg-usb0}}}: @@ -257, +240 @@ NETWORK='192.168.129.0' PREFIXLEN='' }}} - - === Bluetooth === ==== Overview ==== Ångström uses the standard 2.6 kernel bluetooth modules (which were derived from [http://www.bluez.org/ bluez]). Userspace commands used to control/access Blueoooth hardware are hciconfig, hcitool, rfcomm, l2ping etc. Before establishing a bluetooth connection with another computer, either for rfcomm or pand, it is necessary to pair the two. Bluetooth uses a PIN, or password, for incoming pairing requests it is set in the /etc/bluetooth/pin file, and for outgoing requests by the utility "passkey-agent". _______________________________________________ Angstrom-distro-users mailing list [email protected] http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/angstrom-distro-users
