### ##### ## ## ## ## ## ## ## ## ######
__ __ \ \ / / \ \ / / \ \/ / \ / \/
_ | \ /\ | \ / / | (_/ / | _ ( | ( \ \ | / \ \ |_/ \/
## ## ##### ## ## ## ## #####
_____ / __ \ | / \/ | | | \__/\ \____/
IMPORTANT: enter the case-INsensitive alphabetic (no numbers) code AND WRITE SOME SHORT summary of changes (below) if you are saving changes. (not required for previewing changes). Wiki-spamming is not tolerated, will be removed, so it does NOT even show up in history. Spammers go away now. Visit Preferences to set your user name Summary of change: Why does it need perl? The MS-AVR application is written primarily in C, small part in assembly. The perl is needed to make code maintenance easier. For example global.h contains a struct config_t with lines like: uint8_t awev; // After-start Warmup Percent enrichment add-on value Perl is used to make varstr.h and magicstr.h to convert the elements of config_t into strings that get loaded into the flash, so that the '''// comment string''' can be displayed on the lcd in the appropriate menu (GenBoard/MenuSystem), particularly mtt c. MS-AVR can dump it's configuration to the serial port with menu mcd, the above line becomes awev=04 (if the value if the given enrichment is 04 hexadecimal). The edited (config or tables) datafile can be converted by Perl to menucommands that can be sent via serialport, see GenBoard/InitialConfig. This is very convenient. The time of compiling is also written into the flash (compile_time.h) with the help of a perl script. ---- Many systems have Perl installed by default. To install Perl on inferior operating systems (Windows to the uniformed ;-), activeperl is a good choice. You can choose to follow RunningProgOnWin page, the very first step is getting perl anyway. http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl Download the 8.6MB Perl 5.6.1 MSI package, and the 2MB Microsoft MSI installer package if required. ---- '''The rest of this section should not be needed if one follows RunningProgOnWin.''' For using the GenBoard/Firmware/BootLoader you also need to install the Win32::SerialPort module. Win32::SerialPort isn't directly available with Active Perl 5.6, but it requires Win32::API which is, so start ppm from command prompt (C:\Perl\bin\ppm or use the Menu Shortcut) and type "search Win32::API", and then "install 1" (needed because it might find two modules starting with Win32::API). That should complete successfully. Next, download Win32::SerialPort from http://www.x-dsl.hu/genboard/builders/SerialPort-0_19.zip and unzip it to a local directory. You can then open a DOS prompt and cd into the directory to run "perl Makefile.PL", "perl test.pl" to test (don't worry about errors :-), then finally "perl install.pl" to install it. I couldn't get the automated install of Win32::API to work so I downloaded it from: http://ppm.activestate.com/PPMPackages/zips/8xx-builds-only/Windows/Win32-API-0.41.zip, unzip and install instuctions are included in README. -johan ---- Optional: Add document to category: Wiki formatting: * is Bullet list ** Bullet list subentry ... '''Bold''', ---- is horizontal ruler, <code> preformatted text... </code> See wiki editing HELP for tables and other formatting tips and tricks.