Fisherman Fieldkit


The Fieldkit is a hardware package which the inspector can take out into the field to scan taggables and police their use. The hardware device is presumed to run Java 2 Micro Edition Connected Limited Device Profile, and the software for it is suppliued as a MIDlet, which can be downloaded from here.


RecommendedField Inspection Pack components

Requirements

The Field Inspection Pack is a hardware device with GPS and GPRS subsystems and a bar code reader input device, and running the Java 2 Micro Edition Mobile Information Device Profile version 2.0.

Hardware

However, we recommend (and this document describes) the following components:

  1. Hewlett Packard iPAQ 6515;
  2. Socket SD bar code reader;
    1. LED variant
    2. Laser variant
  3. OtterBox 1910 enclosure;
  4. OtterBox 076 SD pod kit;
  5. (Optional) bluetooth headset

The iPAQ is available from a variety of retailers, but if you buy it from Amazon UK following this link I will get a commission!. We have bought our Otterboxes and accessories from Rugged Peak in the UK, and although I don't get a commission I'd recommend them; we have had good service.

Additionally you may wish to add a Bluetooth headset, as using the iPAQ as a phone while it is in the Otterbox is not convenient.

Software

The following software components are recommended:

  1. IBM Websphere Everyplace Micro Edition, MIDP2.0 profile
  2. SocketScan (supplied with Socket SD bar code reader, above)
  3. uk.co.weft.fisherman.fieldkit.midlet.FieldKitMidlet

Assembling Hardware

Components prior to assembly

The iPAQ 6515 unit may have a smoked plastic visor (1a in the photo above) covering the display area. Unclip and remove the visor.

The iPAQ 6515 unit should have a dummy SD card (1b) inserted into a slot on the right hand side, aligning with the bung on the right hand side of the OtterBox. Eject this dummy card by pressing it into the unit – DO NOT attempt to tug it out. It should pop out a small amount. Remove the dummy SD card.

On the right hand side of the OtterBox 1910 enclosure, a large rectangular rubber bung (2a) is secured by one screw. Unscrew and remove the bung.

The Socket SD scanner device has a 3mm thick foam gasket (3a) surrounding the neck of the tongue. Remove the gasket.

The items you have removed so far are not needed in this hardware configuration; you may store them or discard them as you see fit.

The iPAQ 6515 unit has a styus (1c) inserted in a slot in the upper right hand side of the unit; remove but do not discard this stylus - you will need it.

Assembly, stage one

Release the clamps on left and right of the OtterBox 1910 enclosure and hinge it open. Insert the iPAQ 6515, taking care to centre it neatly. Close the enclosure and fasten both clamps.

Assembly, stage 2

Insert the Socket SD scanner device through the aperture in the right hand side of OtterBox 1910 enclosure into the SD slot on the iPAQ 6515 device. Press it home gently but firmly until it clicks. It will not engage correctly unless the gaket (3a) has been removed.

Assemble the OtterBox 076 pod over the Socket SD reader device, and screw it home to the OtterBox 1910 enclosure with the two knurled screws provided.

Assembled

The assembled unit should appear as in the illustration above. The stylus (1c) may be fitted into a slot on the reverse of the Otterbox enclosure

NOTE: to disassemble the device reverse this procedure. WARNING: Attempting to take the iPAQ out of the enclosure without first removing the pod and the reader device will cause serious damage to both the iPAQ device and the reader device.

Detail showing charging connector

To recharge the batteries on the iPAQ device while in the enclosure, gently tug out the large grey rubber bung (1e) from the bottom of the enclosure. Insert the charging connector (1d) through this aperture, label side downwards. Connect the charging connector to the supplied recharging unit, and plug the recharging unit into a wall socket.

To remove the connector from the device, insert the tips of your thumb and forefinger into the aperture to left and right of the connector, and squeeze; then remove. This takes a bit of knack, so practice before you need to do it in a hurry or in the dark. Rememer to reinsert the bung!

WARNING: Do not take the device into the field unless the enclosure is clamped shut and all bungs are in place and secure. WARNING: Do not open the Otterbox enclosure, or remove its bung(s), while in the field.


Top | Recommended Components | Assembling | Installing software | Using the Field Inspection Kit | Reporting Bugs

Installing software

Websphere Everyplace Micro Edition can be bought here. To install Websphere Everyplace Micro Edition, download the software onto a computer running Microsoft Windows XP, and connect the iPAQ 6515 unit to that computer using the supplied USB cable. Run the Websphere Anyplace Micro Edition installer; software will be installed to the device.

To install the SocketScan software, insert the CD supplied with the Socket SD bar code reader into a computer running Microsoft Windows XP, and connect the iPAQ 6515 unit to that computer using the supplied USB cable. Run the SocketScan installer; software will be installed to the device.

The FielkitMidlet uk.co.weft.fisherman.fieldkit.midlet.FieldKitMidlet an be downloaded and automatically installed from http://www.weft.co.uk/products/fisherman/fieldkit/fisherman-fieldkit.jad or from http://fisherman.sourceforge.net/fieldkit/fisherman-fieldkit.jad

At the time of writing the build available from these sites is 1.0.70; this version or any subsequent version should work correctly. To install the software, point the browser on the device to this page, and select either of the links above.

However, you will need to download and install a separate file, fisherman-fieldkit.lnk, also available from those sites, in order to set up the one-button startup function.


Top | Recommended Components | Assembling | Installing software | Using the Field Inspection Kit | Reporting Bugs

Using the Field Inspection Kit

The following discussion assumes you have assembled a device from the recommended components and installed the software described above. The field inspection kit software, when fully installed as described above, may be started by pressing and holdng the action button, (9) in the picture below, for five seconds. The screen display should appear as in this picture.

Display, showing layout

  1. Input line - where input will appear
  2. Status display - showing current system status
  3. Zone display - showing current zone type
  4. Inspector display - showing currently logged in inspector
  5. Fisher display - showing current fisher being inspected
  6. Message display - showing last system message
  7. GPS display - showing current position if known
  8. Enter widget - only needed for keyboard input, see below
  9. Action button - only control used in normal use
  10. Close widget - to terminate the application

The status display may show the following icons:

confirm Notice Error
The last operation completed satisfactorily: a low pitched tone is sounded The last operation has not yet completed, or there is a minor problem: a medium pitch tone is sounded The last operation resulted in an error condition: a high pitched tone is sounded

The zone display may show the following icons:

Closed Hand gatherhers Tractor Vessel
The unit is presently in a zone which is CLOSED to all fishing; or no position has been determined The unit is presently in a zone in which HAND GATHERERS are permitted to fish The unit is presently in a zone in which TRACTOR OPERATORS are permitted to fish The unit is presently in a zone in which VESSEL OPERATORS are permitted to fish

Scanning the inspector's badge

To use the application, you should first scan your inspectors badge, by clicking the action button (9) and pointing the scanner head at your badge (range about 30cm if using an LED scanner, about 1m if using a laser scanner). On a good read a low tone will sound; on a bad read, either no tone at all or a high pitched tone. Shortly after, a second tone should indicate the response from the server - a low tone for a successful response, a high tone for an error.

Following a successful response, your name should show in the inspector display (4).

Scanning the fisher's badge

You should then scan the first fisher's badge by clicking the action button (9) and pointing the scan head at the badge. Again, a low tone indicates a good read, and the second tone indicates the server's response. Assuming a succesful response, the fisher's full name appears in the fisher display (5); following an unsuccessful response the badge number is shown in the fisher display (5) and the reason for failure in the message display (6).

Ensuring GPS startup

Once you have scanned the fisher's badge you should check that GPS startup has been successful; a position is displayed in the GPS display (7). It is undesirable to commence scanning tags until the GPS has started, as no position will be logged to the server. GPS startup typically takes between 30 seconds and three minutes.

If the machine is allowed to go into sleep mode, the GPS unit will have to reacquire a position; this is typically quicker, around thirty seconds

Once the GPS has started up, if you are in a valid fishing zone, the zone display (3) should update to reflect this.

Scanning tags

Once the GPS has started up you may commence scanning tags. To scan a tag, press the action button and point the scanner head at the tag. As usual, a low tone indicates a good read; no tone or a high tone, a bad one. Shortly after, a second tone should indicate the response from the server, a low tone indicating that the tag was valid and has been logged satisfactorily, a high tone indicating some violation of the regulations. The exact violation will show in the message display (6).

You do not need to wait for a successful response from the server before scanning the next tag. Indeed, the system will continue to work even if no connection to the server can be established - it will simply queue items until a successful connection is established.

When you have finished scanning one fisher's tags, you may scan the next fisher's badge and then his tags, and so on.

It you do not scan a tag for a few minutes, first the screen will darken, and then the unit will enter sleep mode. This does not matter - you can wake the unit by pressing the action button, and as soon as it has re-established a GPS connection you can start scanning again.

Using the keyboard

In normal operation it is not expected that you will use the device keyboead, except for the action button. However, you can use the keyboard, for example if the scanner does not work or a tag is too damaged or dirty to read. This is only for use in an emergency, as using the keyboard is extremely awkward. To use the keyboard, type in the number on the badge; it should appear in the input line (1).

When you have typed in the number, press the area on the screen marked 'Enter' (the enter widget, 8). You can use the application entirely in this way, but I would not recommend it!

Terminating the application

You may terminate the application by pressing the cross in the top right corner of the screen (the close widget, 10).


Top | Recommended Components | Assembling | Installing software | Using the Field Inspection Kit | Reporting Bugs

Known Issues

The Fieldkit is at this stage a new project without extensive testing in the field. It is to be expected some issues will arise. If you have problems, please first ensure you have the latest version of the software by downloading it from the website onto the device.

Problems which can arise

Problem Symptom Solution
GPRS fails to start when software starts Error message 'host not found' exit the field inspection kit software by clicking the cross (top right of screen; then click the box marked 'G' centre top of scrren and click 'connect GPRS'
Software fails to communicate with GPS Error message 'error opening serial port'' Make sure that you are not trying to run the field inspection kit software at the same time as the GPS navigation software. If all else fails, reset the device.
Software asks for permission to use GPRS Message 'Can fisherman-fieldkit use airtime...' Click the box marked 'OK' bottom left of screen. This will be resolved once we have tools to cryptographically sign the software.

Reporting Bugs

If you find bugs in Fisherman, or have suggestions for improvements or new features, you can use this form.


SourceForge.net Logo Now hosted at SourceForge.