Setup for Software Development

About

This document will discuss in detail how to setup your environment to program the Cardinal 825 Digital Weight Indicator.

Features of the Cardinal 825 Programming Environment

• Subversion integration for instant access to the latest source code.
• Full featured Eclipse IDE which is quickly becoming the standard for developers everywhere.
• Mylyn integration with the Cardinal 825 Tech site for quick access to tickets and progress.
• Full debugging capabilities.

Required Files

Download and install VMWare player free virtual machine. Download the 825 development environment installer. This requires a reliable and fast internet connection and may take many hours or days to complete due to the size of the development VMWare image. If you have trouble downloading or do not have an internet connection, please contact your Cardinal dealer for information on getting the Cardinal 825 development kit.

• ​VMware Player - Required to run the Cardinal Fedora 825 Programming Environment.
• ​Cardinal Fedora 825 programming package

Installing the Environment

1. Install VMware Player.
2. Follow the steps listed choosing the default values to install.

3. Reboot your computer if required.

4. Install the Fedora development image. The downloadable installer will install it by default into My Documents/My Virtual Machines/. Once installed, we strongly recommend updating all of the projects and libraries that are provided through subversion to ensure that all source code is up to date. See the section below titled Subversion for information on how to do this.

Starting the Environment

1. Start VMware Player by going to Start -> Programs -> VMware and choosing VMware Player

2. Start the Cardinal 825 Programming Environment by choosing Open and choosing the 825_Develop_F14.vmx file from the directory you extracted it to in "Installing the Environment step 4".

3. VMware will start.

4. If prompted by VMWare player about the image being moved, then select I copied it from the dialog window.

5. VMware will power up Fedora 14.

6. Login by clicking on user, entering password 123456 and clicking Login.

7. The Cardinal 825 Programming Environment will start automatically.

Using the Environment

Welcome Screen

The 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.

Project Explorer

The 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.

On the initial startup you will notice projects and libraries which have been provided as examples and tools for 825 application development.

• chkwgh - Checkweigher
• dfc - DFC Batcher
• ids - Truck / ID Storage
• indicator - Basic indicator application
• lib825 - 825 library
• lib825ev - 825 library for event style applications
• libapp - application library (deprecated)
• libsql - SQL database library
• mscale - Multi-scale

Task Repositories

Task 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).

1. Right-click on Cardinal 825 Trac and choose Properties.

2. Uncheck anonymous and enter your validation credentials. When you are finished, press Validate Settings in the bottom-left.

3. If you receive no errors you can press the "Save Password" checkbox and press Finish to save the settings.

Task Queries

Task queries allows you to generate custom queries to view tickets for the Cardinal 825.

1. Right click on the Cardinal 825 Trac repository and choose New Query....

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.

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.

4. Choose Window -> Show View -> Other...

5. Choose Task List from the Tasks folder and press OK.

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.

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.

Subversion

Every 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.

1. Right-click on the project or library and choose Team -> Update.

2. You now have the latest available source code for the project.

Cardinal recommends creating your own repositories for your projects. For more information on doing so please see ​Google's Listing on Subversion Guides.