Version 1 of Yakumo Alpha

Updated 2003-02-02 06:10:47

The Yakumo Alpha from http://www.yakumo.com is powered by a StrongArm 206MHz processor and has 64MB SDRAM and 32MB flash NVRAM. It runs Pocket PC 2002 and is ready for Tcl/Tk. After having read Richard Suchenwirth's descripion on his iPaq I decided to give it a try.

Prerequisites:

  • Yakumo Alpha running Pocket PC 2002 (Factory default)
  • Microsoft Active Sync (On the CD)
  • Windows operating system. (On the host computer)
  • USB cradle or cable (Both included in set)
  • WinZip for unpacking the distributions.

Not nescessary:

  • Compact Flash card
  • Multimedia card

What is not covered:

  • Installing when the host computer has a different operating system than Windows
  • Installing when the PDA has a different operating system than Pocket PC 2002
  • Installing using other sync program than Microsoft Active Sync
  • Installing using other interface than the USB

If the Active Sync automatically synchronizes the PDA when you insert the PDA, it should be possible to install Tcl/Tk.

I downloaded the following files from the Windows/CE page:

These files can also be found individually in the file listing in http://www.rainer-keuchel.de/wince/dirlist.html since it is to expect that they be updated in the future. Be careful to select the correct files as there are many to choose from. The list above give a good indication what filenames to look for.

After download, I open WinZip and open the configuration to disable the smart CR/LF convert. This is a bit tricky to find so I think a picutre here will say more than words. Then I unpack all the 4 tar.gz files to c:\temp, giving me the following structure:

 c:\temp\desktop-dist
 c:\temp\tcltk-all-platforms
 c:\temp\tcltk-wince-arm-hpc-wce300
 c:\temp\wince-arm-hpc-wce300

plus more (for Yakumo Alpha) uninteresting wince* directories

At this point it is wise to take a very close look at the script data near the end of Windows/CE called wince_tcltk.bat. Here the author has chosen to install Tcl/Tk to

 \Storage Card\Program Files\Tcl

which is on the external storage card. If this is not any longer the case, then the bat-file has been changed after I wrote this.

The reason why we take such a close look is that we now must decide on where tcltk will have its home in the Yakumo PDA. I chose to use

 \tcltk

I think I will suggest to use

 \Tcl

Simply because you can then reuse the wince_tcltk.bat file with simple editing, or you can also use the wince-reg2.bat file from the distribution, which I will explain in a moment. I will continue to use \tcltk for the rest of this tutorial.

Now I create a directory

 c:\temp\tcltk

on the host pc and copy the _contents_ of the directories (not the directories themselves) of

 c:\temp\tcltk-all-platforms
 c:\temp\tcltk-wince-arm-hpc-wce300

to

 c:\temp\tcltk

As suggested by Richard Suchenwirth, I also choose to copy

 c:\temp\wince-arm-hpc-wce300\celib.dll

to

 c:\temp\tcltk\bin

because if I ever decide to remove tcl/tk from the PDA, I can remove the directory \tcltk and off it goes. No need to search in the \Windows directory as it is overfilled anyway.

{Here would be nice to have a picture of the resulting directory structure under c:\temp\tcltk because we are going to drop those files to the PDA now.}

In the Active Sync window press the Browse button to open a file browser on the PDA. {I think I need to add a picture here to show how it should look like}. Now drag the

 c:\temp\tcltk

directory and drop it into this window. If the Active Sync is connected it should now start copying the files down to the PDA. The copy process may take some minutes. Continue after the download has finished.

Now come the part that I found a bit too loose documented, I will refine this part: In the

 c:\temp\tcltk

directory there are some bat files. Edit the wince-reg2.bat and replace the word "unix" with the word "tcltk". Copy the program

 c:\temp\wince-desktop-tools\cereg.exe

to

 c:\temp\tcltk

and double click the wince-reg2.bat file. You will get a black dos window showing up and no feedback. Be patient.

The setting of the environment variables on the PDA is done from the host pc, not on the PDA. Pocket PC 2002 does not recognize bat files, and cereg.exe is compiled for Intel architecture.

If you have reach this far, then you can use the file browser on the PDA and enter \tcltk\samples and there should be a nice little icon in front of the tcl files there. If you tap one of them, say life.tcl, a small application show up which really load the StrongArm CPU.

Some more of the recomended settings on the iPaq page must be done before I am really happy with my Yakumo design environment.