It is advisable before taking KDSmart and a Bluetooth scanner or scales to the field to test:
1. the scanner is configured correctly;
2. the tablet/phone with KDSmart can operate successfully with it; and
3. your barcodes work as expected.
Barcode scanning in KDSmart can assist with quick, easy and accurate scoring. Barcode scanning can be used for Plot or Sub-Plot location labels and for Traits.
This page contains information for enabling Bluetooth scanner devices in Android, making it available for KDSmart. An introduction to scoring using barcodes with a Bluetooth barcode scanner is also provided.
KDSmart is designed to take advantage of a Bluetooth scanner when:
- Bluetooth is available on the tablet or phone; and
- The tablet/phone can successfully connect with the Bluetooth device; and
- Trial(s) or traits have been prepared for barcode use before importing into KDSmart.
Barcode values must be present in the Trial before it is imported into KDSmart from KDXplore or CSV file. KDXplore can generate barcodes for the Trial and Traits.
Note: For Trials with KDXplore generated barcodes, the option Use KDXplore Barcodes found in KDSmart Settings needs to be enabled.
Non KDXplore barcodes can be used with a Trial. These need to be:
- Included with a Trial CSV file for Plot/Sub-Plots;
- Must be unique - A ‘not unique’ error for plot barcodes would result upon import
- Trait import CSV file with barcodes would need to be imported first.
- The option Use KDXplore Barcodes in KDSmart Settings needs to be disabled.
The following sections describe how to connect a Bluetooth device, provide information about the barcode types, examples of how to score and some tips.
- KDSmart Bluetooth Scanning
- Connecting the Tablet/Phone
- KDSmart - Scanner On
- Using Barcodes in KDSmart
- Using a Scanner – Examples
Bluetooth scanners generally have two modes: HID and SPP.
(More details on this page: https://serialio.com/scanner-data-transfer-methods )
Your scanner must be set to SPP mode before connecting it with KDSmart.
Instructions should be available in your Scanner’s Manual.
Before connecting to and using a Bluetooth device, the Tablet/Phone with KDSmart installed, must first be ‘introduced’ to the device, referred to as ‘pairing’. Sometimes the device may have a ‘pin’ number associated to enable pairing to occur.
The first connection and subsequent connections will require the devices to be ‘paired’. Pairing may need to repeated when disconnection occurs which can be:
- After a period of time has elapsed;
- After devices ‘go to sleep’ (they enter sleep mode to extend their battery life);
- If the device is too far apart from the tablet/phone;
- Signal is interrupted due to obstacles (e.g. walls, etc.); or
- A combination of all of the above.
The following instructions show how to enable Bluetooth on the Tablet/Phone and pair with a scanner.
|On the Android Tablet/Phone go to Android Settings .|
|With the device ‘paired’ and connected, it is ready for use by any Android applications, such as KDSmart.
As noted previously, the distance or proximity required to successfully maintain a Bluetooth connection between the device and the KDSmart tablet can and will vary. If disconnection occurs, reconnecting could be necessary.
Once the Android tablet/phone has been connected (see: the previous section Connecting the Tablet/Phone) KDSmart can be connected to the scanner as outlined in the following steps.
Return to path view for the trial in KDSmart to be scored and from the top right menu (highlighted in the example) select Scanner On. This will display the paired devices.
|Select the confirmation tick button.|
|Scoring now may commence using the barcode scanner.|
To verify the scanner is working correctly use some prepared trait barcodes, if they are available. Try the following:
1. Within Path View for your Trial select Scanner On from the menu
2. Go to Manage Traits and select the required trait;
3. Select the Test Validation button;
4. Try entering values using the scanner. They should appear as if manually entered.
Current Plot refers to the specific location (i.e. plot, sub-plot, etc.) selected and displayed in KDSmart Path View ready for scoring.
KDSmart can use barcode input to assist with streamlining scoring.
Barcodes can be used for the following:
- Location Bar Codes - Used to position and display the current plot for the Trial associated with the scanned barcode location for the:
- Plot; or
- Sub Plot;
- Trait Bar Codes - Used for the current plot to set either the:
- Trait with Value; or
- A Value for the selected Trait.
This different functionality/behaviour is outlined in the following table (Note: The barcodes displayed and human readable text are for illustration only):
|Prefix||Barcode Type||Example||Result When Scanned...|
|PL/||Plot||KDsmart will position the scoring window to the plot at the barcode location.|
|SP/||Sub Plot||KDsmart will position the scoring window to the sub plot at the barcode location.|
|TR/||Trait Name: Value||
These are possible for Traits with a categorical data type or those with a specific and possibly short range. (See below Example - Trait and Value Barcodes).
|Value||For the current plot and selected Trait ‘waiting for a value to be entered’, KDSmart will enter the value of the barcode(s).
In this example the value ‘7’ would be entered as if entering the digit ‘7’ from the keyboard.
Note: When using value barcodes an End-Input barcode maybe required to signify the end of input (See illustration in Example - Trait and Value Barcodes ).
The following example shows a categorical Trait barcode for the Trait instance GC_1.
|When KDXplore creates the barcodes for the categorical trait a barcode will be created for each possible value. This example shows there are 12 valid values for the Grain Colour trait.|
The following example shows a Trait barcode for the Trait SEM.
|In this example:
1. The Trait Bar Code is scanned first, which selects the Trait (SEM) for the current plot, ready for input.
2. Values can be scanned; then
3. End-Input signifies no further values should be entered.
In KDSmart Trials containing barcodes can utilise scoring using a barcode scanner. To facilitate barcode scoring in KDSmart preparation is required, such as generating barcodes in KDXplore.
For a description of barcode types that can be used in KDSmart, refer to the table Barcode Types in KDSmart/KDXplore in the previous topic Using Barcodes in KDSmart.
The following scenarios illustrate barcode assisted scoring.
For the currently displayed plot location, scanning a Trait Barcode with Value (prefixed TR/) will set the value of the Trait to the value represented by the barcode.
The example shown next will set the Trait ‘GC_1’ to ‘Brown’ at the current location (i.e. Plot 1):
|A scanner, connected and ready, with the Trial open in KDSmart, in Path View, positioned with the current plot at the required Plot/Sub-Plot.
Also have a Trait Barcode ready to scan. This maybe a printed sheet of Trait barcodes (see example above Example - Categorical Trait Barcodes ).
|Scan the Trait Name:Value Barcode for the required Trait and value.
Trait ‘GC_1’ value = ‘Brown’ in the example.
|Which results in:|
|Value now set for the GC_1 Trait instance to Brown..|
The difference here is a value is not associated with the Trait barcode. When the Trait Scoring window is presented (as if you manually touched the trait for the current plot), it can either be entered either via the numeric key pad or by scanning value barcodes. (see example above Example - Trait and Value Barcodes )
Depending upon the data type, your barcodes and what value needs to be entered, several barcodes may need to be scanned to perform the data entry.
|A scanner, connected and ready, with the Trial open in KDSmart, in Path View, positioned at the required Plot or Sub-Plot.
Have the required Trait barcodes (see example above Example - Trait and Value Barcodes ) ready for scanning.
|Scan the Trait Barcode for the required Trait.|
|The Trait numeric entry window will display.
Either manually enter the value using the numeric keypad or scan the appropriate value barcodes.
A few suggestions follow for practical usage and also how trait datatypes and their validation could improve data collection, both manually or with barcodes.
Using barcodes for traits requires the operator to carry those codes in some manner, possibly in laminated form to the field. In many situations using a barcode will be much quicker to record a trait, however in some instances it maybe slower or less convenient. The suggestions are to inspire some thought as to how best define and manage traits to ensure efficient and accurate data collection.
Traits can be represented with a barcode (TR/ Trait Barcodes) to streamline data recording. For these one of the most applicable datatypes is Canonical. Barcodes for these traits can also be associated with a value, so scanning with a Trait Value Barcode is a single operation.
The simple Canonical example described earlier, repeated below, is for a trait grain colour ‘GC’ with values of: White, Purple, Red, etc. (12 bar codes). At the current plot in KDSmart, just scanning one of these barcodes records the specific value for the trait.
An Integer example could be for a trait ‘Soil_PH’ with 14 values would have 14 bar codes: PH1, PH2, PH3, ......, PH14. Scanning one of these barcodes would set that trait to the value scanned for the current plot.
For some situations traits may have too many barcodes to make them worthwhile. E.g. an integer trait with a valid range of 50 which would involve carrying a sheet of 50 trait barcodes. Locating and scanning the correct one could be more cumbersome and impractical, so either scanning value barcodes or manual entry could be more convenient.
Alternatively for this scenario, the most frequent trait values could be carried and entered using Trait Value Barcodes and the less frequent values recorded manually.