The way in which fshell is initially started depends on the console implementation that it is using. Ordinarly, the choice of console implementation is something that the fshell maintainers take care of independently for each of the supported platforms. However, the choice generally boils down to:
This is the console implementation for the text window server, generally only used for minimal base-port all ROMs and the early stages of product bring up.
This is the console implementation for the graphical window server. It is generally only usable on devices that have a full keyboard, and so is rarely the default console implementation used by the fshell. If fshell has been configured to use this console implementation, it should be possible to start using it selecting its icon from the application launcher. You'll then be presented with a full screen window and a command prompt that can be interacted with using the device's keyboard.
This is a console implementation that connects via TCP to a Win32 executable (called rcons.exe) that hosts console windows remotely. The TCP transport is normally Symbian's PC Connectivity transport, mRouter. It is therefore necessary to have the correct connectivity suite for the handset being used to run fshell installed and connected (normally via USB, but Bluetooth is also possible). It is also necessary to run rcons.exe on the PC hosting the connectivity suite (this file can be found in \epoc32\tools). Having done this, launching fshell from the application launcher should result in a new Win32 window appearing on the PC with a command prompt in it.
Note, rcons.dll is normally the console implementation of choice provided the device in question has a working PC connectivity suite. This is because it supports multiple console windows without any special configuration. However, rcons.dll does require that the device is able to make an active TCP connection to the PC. While this works fine with mRouter, other TCP transports may be blocked by firewalling software running on the host PC.
This is a console implementation that will communicate with a VT100 compatible terminal (or terminal emulator such as HyperTerminal) via a serial connection. There are variants that work over TCP connnections (vt100tcpcons.dll), Bluetooth (vt100btcons.dll) and USB (vt100usbcons.dll). On platforms that support it, the Bluetooth or USB consoles can be started from the application launcher, whereupon they will listen for an incoming connection to the appropriate Bluetooth serial port or USB ACM channel. The console supports basic VT100, colour, some VT220 key escapes, and binary mode.
A specialised console for running the WINSCW fshell directly in a DOS box. Launch \epoc32\tools\fshell.bat to start a headless, gui-less epoc.exe emulator connected to an fshell session in the DOS box. Note this console is only for talking to the emulator, it cannot be used to talk to a device.
On platforms that support it, guicons is supplied as an alternative to econseik. This can be launched from the application launcher, and integrates better with the UI layer than econseik.
Copyright (c) 2008-2010 Accenture. All rights reserved.