iLiad mrxvt ported to iLiad

[scotty1024]

I've ported mrxvt to the iLiad and I will be using it as a training tool to help other developers learn what it takes to port X11 applications to run on the iLiad.

First off, mrxvt is a tabbed version of rxvt. And rxvt is a small terminal program that doesn't try to do too much so it stays small in size. A terminal program allows you to execute commands under Linix on the iLiad. You can use it to examine the contents of memory cards, move files to and from memory cards. Set the time zone, set the time... In general it is your swiss army knife of tools that iRex has so far failed to provide.

I'll be using mrxvt to document some of the more useful features such as setting the timezone so your notes have the correct date and time on them (unless of course you already live and work in UTC).

I've bundled this tool up in a manner similar to that I developed for gnuchess. It is a zip file that you need to extract onto a MMC/CF card or onto the iLiad's own internal memory drive.

You will then need to have the [SHELL] hack installed. Navigate to where you extracted the zip and click into the "mrxvt" directory created, then click on the "run.sh" file.

You should see a window pop up like that shown in the picture below.

If you are not an experienced Linux command shell user (and if you don't know what that means: you aren't ) then do try not to brick your iLiad by typing in random things you find to try via Google. I'll be posting articles, please be patient.

The features of this program that I will be sharing via postings shortly are:

1. It knows how to label itself so Matchbox Window Manager lets it decide its window size.
2. It knows how to coax the keyboard into automatically popping up: the right way.
3. It knows how to put away the keyboard on exit.
4. It knows how to invoke a light weight screen refresh so it won't risk triggering epileptic seizures amongst the users.
5. It knows how to turn off the busy LED.
6. It defaults to using one of the few X11 fonts provided "out of the box".
7. It uses nothing but "out of the box" shared libraries, so it is a very tiny program.

For the advanced I'll share how to make an on screen button for it using Matchbox so you can pop it up and then put it away whilst in the middle of other things.

[b_k]

still busy scotty?
Anyway, looks promising. Now i should finally install the [SHELL] patch.

[jæd]

Originally Posted by scotty1024

I've ported mrxvt to the iLiad and I will be using it as a training tool to help other developers learn what it takes to port X11 applications to run on the iLiad.

Are you going to be posting source code to this (potentially) useful tool...?

[scotty1024]

You need the following includes:

#include <liberdm/erdm.h>
#include <liberipc/eripcviewer.h>
#include <liberipc/eripctoolbar.h>
#include <liberipc/eripcbusyd.h>

The following globals

erClientChannel_t erbusyChannel;
erClientChannel_t ertoolbarChannel;

This bit of code turns off the LED.

    // Turn off busy LED if we were invoked via [SHELL]
    erIpcStartClient(ER_BUSYD_CHANNEL, &erbusyChannel);
    busySetBusy(erbusyChannel, ccBusyState_Off);

This bit of code enables and then pops up the keyboard.

    erIpcStartClient(ER_TOOLBAR_CHANNEL, &ertoolbarChannel);
    tbSelectIconSet(ertoolbarChannel, ER_PDF_VIEWER_UA_ID);
    tbClearIconSet(ertoolbarChannel, ER_PDF_VIEWER_UA_ID);

    // Turn off trashcan
    tbAppendPlatformIcon(  ertoolbarChannel, ER_PDF_VIEWER_UA_ID, iconID_trashcan, -1);
    tbSetStatePlatformIcon(ertoolbarChannel, ER_PDF_VIEWER_UA_ID, iconID_trashcan, iconState_grey );

    // Enable then pop up keyboard
    tbAppendPlatformIcon(  ertoolbarChannel, ER_PDF_VIEWER_UA_ID, iconID_keyboard, -1);
    tbSetStatePlatformIcon(ertoolbarChannel, ER_PDF_VIEWER_UA_ID, iconID_keyboard, iconState_selected);

This bit of code labels the main window so Matchbox treats it as a Dialog and lets it set its own size (and brings it to front).

Atom window_type = XInternAtom(r->Xdisplay,
                               "_NET_WM_WINDOW_TYPE_DIALOG",
                               False);
XChangeProperty(r->Xdisplay,
                r->TermWin.parent,
                XInternAtom(r->Xdisplay, "_NET_WM_WINDOW_TYPE", False),
                XA_ATOM,
                32,
                PropModeReplace,
                (unsigned char*)&window_type, 1);

This bit of code flashes the screen black to do as ghost-less a refresh as possible

    // Full Refresh, chase off all the ghosts
    dmDisplay(dmCmdPriorUrgent, dmQFull);

This bit of code refreshes the screen without the black flash. It works much better for UI work such as that in mrxvt.

        dmDisplay(dmCmdPriorUrgent, dmQTyping);

To make the keyboard go away when you are done with it (or exiting mrxvt).

    extern erClientChannel_t ertoolbarChannel;

    // close keyboard
    tbSetStatePlatformIcon(ertoolbarChannel, ER_PDF_VIEWER_UA_ID, iconID_keyboard, iconState_normal);

And to link you need the following libraries.

-lerdm -leripc

[arivero]

I remember time ago I had some trouble about the appropiate font to use for xrvt.

Scotty, the centered Dialog idea is BRILLIANT. And I regret do not have greater/bigger uppercasses. Er, wait a moment, I have...
BRILLIANT.

It is real hack, to have remembered that dialog windows indeed appear and of course to know that they can be asked to show.

[scotty1024]

Originally Posted by arivero

It is real hack, to have remembered that dialog windows indeed appear and of course to know that they can be asked to show.

Thanks!

I think the next item out of my porting pipeline will really put the heat to iRex from the 2.7.1 user community.

[CommanderROR]

well, i'm certainly looking forward to that then...:-)

[arivero]

Originally Posted by scotty1024

I think the next item out of my porting pipeline will really put the heat to iRex from the 2.7.1 user community.

So you are porting Basilisk ?

EDITED: well, or any vmac fork

[scotty1024]

I said heat, not something to make iRex laugh their asses off.

[NatCh]

Hmm, might do them some good to laugh a bit.

[yokos]

Thanks, scotty, brilliant as usual.
No we have a real shell terminal.
I copied some files from CF to /mnt/free wo help of a PC. uhh! nice!

[arivero]

Originally Posted by yokos

Thanks, scotty, brilliant as usual.
No we have a real shell terminal.
I copied some files from CF to /mnt/free wo help of a PC. uhh! nice!

yeah, that is really useful: to be able to move files and folders between devices!

Plus, wget.

[scotty1024]

Originally Posted by yokos

Thanks, scotty, brilliant as usual.
No we have a real shell terminal.
I copied some files from CF to /mnt/free wo help of a PC. uhh! nice!

After your excellent piece of work on the [SHELL] hack I was wondering if you were thinking about doing a similar posting documenting how to move files around?

I think there has been a bit of pent up demand for this simple capability.

[yokos]

STICKY [This is a first draft, this message says to you: post isn't finished right now]

step-to-step-guide How to copy directories from CF/MMC to iLiad's USB drive without a PC
What you need to know
How you can start mrxvt

What you want
copy a directory from media card to iLiad. Wouldn't it be nice to do this without a PC? at the beach, in subway, you understand?

Steps
# run mrxvt via run.sh
# what you get is a terminal window, where you can run shell comands
# my terminal says /mnt/free/newpapers/Apps/mrxvt/ #
What does this mean? It shows you in which directory your mrxvt application lies. So this depends, where you copied the binary file [application] mrxvt.
# using mrxvt works this way:
1- you enter a command,
2- then you press enter,
3- mrxvt executes your command & creates a new line,
4- where can enter the next command.
# This will we do. Ok, first we need to change the directory first
type cd /mnt/cf [if you use a CF card] or cd /mnt/mmc [if you use a MMC card], then press "enter" button on keyboard.
terminal gets a new line, which lists the address you typed in. You are now at the lowest dir level [root] of you memory card.
cd stands for change directory, /mnt/cf is the address of root directory of CF card
# you can type ls -l if you want, a contents list of your memory card is shown, this may helps to choose the directory you want to copy.
sample output:

dr-xr-xr-x    3 root     root         4096 Nov  3 11:45 Kryptologie
drwxr-xr-x    4 root     root         4096 Nov 11 17:18 LaTex
drwxr-xr-x    4 root     root         4096 Nov  6 13:28 Linux
drwxr-xr-x    6 root     root         4096 Sep  2 17:43 My Notes
-rwxr-xr-x    1 root     root        23558 Mar 19  2004 pdf.ico

Reading the sample output above, We get following information:
sample root directory of memory card has got 4 dirs [Do you see the d in front of line? It's says, it's a dir]
What the hack is the rwx stuff?
r=read right, w=write right,x=execute right. In sample you have as user/root all rights.
# You can switch with cd command between levels of directories.
like

cd Linux

,

cd directoryname

with this command you change the current working directory to subdictionary directoryname.
with

cd ..

you can jump from your current directory a level up again.
# I decide to copy the directory "Kryptologie" with all subdirectories to the iLiad's Books USB drive.
How to do this. We can you use the copy command.
We type cp -r Kryptologie /mnt/free/books/Kryptologie
This copies the directory Kryptologie to the iLiad's book directory. It takes a while to copy, depending how large your files are, when the copy process is done, mrxvt creates a new line & is waiting for a new command.
general command is

cp -r /directory/to/copy/from /directory/to/copy/to

How can I exit mrxvt?
# press cross [top right of window] or
# type the command exit

a one-step-copy-process [if you know what you want to copy] in mrxvt could be:

cp -r /mnt/cf/directory/subdirectory /mnt/free/books/subdirectory

This copies the directory "subdirectory" with all it's subsubdirectories from CF to iLiad's book directory. This is quite handy. This command uses the absolute path address.

note to myself: I need to install fbshot. Some screenshots would be nice.

Q: Can you follow the instructions? Or did you found any mistakes?

a tip: with the up-arrow key on keyboard you can switch between commands you already used.

more information about shell commands:
# Linux man pages online
# linuxmanpages.com
# cp @wikipedia.

[vranghel]

Originally Posted by scotty1024

Thanks!

I think the next item out of my porting pipeline will really put the heat to iRex from the 2.7.1 user community.

So i'm assuming that your next(current) project is so awesome that the 2.7.1 ppl will be so jelaous that they will 'scream' at iRex to push their releases faster.

Can't wait!