WmConsole Home Page

WmConsole is a console server over BlueTooth RFCOMM channels, that allows the user to interact with the device using a command line interface from a Linux or Windows workstation.  Once the WmConsole server is run, it'll listen on a configurable RFCOMM channel by waiting for client connections.  The server also creates a new SDP service called "WmConsole", and advertises it as running onto its listening channel.  From the client side, the QTTY program has to be used to connect to the WmConsole server.  The QTTY software can be built for Linux (needs the BlueZ package) and Windows (needs the Microsoft SDK - but a pre-built binary is also supplied).  Once logged-in, the user will be able to access a thoruogh set of commands to interact with the device (file upload/download, directory/tree creation/removal, process creation with STDOUT redirection, process kill, file search, registry manipulation, and many others - the 'help' command will list them all, together with a brief description).  Since Windows Mobile does not allow handle inheritance and standard input/output redirection, a special device driver (RConsole) is used in order to achieve binaries execution with output on the console. The RConsole device driver manages a kernel pipe (ten actually - from 0 up to 9), and together with the SetStdioPathW() library call, allows WmConsole to execute an external binary by capturing its output on the console.  The WmConsole binary is installed inside the "\Program Files\WmConsole" directory, and it must be manually run using File Explorer.  WmConsole listen by default on the RFCOMM channel 11, but this can be changed either by specifying the "-P CHNUM" command line parameter, or by creating a registry string value named "Channel" inside the "HKEY_LOCAL_MACHINE\SOFTWARE\WmConsole" key and by setting its value to the desired one.  The default username and password for the WmConsole server are user="wmconsole" and password="server".  The "\Program Files\WmConsole\passwd" file stores the usernames and passwords, that you're suggested to change if you plan to keep the WmConsole server permanently running on your device.  Look at the QTTY page for instructions on how to use it to login into a WmConsole (or QConsole) server.



License and Software

WmConsole  (and the RConsole device driver) is made available through the GNU GPL license together with the complete sources.  The latest WmConsole packages are available here :

Source 0.17

Windows Mobile 5 CAB 0.17

Windows Mobile 4.x CAB 0.17





Back Home