Changes between Version 2 and Version 3 of Docs/Prog/Manual/Development/Setup


Ignore:
Timestamp:
11/30/09 15:12:19 (14 years ago)
Author:
Don Wilson
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Docs/Prog/Manual/Development/Setup

    v2 v3  
    2121[[Top]]
    2222
     23[[PageOutline]]
     24
     25= Environment Setup =
     26
     27== About ==
     28This document will discuss in detail how to setup your environment to program the Cardinal 825 Digital Weight Indicator.
     29
     30== Features of the Cardinal 825 Programming Environment ==
     31 * Subversion integration for instant access to the latest source code.
     32 * Full featured Eclipse IDE which is quickly becoming the standard for developers everywhere.
     33 * Mylyn integration with the Cardinal 825 Tech site for quick access to tickets and progress.
     34 * Full debugging capabilities (coming soon).
     35
     36== Required Files ==
     37The following files should be included on the 8GB USB flash drive that was sent with your order.
     38
     39 * [http://www.vmware.com/products/player/ VMware Player] - Required to run the Cardinal Fedora 825 Programming Environment.
     40 * Cardinal Fedora 11 825 programming package
     41
     42== Installing the Environment ==
     43 1. Insert the 8GB USB flash drive into your computer.
     44 2. Install VMware Player by double clicking on the icon in the directory of the flash drive.
     45 3. Follow the steps listed choosing the default values to install.
     46
     47  [[Image(screenshot.1.jpg)]]
     48  [[Image(screenshot.2.jpg)]]
     49  [[Image(screenshot.3.jpg)]]
     50  [[Image(screenshot.4.jpg)]]
     51  [[Image(screenshot.5.jpg)]]
     52  [[Image(screenshot.6.jpg)]]
     53
     54 4. Reboot your computer if required.
     55 
     56  [[Image(screenshot.7.jpg)]]
     57
     58 5. Copy the Cardinal 825 Programming Environment package to your computer in any directory you wish.
     59
     60== Starting the Environment ==
     61 1. Start VMware Player by going to Start -> Programs -> VMware and choosing VMware Player
     62
     63  [[Image(screenshot.9.jpg)]]
     64
     65 2. Start the Cardinal 825 Programming Environment by choosing Open and choosing the '''Cardinal 825 Programming Environment.vmx''' file from the directory you extracted it to in "Installing the Environment step 5".
     66
     67  [[Image(screenshot.10.jpg)]]
     68  [[Image(screenshot.11.jpg)]]
     69
     70 3. VMware will start.
     71
     72  [[Image(screenshot.12.jpg)]]
     73
     74 4. Press '''Take Ownership''' when the prompt appears.
     75
     76  [[Image(screenshot.13.jpg)]]
     77
     78 5. If this error appears press '''No'''.
     79
     80  [[Image(screenshot.14.jpg)]]
     81
     82 6. VMware will power up Fedora Core 11.
     83
     84  [[Image(screenshot.15.jpg)]]
     85
     86 7. Login by clicking on '''user''', entering password '''123456''' and clicking '''Login'''.
     87
     88  [[Image(screenshot.16.jpg)]]
     89  [[Image(screenshot.17.jpg)]]
     90
     91 8. The Cardinal 825 Programming Environment will start automatically.
     92
     93  [[Image(screenshot.18.jpg)]]
     94
     95== Using the Environment ==
     96
     97=== Welcome Screen ===
     98The welcome screen gives you basic information about the Eclipse IDE. You can choose to view the information by clicking on the individual images or simply close it by pressing the X button in the corner.
     99
     100  [[Image(screenshot.29.jpg)]]
     101
     102=== Project Explorer ===
     103The project explorer gives you an overview of projects that are in your workspace. The Cardinal 825 Programming Environment is set to use /home/user/Workspace as the default workspace. You can change this by selecting File > Switch Workspace.
     104
     105  [[Image(screenshot.19.jpg)]]
     106
     107On the initial startup you will notice eight projects which have been preloaded for you.
     108  * chkwgh - Checkweigher
     109  * dfc - DFC Batcher
     110  * HelloWorld - Tutorial application
     111  * ids - Truck / ID Storage
     112  * lib825 - 825 library
     113  * libapp - application library
     114  * libsql - SQL database library
     115  * mscale - Multi-scale
     116
     117=== Task Repositories ===
     118Task repositories list the available bug tracking repositories. The Cardinal 825 Trac repository has been setup for you but you will need to enter your individual username and password for the Trac site (the one you used to login to the Wiki).
     119
     120  [[Image(screenshot.20.jpg)]]
     121
     122  1. Right-click on '''Cardinal 825 Trac''' and choose '''Properties'''.
     123
     124  [[Image(screenshot.21.jpg)]]
     125
     126  2. Uncheck anonymous and enter your validation credentials. When you are finished, press Validate Settings in the bottom-left.
     127
     128  [[Image(screenshot.22.jpg)]]
     129  [[Image(screenshot.23.jpg)]]
     130
     131  3. If you receive no errors you can press the "Save Password" checkbox and press Finish to save the settings.
     132
     133=== Task Queries ===
     134Task queries allows you to generate custom queries to view tickets for the Cardinal 825.
     135
     136  1. Right click on the '''Cardinal 825 Trac''' repository and choose '''New Query...'''.
     137
     138  [[Image(screenshot.24.jpg)]]
     139
     140  2. We're going to create a query that will show all open tickets for the 825. Enter the information as shown in the screenshot and for '''Status''' choose all available except for closed. Press finish when you are done.
     141
     142  [[Image(screenshot.33.jpg)]]
     143
     144  3. A notification will appear to show you new tickets are available. This works fine but if you are forgetful like me you need a more permanent solution.
     145
     146  [[Image(screenshot.25.jpg)]]
     147
     148  4. Choose Window -> Show View -> Other...
     149
     150  [[Image(screenshot.27.jpg)]]
     151
     152  5. Choose '''Task List''' from the '''Tasks''' folder and press OK.
     153
     154  [[Image(screenshot.34.jpg)]]
     155
     156  6. Task List will now display on the bottom pane. Let's click and drag it next to the Task Repositories on the top-left.
     157
     158  [[Image(screenshot.30.jpg)]]
     159  [[Image(screenshot.31.jpg)]]
     160
     161  7. You will now have two categories. One is '''Uncategorized''' which is all tickets that we do not have a query for. The other is named '''*''' which is the query we just created. That's not a very intuitive name so let's rename it. Right-click on the '''*''' and choose rename. Enter '''All Tickets''' and press enter.
     162
     163  [[Image(screenshot.32.jpg)]]
     164
     165=== Subversion ===
     166Every project distributed with the Cardinal 825 Programming Environment comes ''attached'' to a Subversion repository. Subversion repositories allow you to get the most up to date source code with the click of a button.
     167  1. Right-click on the HelloWorld project and choose Team -> Update.
     168
     169  [[Image(screenshot.35.jpg)]]
     170
     171  2. You now have the latest available source code for the HelloWorld project.
     172
     173Cardinal recommends creating your own repositories for your projects. For more information on doing so please see [http://www.google.com/search?rlz=1C1GGLS_enUS313US313&sourceid=chrome&ie=UTF-8&q=subversion+guide Google's Listing on Subversion Guides].