#    #  
 #    #  
 #    #  
  #  #   
   ##    
         

         
##  # ## 
##  #  # 
 ## ## # 
 ### ##  
  ## ##  
  #   #  
         

  ###    
   ##    
   ##    
   ##    
   ##    
   ##    
  ####   
         

 ###     
  ##     
  ##  ## 
  ## ##  
  ####   
  ## ##  
  ##  ## 
         

 _____ 
|_   _|
  | |  
  | |  
 _| |_ 
 \___/ 
       
       

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:
'''Perl is used during some build, maintenance, backup, testing tasks, and sometimes for serial logging (normally not used, only some special applications, like dyno operators or scientific projects)''' '''The rest of this page is historical''' ---- 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.