FarmStream Fleet Setup Guide

To run FarmStream Fleet, a vehicle must have an FmX® integrated display, a GFX-750™ display, or a TMX-2050™ display installed. FarmStream Fleet can use one of many wireless connectivity options including the DCM-300 modem as well as the GX450 modem, SNM941 modem, Wi-Fi, and WAN gateways.

Customers may use the PIQ or FmX+ app on the TMX-2050 display or the PIQ app on the GFX-750 display. The PIQ app prior to version 5.50 firmware for TMX or 1.50 firmware for GFX-750 has limited FarmStream functionality only.

Customers who have the DCM-300 modem and the FmX or TMX-2050 display set up on a vehicle can choose whether they want to use the traditional or FarmStream version of Fleet for that vehicle. Customers who own these devices can use FarmStream and traditional Fleet on different vehicles in their fleet and see the data from both versions of Fleet in one organization.

Customers using traditional Fleet can still use the DCM-300 modem to track their fleet’s utilization, but the traditional Fleet does not link with the display and provides utilization data solely based on vehicle movement and the optional use of an implement switch.

The following table summarizes the hardware options for traditional Fleet:

The following table summarizes the hardware options for FarmStream Fleet:

Some differences between the traditional and FarmStream Fleet include:

Alerts

• Geofence, curfew, and ignition alerts are available in traditional Fleet only.
• Machine and rushing alerts are available in FarmStream Fleet only.

For a detailed list of differences between the two types of Fleet, refer to the feature comparison chart
https://tst-2019-agriculture.trimbleag.team/software/support/feature-comparison-farm-street-fleet-manager-traditional-fleet-manager/

For information on how to use Fleet, refer to the user guide, available at
https://tst-2019-agriculture.trimbleag.team/software/support/fleet-help/

The same part numbers are used for both traditional and FarmStream versions of Fleet.

To activate traditional Fleet, assign a Farmer Fit, Farmer Pro or Farmer Pro Plus License to the customer’s organization in the Reseller Admin website and then in Fleet assign a Vehicle Connection license to the vehicle in the organization that is associated with the DCM-300 modem.

To activate FarmStream Fleet, assign a Farmer Fit, Farmer Pro or Farmer Pro Plus Bundle to the customer’s organization in the Reseller Admin website and then in Fleet assign a Vehicle Connection license to the vehicle in the organization that is associated with the display. You must enable FarmStream on the display. More information is included in other sections in this document.

The following cables are used to connect the display to the Vehicle CAN port – select the cable to match the type of vehicle.

For more information, refer to the FarmStream cable guide.

Licenses for FarmStream Fleet are managed in the Reseller Admin site and in Fleet.

To use the FarmStream Fleet, a vehicle requires a Vehicle Connection License. To obtain a Vehicle Connection license, the vehicle’s organization must have a Farmer Fit, Farmer Pro or Farmer Pro Plus License.

The following is an example of how to set up a license:

For Resellers only

1. Log into the Reseller Admin site (www.trimbleag.com/ResellerAdmin) and then open the Software Activations page. This example shows that the organization has two Farm Subscription licenses available to assign to a customer: A Farmer Pro license (which includes two Vehicle Connection licenses) as well as a separate Vehicle Connection license. In total the reseller therefore has three Vehicle Connection licenses available to assign.
2. The reseller now adds the customer (if this was not done previously) by entering the customer’s email address in the Add Customer field:
3. A confirmation message appears – click Add:
   An email invitation is sent to the customer. If they accept the invitation, the customer is added to the reseller’s organization:
   
   In this example, the customer has been set up as Gwen Byard (Gmail):
4. The Reseller now adds a Farmer Pro bundle. This must be done before they can add any additional Vehicle Connection licenses. The Farmer Pro bundle comes with two Vehicle Connection licenses. To do this, open the Farm Subscriptions section, click the drop down next to the Farmer Pro bundle and then click Assign:
   
5. In the screen that appears, select the customer that you want to assign the license to and then click Assign:
   If there are no errors, a message appears that the license has been successfully assigned:
   
   The customer’s screen now shows that a Farmer Pro license and two Vehicle Connection licenses have been assigned:

Adding additional licenses

If the reseller wants to add additional Vehicle Connection licenses, and if they have licenses available, they can either repeat the process above (see Step 4, above), or they can do the following:

Note: If they do not have any vehicles, the customer should create them.

1. Click the yellow +Add button shown below the assigned licenses.
2. In the dialog that appears, select how many Vehicle Connection licenses you want to add:
   Note: You will not be able to add more licenses than you have available in your inventory.
3. Select a particular license from inventory. SO and PO numbers will be visible for each license to help identify the appropriate license for the customer.

The customer now has an additional Vehicle Connection license, making it three in total:

For End User

Assigning a Vehicle Connection license to a vehicle 

The customer (not the reseller) must now choose which vehicles to assign the Vehicle Connection licenses to. To do this:

1. Check to see which licenses have been assigned to their organization. To do this, log into the Trimble Ag Software, go to Marketplace and then select Current Licenses:
2. If they do not have the appropriate licenses, purchase a license.  This can be done in the Trimble Reseller store by the reseller, or by the customer themselves by going to the Marketplace tab:
3. If they do not have any vehicles, the customer should create them. To do this, go to the Fleet page, click Create New Vehicle:and then complete the New vehicle form. NOTE: WHEN USING FARMSTREAM FLEET DO NOT SELECT A TELEMATICS DEVICE, ONLY SELECT A DISPLAY DEVICE:
4. Assign a license to a vehicle. To do this, select the vehicle to which you want to assign a license.
5. Select Edit Vehicle from the drop-down list to assign the license:
6. The customer can see that the organization has Vehicle Connection licenses available – to assign a license, click the Assign Vehicle License button
7. In the confirmation message that appears, click Assign to confirm. Once assigned, a license cannot be moved to another vehicle.
8. The Vehicle Connection License is now active.
9. Click Save to save all edited vehicle data.

To set up the FmX, GFX-750, or TMX-2050 display to use FarmStream Fleet and have it report into the Trimble Ag Software, you must have the following:

• A Trimble Ag Software account and a Vehicle Connection license assigned to a vehicle, as described in the licensing section. To create an account, go to www.trimbleag.com/FarmManagement/
• A wireless connection to the Internet using a WAN gateway device (Wi-Fi, Cellular, and so on) for communications, such as the DCM-300, SNM941 or GX450 modem.
• Cabling to connect the display to your vehicle (see Part numbers in Cables section and Cable Guide).

You must also have done the following. There are different setup instructions depending if you are using FmX, FmX+ App or PIQ:

• If using FmX or FmX Plus, added and activated the FarmStream plugin. See Activating the FarmStream Fleet Plugin.
• The Utilization app must be downloaded and active for all customers using PIQ and for customers using the FmX+ app with TMX firmware 4.6 or higher. See Utilization app section. AutoStart should be turned on.
• If using PIQ for FarmStream, make sure Enable Operators feature is turned on. This feature is accessed by tapping the gear icon in the Precision-IQ application and selecting Users and Passwords.
• Completed the vehicle and implement setup settings for sending data to the Trimble Ag Software. See Implement reporting and Vehicle Monitoring for FmX or FmX Plus or Settings in Precision-iQ to use the Utilization app for FarmStream Reporting for PIQ.
• Firmware version 10.01 or higher is required for the FmX and version 4.3.1 or higher is required for the TMX, or firmware 5.5 or higher is required for PIQ on TMX. Firmware 1.5 or higher is required for the GFX-750 display.

Activating the FarmStream Fleet Plugin – FmX Plus or FmX

Please do the following to activate the FarmStream Plugin:

1. To use FarmStream with the FmX display or FmX Plus app, open the FmX Plus field application, or using an FmX display:
2. In the Home screen, tap Settings .
   Note: To add or remove features / plugins, you must access the Configuration screen from the Home screen.
3. At the Configuration screen, tap Add / Remove.
   
4. Select the FarmStream plugin from the list of plugins and then tap Add. The Select Active Plugins screen appears:
   
5. Tap OK. The system returns you to the Configuration screen.

The plugin has now been activated.

Set Up the Port – FmX Plus App

If using an EXP-100 expander module with the FmX Plus app (required for firmware versions lower than 5.5) do the following steps.

1. From the Configuration screen, choose system then tap setup.
2. Select Port setup and tap Setup.
3. Next to the EXP-100 #1 tap the select menu and choose the serial number of the EXP-100 device you are using.

Set Up the Port – FmX

If using an FmX display, do the following steps.

1. In the Configuration screen, select FarmStream, then tap on Setup.
2. Select the correct port on the display for connecting to the vehicle.

If an operator exceeds the functional speed limit for an implement, possible damage can occur to the implement, the vehicle, the crop, or the field. The FmX integrated display or TMX-2050 display (using the FmX Plus app) can send information to the Fleet in the Trimble Ag Software solution regarding the speed of vehicles and implements.

For Implement Setup settings, from the configuration page select implement:

On the Reporting tab, these settings determine the information that is sent from the FmX integrated display or TMX-2050 display to Fleet in the Trimble Ag software:

In the Monitoring tab you can select to send information about the vehicle speed to the Fleet solution in the Trimble Ag Software. Any amount that the vehicle travels over this speed is reported as speeding.

From the Configuration page, select Autopilot (Vehicle):

Select the Monitoring tab. If you set the Maximum Moving Speed to Off this means that the “speeding” state will not be used for the vehicle.

In the Enter the maximum moving speed for this vehicle screen, tap the buttons to set the maximum moving speed for the vehicle and then tap OK. This sets the threshold speed, above which the vehicle will considered to be “speeding”. See also the Maximum Transport Speed that can be configured as part of Implement Setup.

In this example, the Maximum Moving Speed has been set to 15 mph.

If delay reasons are enabled, and if the stopped to delayed timeout threshold is reached, the operator will be presented with a screen to explain the reason for the delay. This delay reason will be reported in the Trimble Ag Software.

In the Configuration screen, the user can see the FarmStream diagnostics. This shows the current vehicle sensors being reported.

The three sensors that are reported in the FmX+ app are Fuel Level, Fuel Rate, and Engine hours. Additional sensor data may be viewable in the Utilization app, depending on what sensors are reported by the vehicle.

To use the Utilization app and FarmStream Fleet reporting on the TMX-2050 or GFX-750 display with Precision-IQ™  field application, you must first set up the thresholds in the Precision-IQ app.

1. In the Home screen, tap the Precision iQ icon to open the app.
   After opening Precision-iQ, you can set up the Implement and Vehicle settings for the Utilization app, so the utilization data shows up as you want it to in FarmStream Fleet.
2. To set the Vehicle settings, tap on the vehicle tile on the Precision-iQ screen.
3. Edit an existing vehicle or create a new one. In the PRODUCTIVITY tab, set a threshold for the vehicle maximum moving speed for the Utilization app. Any time that the vehicle travels over this maximum moving speed, it is reported as speeding. If you turn the Maximum Moving Speed off this means that the “speeding” state will not be used for the vehicle in FarmStream Fleet.
   Note: The PRODUCTIVITY tab is only visible if the Enable Operators feature is turned on. This feature is accessed by tapping the gear icon in the Precision-IQ field application and selecting Users and Passwords.
4. To set the maximum moving speed option, tap Maximum Moving Speed. Choose a maximum moving speed for the vehicle and then tap the Check button. There is also an option to display the speed in US or Metric units. The range of the allowed moving speed that can be selected is noted in the dialog:
   
5. To set the Implement thresholds for the Utilization app, tap the Implement tile in the PiQ screen:If an operator exceeds the functional speed for an implement, possible damage can occur to the implement, the vehicle, the crop or the field. The GFX-750 or TMX-2050 display can send information about the implement status to FarmStream Fleet in the Trimble Ag Software solution.
6. To set up the implement, go to the PRODUCTIVITY tab in the Implement settings. Edit an existing implement or create a new one.
   Note: the PRODUCTIVITY tab is only visible if the Enable Operators feature is turned on. This feature is accessed by tapping the gear icon in the Precision-IQ field application and selecting Users and Passwords.
   These settings determine what information is sent about the implement from the Utilization app to FarmStream Fleet.
   
   The table below describes the different settings options:

   Setting	Description
   Maximum Transport Speed	The functional speed limit for transporting the implement. The options are On or Off and a numerical value for the speed. Maximum Transport Speed is used to determine when a vehicle enters the “speeding” state. The minimum of Maximum Transport and Maximum Moving speed will be used in this determination; Maximum moving speed is configured under the vehicle setup (PRODUCTIVITY tab). If Maximum Transport Speed is turned off, the Maximum Moving Speed for the vehicle is used to determine the “speeding” threshold (if Maximum Moving Speed is turned on).
   Maximum Operating Speed	The functional speed limit for the implement when coverage logging is on. The options are On or Off and a numerical value for the speed. Maximum Operating Speed is used to determine when the vehicle enters a “rushing” state.
   Stopped to Delayed Timeout	The length of time the vehicle can be paused before the vehicle is considered delayed. The options are On or Off. Stopped To Delayed Timeout is the amount of time that will pass after the vehicle has entered a “stopped” state before it’s considered to be in a “delayed” state (and the operator may be prompted to select a reason for the delay). Note: the value is set in seconds but displayed in minutes

   To set the Maximum Transport speed, tap on Maximum Transport Speed and enter a value in the range indicated. Select the Units, if required. Tap on the green check to save.

   

   Tap on the buttons Maximum Operating Speed and Stopped To Delayed Timeout to set the values and/ or select units for these two parameters.

   

   

Signing in as an operator is not required for Utilization or FarmStream to run, but if you want to see operator information in the application, you must sign in. In order to use operator login with PIQ, the Enable Operators feature must be turned on. This feature is accessed by tapping the gear icon in the Precision-IQ field application and selecting Users and Passwords.

To set up operator information, turn on your TMX-2050 or GFX-750 display. You should see the Operator app. Tap on the Operator app icon to launch it.

Operators can be created in the Fleet page of the Trimble Ag Software. All operators in the TMX-2050 and GFX-750 display’s organization are automatically sent to the TMX-2050 and GFX-750 display when it has connectivity. These operators can be seen under the Connected Farm menu in the Operator app.  If operators in the Fleet page are changed, any changes will be visible in the Operator app after the app has been killed and restarted, or when the TMX-2050 or GFX-750 display has rebooted.

Operators can also be created locally on the display, but they will not be send to the Trimble Ag Software to be seen on the Fleet page. These local operators will not show in the Connected Farm menu in the Operator app.

1. Login to the Operator app in order to track who is using the vehicle, for reporting in the Utilization app and FarmStream:
2. Enter or scan your operator PIN to login.
   Once logged in, the operator information will be recorded along with any utilization data.

If the Utilization app needs to be installed or updated, from the Launcher screen, tap on the App Central icon. Make sure that you have connectivity on your display so that you will be able to access App updates.

You will land on the Browse Apps page. Make sure “ALL APPS” is selected. Look for the Utilization app.

Tap on the Utilization app and it will open. You should see an option to Install or Update the app

Tap on Install or Update, and the app will be downloaded.

If you agree to it, tap yes on any confirmation messages that check that you want to add or update the app.

After installation, you will see the options to either uninstall or open the app. Tap on “OPEN.”

You will now be able to see Utilization information if using PIQ for FarmStream. If you use FmX+ for FarmStream, you must download the app but don’t need to do any other setup with it. For other information on how to set up FarmStream, please refer to the other sections of this document.

Make sure to check the Auto Start feature of this app so it start automatically each time you power on the display:

If it didn’t before, now the Launcher screen shows the Utilization app icon as an option to select:

In the Home screen, tap the Utilization app to start it.

The following is the Utilization app screen. It shows the operator (if available), vehicle status, vehicle thresholds, and implement thresholds.

If you tap on the settings gear in the upper right corner, you can set how many seconds elapse before a state is re-transmitted to FarmStream Fleet, and whether you want the app to AutoStart when the display is turned on. AutoStart is set to Off by default. If AutoStart is turned off, the user will need to open the Utilization app manually each time for this feature to work. There is also a reminder that a vehicle requires a Vehicle Connection license in order to use FarmStream Fleet. More information on the license is here. 

If the delay reason feature is enabled on the display, and the vehicle is stopped past the amount of time specified in the Stopped To Delayed timeout, a message will pop up, with a list of delay reasons for you to select.

Scroll through the list of reasons for the delay and tap on the numbered reason. Delay reasons are customized for the particular implement that is set up:

If a device does not have connectivity and the Utilization app has been enabled, you will see a warning message telling you that the Utilization app may cause memory on the device to become full. You should enable the connectivity of the device or disable the Utilization app until connectivity is restored.

check the diagnostics page to see the status of FarmStream running and all the sensor data available for that vehicle.

Location Setting for both the TMX-2050 and GFX-750 Display

1. From the home screen, go to SETTINGS
2. Select Location (under the “Personal” category)
3. Turn On the Location Setting

If Using GFX-750 Display

If using this app with the GFX-750 display, then you must set the following permissions on the GFX-750 display:

1. From the home screen, go to SETTINGS:
2.  Select Apps:
3. Select Utilization: 
4. Select Permissions: 
5. Enable Location and Storage: 

Agriculture Business Area
Trimble Inc.
Trimble Agriculture Division
10368 Westmoor Drive
Westminster, CO 80021
USA
trimble_support@trimble.com
agriculture.trimble.com

Copyright and Trademarks

© 2014-2017, Trimble Inc. Trimble, the Globe & Triangle logo, Connected Farm, and FmX are trademarks of Trimble Inc., registered in the United States and in other countries. Autopilot, Precision-IQ and TMX-2050 are trademarks of Trimble Inc. All other trademarks are the property of their respective owners.

Release Notice

This is the June 2018 release (Revision A) of the FarmStream Fleet Help. It applies to version 1.0 of the FarmStream Fleet solution.

Product Warranty Information

For applicable product warranty information, please refer to the Warranty Card included with this product, or consult your Trimble reseller.