PsiLinux - Linux 2.4 for Psion Windermere Architecture This is the readme file for the Linux port to the Psion Windermere architecture. The windermere architecture is based on a Psion customized NEC 710T ARM processor, and is in use in Psion 5MX, Revo, Ericsson MC218, and Diamond Mako. PsiLinux Windermere port allows you to run Linux on your Psion, and allows you to use the available ARM Linux distributions and binaries on your Psion. For example, at least the Debian, and Familiar Linux distributions are known to work. There are also Psion specific distributions, for more information please see: http://www.psilinux.org/ The kernel port is being developed by a group of people at the linux-7110-psion@lists.sourceforge.net mailing list. This mailing list is the best source for information on this project, so if you are planning to use Linux on your Psion, you should subscribe to it. The homepage for the project is: http://psilinux.org/ or http://linux-7110.sourceforge.net/ The master site for the Psion 5MX files is: http://linux-7110.sourceforge.net/cgi-bin/index.cgi?url=files with a very slow mirror site at: http://www.muru.com/armlinux/ For the changelog, see the CHANGES file. Please read at least the most recent changes in case any changes have been made to the environment. SUPPORTED MODELS WORKING MODELS STATUS Psion 5MX Works, has power management & sound playback Psion 5MX Pro 32MB Works like 5MX, recompile kernel to enable 32MB RAM Psion 5MX Pro 24MB Works like 5MX, recompile kernel to enable 24MB RAM Ericsson MC218 Same as Psion 5MX Psion Revo Works, has power management & sound playback Psion Revo Plus 16MB Works like Revo, recompile kernel to enable 16MB RAM Diamond Mako Same as Psion Revo Plus MODELS NOT SUPPORTED Psion 5 See http://www.psilinux.org/ Psion Series 7 See http://www.psilinux.org/ and http://www.yipton.demon.co.uk/ CURRENT STATE OF THE KERNEL AND RELATED TOOLS KEYBOARD Status: Works, ported from Psion 5 Linux 2.2 kernel. UK, US, and DE keyboard maps available. Development: No active development needed right now? Contact(s): Driver, Tony Lindgren DE keymap support, Thilo Hille FRAMEBUFFER Status: Works with 4bpp, 2bpp, and mono modes. Development: The driver could be optimized, colormaps may need fixing. Would be nice to get virtual screen size support to work with X. Contact(s): Tony Lindgren Shane Nay Help needed! X SUPPORT Status: Xfbdev from the Familiar distribution starts, no keyboard or mouse support yet. Development: X works with modified Xipaq driver. Contact(s): Thilo Hille Edd Robbins Tom Fogg Tom Drynda SERIAL PORTS Status: Uart2 and Irda work. Uart2 works up to 230400, if your desktop supports it :) Development: Enhancements probably not needed right now? Contact(s): Yuji Shinokawa Tony Lindgren PCMCIA/COMPACT FLASH Status: Works. Card cannot be swapped, unless you boot from an initrd and compile ide as modules. Writing has some issues that probably cannot be solved without help from Psion. Development: Some more development is needed. The only documentation seems to be the Linux 2.2 Series 5 driver. Contact(s): Tony Lindgren POWER MANAGEMENT Status: Power management support now has a proper sleep mode. The power consumption in the sleep mode now seems to be 0.01mA less than in Epoc sleep mode! Waking from a Real Time Clock alarm would be nice, if we had an RTC driver. Battery voltages from the SSI bus are on their way, hopefully... Development: Probably needs some more fixes? Contact(s): Tony Lindgren Simon Howard Thilo Hille Quentin Gunn PEN SUPPORT Status: Driver works with X and Picogui Development: Mouse in X does not always receive clicks? Contact(s): Shane Nay Thomas A. de Ruiter RTC Status: RTC driver needs to be developed to allow waking with an alarm. The RTC is documented in the PDF from Psion. Development: No active development, go for it! Contact(s): Yuji Shinokawa Tony Lindgren SOUND Status: Playback works Development: Active development Contact(s): Simon Howard BOOT LOADER(S) Status: ArLo Works fine on Series 5, 5MX, Revo, Series 7, Proboot works fine for 5MX Pro. Contact(s): Peter van Sebille (ArLo) Tony Lindgren (Proboot) DISTRIBUTIONS Status: Debian Woody images available at: http://staff.washington.edu/dushaw/psion Contact(s): Brian Dushaw PORT 2.4 to SERIES 5 Status: In development, see the mailing list archives Contact(s): Andrew Kozin Jason Morley Klaasjan This list is not set in stone, feel free to work on any of this stuff. Help is always needed. If you feel like working on some of sfuff, just contact the PsiLinux mailing list at linux-7110-psion@lists.sourceforge.net. GENERAL NOTES - Please see the main website for distributions you can use. - You should make backups of both the ramdrive and flash disk of your Psion before playing with this kernel! - If you are playing with the source, grep the source for CONFIG_ARCH_PSION5MX and FIXME5MX tags... Or read the patch file. - You can use the serial_printf function to get low level debug output to the serial port at 115200 8 N 1. COMPILE AND BOOT NOTES - The emdebian.org cross compile environment can be used to compile the kernel. Other cross compile environments should work too. You can get the emdebian cross compile environment from: http://www.emdebian.org/crossdev.html - Please not that the old "boot-14" boot loader does not work any longer. Please use the ArLo with the boot2nd loader, or Proboot for 5mx Pro. FILE VERSIONS Once you have the cross compilation environment up, you need to get the kernel and ARM patch: - linux-2.4.X from your closest kernel mirror - ARM kernel patch 2.4.1-rmkX from: http://www.arm.linux.org.uk/developer/release-2.4.0.shtml - Then apply the 5mx patch. - Run make menuconfig, make dep, make Image, then run arlo to boot. Please note the bzImage is currently not supported.