= Installing Custom Applications =
This guide will explain how to install custom applications in the Cardinal 825 Digital Weight Indicator. 

== Requirements ==
 A USB flash drive or network connection is required. The application file should be copied to the USB flash or network share. For USB it is recommended to not have a great deal of other files on it as this may slow down or otherwise cause trouble with the scanning for files.

== Installing Your Custom Application ==
1. From the "Application Menu" select "File Manager". If the "File Manager" option is not present use the "Configuration" "Enable/Disable Menu" option to enable the file manager then go back to the application menu.

  [[Image(filemgr1.png)]]

2. Updates can be performed from USB or a network share. Using a network will require that the 825 have a proper IP address and netmask setting and the network share must be reachable. The example will show using USB. Select "Choose an update file from USB Flash".

  [[Image(filemgr_ins_usb.png)]]

3. The display will show "Mounting USB" and after some delay as it scans files on the USB flash drive

  [[Image(filemgr_choose_file.png)]]

4. Select the button with the "Application: xxxxx" showing the file name of the desired application to install or update. The display will show "Are you sure you want to install/update Confirm: No". Press "Y" to select "Yes" and ENTER.

5. The file manager will check the USB flash drive to see if there is an accompanying signature file such as custapp.sgn to provide verification of the application developer. If the signature file is not found the file manager will prompt for the menu name to appear in the application menu.

  [[Image(filemgr_menu_name.png)]]


5. Press '''Y''' and then '''ENTER'''. Enter the name of the sales order and press '''ENTER'''.

  [[Image(screenshot.3.jpeg)]]

6. You should see the new directory listed in the left side of the file manager.

  [[Image(screenshot.4.jpeg)]]

7. Next, highlight the directory you just created and press '''ENTER'''.

8. Now, move the cursor to the right side ('''/mnt/fl1''') and choose the custom application. Press '''C''' for (C)opy and then '''Y''' and '''ENTER''' to confirm.

  [[Image(screenshot.5.jpeg)]]

  [[Image(screenshot.6.jpeg)]]

9. When copying files from Windows to Linux the file names are sometimes converted to uppercase. If this happens choose the file on the left and press '''R''' for (R)ename. Change the name to lowercase.

  [[Image(screenshot.7.jpeg)]]

  [[Image(screenshot.8.jpeg)]]

10. Finally, highlight the file and press the '''E''' for (E)xecute. Press '''Y''' and '''ENTER''' to confirm.

  [[Image(screenshot.8.jpeg)]]

== Creating Custom Menu Item ==
1. Choose the '''Configuration''' option from the main menu.

  [[Image(screenshot.11.jpeg)]]

2. Choose option '''6. Configure menu'''.

  [[Image(screenshot.12.jpeg)]]

3. Choose option '''2. Configure custom menu items'''. Press '''SPACE''' to toggle until '''Add''' is shown.

  [[Image(screenshot.13.jpeg)]]

4. Give your menu item a name and type in line 1 replacing '''SO123456''' with the name of the 825 application. Press '''ENTER''' when finished to save the changes.

  [[Image(screenshot.14.jpeg)]]

  [[Image(screenshot.15.jpeg)]]

5. Press '''ESC''' and you will be brought to the '''Configure menu''' screen. If you hit '''ESC''' too many times you can access this from the main configuration screen by choosing option '''1. Enable/Disable menu items'''.

  [[Image(screenshot.16.jpeg)]]

6. Under '''Custom Activity''' press '''SPACE''' to toggle the selection until you see your application entered above. As an optional step, you can toggle the '''Auto run:''' prompt to allow the application to run automatically on startup.

  [[Image(screenshot.17.jpeg)]]

7. Congratulations! You should now be able to start your application from the main menu.