How to post your project

Posting your project is quite easy. All you need is to follow this few steps, and you are on your way to post your first project.

Preparation for posting of your project

Once you have finished and tested your project, you should comment your source code. First you must place brief description into header of your code. Header comment should contain info about version of compiler, MCU that was used, crystal, what development tool did you use and brief description about project. Header comment should look like this:

	
'***********************************************************************************
'*        Tested on 18F452 @ 8MHz....8 DECADE COUNTER....ODOMETER STYLE            *
'*             Program by W. Schroeder alias "xor" on Dec. 5, 2005                 *
'*                                                                                 *
'*            Written and compiled successfully with mikroBASIC 2.2                *
'*     mikroBASIC libraries and utilites are implemented to work easily with       *
'*   the mElektronikos EasyPIC development board with a 16x2 Character LCD      *
'*                                                                                 *
'* This is a demonstration program for the Character LCD that can be adapted for   *
'* real-world applications such as a KWh Meter, BTU Meter, Liquid Flow Meter, etc. *
'* The visual effect of an older mechanical odometer is possible by using the LCD  *
'* controller's user-RAM area, where the user can place up to 8 custom characters  *
'* of 8 bytes each.  In this program a table was created, "char5x7", that "byte-   *
'* maps" the numbers 0 to 9.  Through a series of table offsets you can build new  *
'* characters that include part of one and part of the next.  This is how the      *
'* rolling effect is created and generated.                                        *
'*                                                                                 *
'* The code is built in a modular style to allow a user to find his way to add or  *
'* subtract from the 8 Decade Digits that are used for this demonstration.  This   *
'* counter will count to 99,999,999 before rolling over to zeroes. You can enter a *
'* manual starting point by setting the digit values and the LCD_OUT value to      *
'* match these values.  The decimal in the display is arbitrary...... Enjoy!       *
'***********************************************************************************
		

After adding header comment to your project, you should comment the source code. Don't comment every line, just comment parts that you think it should be commented. Here is a good example of commenting source code:

	
If dig1flag = 1 Then                           ' housekeeping for recently moved digit1 
     sgl_char(digit1, 8, 1)                    ' bump digit1 up 1 more byte...snap into place 
     LCD_CHR(2,10,1)                           ' print 
     dig1flag = 0                              ' reset flag until next required advance 
     inc(digit1)                               ' get next value ready for next move 
     If digit1 = 10 Then digit1 = 0 End If     ' rollover to zero if over 9 
End If 
		

After you have commented your source code you should add your project files to archive.Archive must not be larger than 500KB, otherwise upload won't be possible. Here is the example of adding your project files to archive using WinRar®:

Uploading your project

Now your project is ready for uploading. Go to our Project page, click on "Post your project". Fill out Upload form, browse for your project archive, and then click "Submit Project" button. After pressing "Submit Project" button wait for a while for file to be uploaded. Upon completion of upload, status message will be shown. Here is a example how to fill out Upload Form:

Your posted project will be reviewed, and if it is interesting project shall be put on our projects page. After that you will be noted by e-mail about our decisions.