Get the aJile install files
then, install it

1. Back up your c:\aJile folder, especially if it has any of your own your jembuilder projects (.ajp) or configurations, since those could be overwritten by this update. It's best to keep any ajp files with the code for them, not in the \ajile folder, then you don't have to bother backing up this folder.
2. uninstall your current ajile folder, using Control Panel -> Add or Remove Programs. Then you will probably need to delete the aJile folder manually. On XP I usually also have to reboot.
3. Get the files, currently in the Google SystronixJava Group Files Area. To get around the Google Groups 10 MByte file size limit, and make it easier to download, the release is in three pieces:
• *.zip, *.z01, and *.z02
• Download all three files before you attempt to open the .zip file.
• When you open the .zip file (I use WinZip), it will automatically concatenate the other files and appear to be a single zip archive
• Extract the files to a temp folder or execute them from within  your ZIP utility - it's up to you
  
4. Run aJile_4.3.03_install.exe - this installs the new runtime from aJile Systems. Let it use c:\aJile (the default) since some other things in the aJile tools are hard-coded for that folder and won't work if you use something else.
5. I get a popup about warnings during the installation but so far I cannot find the installation log file which I am supposed to check for details.
6. Copy ajileant.jar from C:\aJile\Ant to your Ant {ANT_HOME}\lib folder. This provides classes such as com.ajile.tools.ant.JemBuilderTask which Ant will use later to compile examples.
7. C:\aJile\Ant\README.TXT has some other instructions about building the aJile examples, but so far I don't think these apply to Systronix customers.
8. Note that the installer creates a system environment variable AJILE_CLDC which points at the runtime root, such as
   AJILE_CLDC=C:\aJile\Runtime_cldc11
   So this is a good choice to use in Ant files since this variable can easily be set to some other path, unlike AJILE_HOME. So I'm going to convert my build.xml files to use AJILE_CLDC

1. You need this to create the JemBuilder Runtime definition. Plus you will want the source files and docs for reference.
2. Extract this into some convenient location. I put all my Java tools under a "javasoft" folder to help keep them in one location. You will access this folder later in JemBuilder setup.
3. Create an ME classes JAR file so that Eclipse can use it later:
1. Browse to your ME installation, the bin\common\api\classes folder, which in my case is:
   D:\javasoft\cldc11\j2me_cldc\bin\common\api\classes
   and open a command line window there.
2. Type this JAR command:
   jar cvf ..\classes.jar *.*
   which will JAR up all the \classes subfolders but not the \classes folder itself. Now you should have this file:
   D:\javasoft\cldc11\j2me_cldc\bin\common\api\classes.jar
   whih contains all the Java ME base classes (e.g., String)
4. Add a new System variable for all users: CLDC_HOME, with - in my case - a value of D:\javasoft\cldc11\j2me_cldc which is the root folder of my Java ME CLDC installation.
5. Test this with an echo from a simple Ant target. I make this part of my Ant "init" target which also cleans output, creates output folders, etc. It's a line like this:
   <echo message="CLDC_HOME is set to = ${env.CLDC_HOME}"/>
   Now you can see at the start of each Ant run if your paths are correct. Also you can now refer to the CLDC class.jar within Ant like this:
   ${env.CLDC_HOME}/bin/common/api/classes.jar"

1. Run SystronixSupplementYYYYMMDD.exe (YYYYMMMDD is the date code) which overlays the Systronix configurations and examples over the aJile installation.

1. Get the new microcode file aJ-100_uram_7A.bin and install it over the top of the current microcode, typically in C:\aJile\Runtime_cldc11\ucode, by doing the following:
2. rename the old microcode file to aJ-100_uram_original.bin
3. Copy the new microcode file aJ-100_uram_7A.bin into this folder
4. then rename aJ-100_uram_7A.bin t to aJ-100_uram.bin
   

1. execute the C:\aJile\Systronix\build.xml Ant script. It creates the Rts.jar and compiles the examples.
   For now, use this build.xml file which creates "Rts.jar" instead of "RTS.jar". Note that Ant must be able to find ajileant.jar to do this (see aJile install instructions above).
2. C:\aJile\Examples\CLDC\builds will now contain examples for JStamp and JStik.
3. C:\aJile\Examples\CLDC\doc contains example javadocs. Not all examples apply to JStamp and JStik. Start with HelloWorld and SerialHello
4. JemBuilder project files are in C:\aJile\Examples\CLDC\Projects
5. Source code is in C:\aJile\Examples\CLDC\src\com\ajile\examples such as C:\aJile\Examples\CLDC\src\com\ajile\examples\io\charadeio\HelloWorld.java and C:\aJile\Examples\CLDC\src\com\ajile\examples\serial\serialhello\SerialHello.java

Modify Charade startup for Systronix targets

Modified Systronix Charade files

Download the Modified Systronix Charade files, and expand in C:\aJile\Systronix, then follow along below and verify that your files are in the correct locations,

Or make your own:

1. Browse to C:\aJile\Systronix and right-click on the LaunchCharade shortcut, select Properties. Edit it so that it has these values:
1. Start in: C:\aJile\Systronix
2. Target: C:\aJile\Charade\Charade.exe C:\aJile\Systronix\Systronix.cfg. This provides the JStamp and JStik charade configurations and tells Charade where to find them.
3. Click OK

Now copy the files to the right places to be used:

1. Copy the just-modified LaunchCharade shortcut to your folder C:\Documents and Settings\{User_name}\Start Menu\Programs\aJile and rename it (the file is already renamed if you use the download to the left) to "Charade for Systronix". Now this shortcut tells C:\aJile\Charade\Charade.exe to start and use the C:\aJile\Systronix Systronix.cfg and charade.wcf files. This keeps Systronix and aJile Charade configurations separate.
2. Copy f.sod from C:\aJile\Charade to C:\aJile\Systronix - this is the startup script for Charade. It's a text file which you can edit if you want to change how Charade starts up. For now, leave it as it is.

Test it -

1. Connect a JTAG kit to a Systronix JStamp or JStik which is powered on. The JTAG pod should have a lit green power LED2.
2. use your Start->Programs->aJile->Charade for Systronix shortcut and Charade should start up. If you see the error "Cannot get drv configuration" , the shortcut path to Systronix.cfg is not correct
3. Now the only issue is that the Charade help files aren't referenced. I'll try to sort this out, or tell me if you figure it out first.

• aJile expects its releases to be in C:\ajile, if you place the install elsewhere some paths will be broken (mainly in the examples)
• there may be some aJile JNIB drivers such as USB which don't have hardware support on Systronix hardware. You are on your own with such drivers since we can't support them yet.
• We don't know about bootloader documentation yet, but we are asking
• The ant jembuilder task is in the /ant subfolder
• GC: You should only be using the mark & sweep algorithm. The generational and train algorithms are not fully implemented.