Dimensioning software

There are two methods:

• Webservice (Pull Data): This method pulls data from the ParcelCube client. You need to create software (web or desktop) that performs an HTTP Web Request to the PC where the ParcelCube client is installed.

• Remote Webservice URI (Push Data): This method pushes data from the ParcelCube client to a web service that is set up to receive the data.

In order to utilize the Webservice for pulling data from the ParcelCube client there must be software written (web or desktop) to perform an HTTPWebRequest (e.g. button or link click). The web request must be made to the PC where the ParcelCube client software resides.

Example c# code:
---------------------------------------------------------------------------------------------------------------------------
Dim request As HttpWebRequest =
CType(WebRequest.Create("http://192.168.43.37:8080/"), HttpWebRequest)
// IP and port should be the one in the parcelcube config
Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
' Get the stream associated with the response.
Dim receiveStream As Stream = response.GetResponseStream()
' Pipes the stream to a higher level stream reader with the required encoding format.
Dim readStream As New StreamReader(receiveStream, Encoding.UTF8)
'MsgBox(readStream.ReadToEnd())
Dim parcelcube_string() As String
Try
parcelcube_string = readStream.ReadToEnd().Split(";")
Catch
End Try
item_lenght_txtbox.Text = parcelcube_string(0)
item_width_txtbox.Text = parcelcube_string(1)
item_height_txtbox.Text = parcelcube_string(2)
item_weight_txtbox.Text = parcelcube_string(4)
response.Close()
readStream.Close()
---------------------------------------------------------------------------------------------------------------------------
parcelcube_string() has all the data, even though this example only uses 4 values. If you want the calculated volume parcelcube_string(3) will hold it.

Configure ParcelCube client Web Service
In the ParcelCube client software configuration screen fill in the following fields:
1 Bind to IP Address – This is the IP address of the PC that is running the ParcelCube client software (127.0.0.1 may be used for testing locally on the PC).
2 Bind to Port – Enter the port number.
* Note – If you have problems connecting, verify that the port entered is allowed in your firewall

Test Connectivity
To test connectivity on your network PC. With the ParcelCube client software running, enter http://192.168.10.80:8080 (substitute your IP and Port) using either Microsoft Internet Explorer or Mozilla Firefox on a network PC.

In order to utilize the Remote Webservice uri for pushing data from the ParcelCube client to your host application there must be a web service written and running that has a variable waiting to be populated (e.g. variable named data).

Example:
The web server that is running your web service has an ip address of 192.168.10.20 and uses port 9090.
Your web service name is pcdata and contains a variable that is expecting an http: get. The uri that you would put into the Remote Webservice uri in the ParcelCube client would be as follows:
http://192.168.10.20:9090/pcdata?data
ip address port webservice?variable

Configure ParcelCube client
In the ParcelCube client software configuration screen fill in the following field:
• Remote Webservice uri

Usage
Once your web service is in place and you have configured the Remote Webservice uri in the ParcelCube client you simply click on the Register (Enter) button in the ParcelCube client software and it will be retrieved by the web service in the format.

Example of data returned to your web service:
http://192.168.10.20:9090/pcdata?data=12;8.6;6.5;0.388194;1.5;4.041; ; ; ; ; ; ;12;8.6;6.5

Item stacking allows you to measure multiple small objects that are smaller than the minimum size allowed by stacking them. For example, if you have 200 business cards:

• Stack them along the height.
• Enter 200 in the "Height pcs" field.
• The field height will display the total height, and the field "Size per item" under item stacking will show the size of each business card.

If an object is too large for the scale, you can still register its data:

1. From the File menu, choose Pause Serial.
2. Manually enter the dimensions and weight of the object.
3. Register the data.
4. Click File menu and choose Start Serial to resume normal operation.

F9 configuration allows you to set up the scale software to emulate keyboard input of volume and weight data into any application. For instance, if you want to save measurements into an Excel file with columns for Length, Width, Height, and Weight:

• Configure the F9 as: l,t,w,t,h,t,W,lf
• When you press the F9 key, the Excel file will be populated with data like this:

Length Width Height Weight
23 41 12 0.77
43 23 12 1.33

To perform auto-calibration:

1. Login as Admin: Go to Edit > Admin Login and use the password dimwei.
2. Access Calibration: Choose Edit > Auto Calibrate Dimensions.
3. Follow Instructions: Follow the on-screen instructions and use the calibration object as per the assembly and installation steps.
4. Configuration:
   • Choose Edit > Configuration.
   • Select High res and ensure that Smoothing is NOT selected.
   • Click Save and OK.
5. Calibration Process:
   • Place an object of known size (e.g., 20 x 20 x 20 cm) on the scale.
   • Observe the dimensions in the main window.
   • Adjust dimensions in the configuration window accordingly. For example, if the width shows as 19.5 cm instead of 20 cm, increase the value by (20 - 19.5) cm.

To view the CSV data:

1. Choose File > View CSV.
2. The CSV file will open, showing the data in the format defined in the configuration form.

CSV File Format:

• Field 1: Date and time (variable size)
• Field 2: Length (variable size)
• Field 3: Width (variable size)
• Field 4: Height (variable size)
• Field 5: Volume (variable size)
• Field 6: Weight (variable size)
• Field 7: Volume Weight (variable size)
• Field 8-14: User Values 1-7 (variable size)
• Field 15-19: Item Stacking dimensions (Length, Width, Height, Weight) and Item Counting (# of pcs)

Each field ends with a semicolon except the last field, which ends with a CRLF (Carriage Return Line Feed).