MultiMatePlus

User & Installation Guide

Version 1.7

February 2021
 TOPTECH SYSTEMS

MultiMatePlus User & Installation Guide

© Toptech Systems
1124 Florida Central Parkway
Longwood, FL 32750
Phone 407.332.1774

Disclaimer
Toptech Systems assumes no responsibility for damages resulting from installation or use of its products.
Toptech Systems will not be liable for any claims of damage, lost data, or lost time as a result of using its
products.
Table of Contents
Overview............................................................................................. 3
Chapter 1 Getting Started ........................................................ 4
System Requirements .............................................................................. 4
Download and Install the MultiMate Plus application ............................... 4
1.2.1 Where to find the MultiMate Plus software ............................................................... 5

1.2.2 How to install the MultiMate Plus software ............................................................... 5

Chapter 2 User Interface Overview....................................... 6

Main Menu Screen ................................................................................... 6
2.1.1 Navigating the Main Menu ........................................................................................ 6

2.1.2 Devices List / Overview ............................................................................................. 7

2.1.3 Using Site Folders ..................................................................................................... 8

2.1.4 Importing and Exporting Devices / Sites ................................................................. 10

Chapter 3 Create a New Device ........................................... 11

Connect to a MultiLoad using Ethernet .................................................. 11
Connect to a MultiLoad using Line Controller (LC) ................................ 12
Create New Device without a Connection .............................................. 13
Test connection...................................................................................... 14

Chapter 4 Navigating and Editing Configuration............. 15

Configuration Options ............................................................................ 15
Configuration Toolbar ............................................................................ 17
Navigating Configuration Menus ............................................................ 18
4.3.1 Editing Configurations ............................................................................................. 19

4.3.2 Network & Serial Comm Menu ................................................................................ 20

4.3.3 Equipment Configuration Menu .............................................................................. 20

4.3.4 Products Configuration Menu ................................................................................. 21

 4.3.4.1 Easily create base Components, Additives and Samplers .................................. 21

4.3.4.2 Easily create Saleable Products .......................................................................... 22

4.3.5 Alarms Configuration Menu .................................................................................... 26

Chapter 5 Generating Reports .............................................. 27

FCM Map Report ................................................................................... 27
Configuration Report .............................................................................. 29
Transaction Report ................................................................................ 30
W&M and Audit Log ............................................................................... 30

Chapter 6 MultiLoad Utilities ................................................ 31

Importing Logos ..................................................................................... 31
Command Console ................................................................................ 32
Upload Firmware.................................................................................... 34
BOL Editor ............................................................................................. 36
Custom Logic ......................................................................................... 38
6.5.1 Getting started......................................................................................................... 39

6.5.2 Building a configuration ........................................................................................... 40

6.5.3 Continuing Configurations ....................................................................................... 41

6.5.4 Saving / Exporting Custom Logic Configurations ................................................... 43

Chapter 7 Software Revision History ................................. 46

7.1.1 Overview ................................................................................................................. 46

7.1.2 Software Changes................................................................................................... 46

MULTIMATE PLUS

Overview
This document is designed to quickly guide the users of MultiLoad II products to the most common uses of
MultiMate Plus, a MultiLoad configuration tool. This guide will help users to set up MultiMate Plus and familiarize
them with navigating the menus for interaction with all Toptech’s MultiLoad II family of electronic load rack
controllers.

The following table provides an information map to the material available in this guide.

Chapter Topics Covered

1.Getting Started System requirements, Download and Installation Instructions.

2.User Interface Overview Navigation of MultiMate Plus main menu and configuration toolbar.

3.Create a New Device Setting up a MultiLoad connection using Ethernet, TMS Line Controller or Offline
configuration.

4.Configure a MultiLoad Navigation of Network & Serial Comm, Equipment Products and Alarm
configuration menus.

5.Generating Reports Overview of how to generate the various reports offered by MultiMate Plus.

6.MultiLoad Utilities Overview of the Command Console, Firmware Upload, BOL Editor, Custom Logic
and Import Logo features.

7. Software Revision History Summary of changes made in each version of MultiMate Plus.

The following key makes it easier to find the information you need in this guide:

ICON KEY
Valuable Information

Configuration

Connection

MultiLoad Manual

Note that this guide covers MultiMate Plus functionality only. For information about base MultiLoad firmware
please consult the MultiLoad II User Guide. For information about wiring please consult the MultiLoad II
Installation Guide. For information about the MultiLoad register interface and Modbus communication, please
reference the MultiLoad II Communication Guide. Updated versions of all manuals, including this one, are
available on our website at http://www.toptech.com.

3
MULTIMATE PLUS

1
Chapter

Chapter 1 Getting Started

This chapter indicates the system requirements needed to run the MultiMate Plus application on your computer
and explains how to download and install it ready for use. Let’s get started!

System Requirements
• OS: Windows 7 or higher
• RAM: 390 MB or greater
• System Software: Microsoft .NET Framework 2.5 or higher

To obtain the latest version of the .NET Framework, visit http://www.microsoft.com/NET/ and follow the
instructions for your specific system.

Download and Install the MultiMate Plus application

Before installing the latest version of MultiMate Plus - uninstall any version of MultiMate Plus prior to v1.2.
MultiMate Plus does not support connectivity to MultiLoad firmware versions vX.31.07 and earlier.

4
MULTIMATE PLUS

1.2.1 Where to find the MultiMate Plus software

Visit https://www.toptech.com/multimate-plus.html and select the latest version of MultiMate Plus and
download the .zip file.

1.2.2 How to install the MultiMate Plus software

1. After downloading MultiMate Plus, open the .zip folder and run the setup.exe file by following the
instructions of the Setup Wizard.

2. After the installation of the program, open MultiMate Plus from your Windows Start Menu. Windows
Start Menu>Programs>Toptech Systems.
You should also see a shortcut on your desktop to launch MultiMate Plus.

3. After installation of the program you will be able to start using the MultiMate Plus tool.

5
 MULTIMATE PLUS

2
Chapter

Chapter 2 User Interface Overview

This chapter provides an overview of what is available in MultiMate Plus, navigation of the Main menu and
configuration toolbar.

Main Menu Screen

Opening MultiMate Plus, the main menu screen is the first screen to appear; from here you will be able to go to
the different tools available in the application and get an immediate overview of all units previously connected or
saved.

2.1.1 Navigating the Main Menu

Opening MultiMate Plus, the main menu screen is the first screen to appear. From here you will be able to
navigate to the following menu options:

• Create a new device connection and see projects list, more info in Chapter 3
• MultiLoad configurations, more info in Chapter 4
• Use the Import Logo feature, edit your BOL with the BOL editor and edit Custom Logic with the Custom
Logic Editor, more info in Chapter 6

Return Open Open Open Create New Device or

to devices. Import Logo. BOL Editor. Custom Logic Tool. Site

Import a Site or Export a Site or

Open existing MultiLoad configurations or Site folders. Device. Device.

6
MULTIMATE PLUS

2.1.2 Devices List / Overview

If it is not the first time you are using the MultiMate Plus application you will see that the main menu
screen will also show you a full list of all MultiLoad devices with configurations that you have already setup
in the past for quick access, consultation and/or modification.

Additionally, this screen will show Site folders that can be used to organize MultiLoad devices. Both devices
and sites can be exported from MultiMate plus and then imported into another version of MultiMate plus
to encourage device sharing.

To access a device or site, double click on the item and if the selected item is a device then the device
configuration page will be displayed. If the item selected is a site, then the page will update to show the
devices contained within the selected site.

Users also have the ability to copy / paste / delete devices and sites using the subtoolbar buttons or using
hot keys (Ctrl+C for Copy, Ctrl+V for Paste and DEL or Backspace to Delete). When a device is copied and
pasted, the device configuration as well as device profile information will be duplicated for the new device.
A site can also be duplicated by using the copy and paste functionality.

Right clicking a device reveals options to Edit Profile, Export Device (or
Site), Move To (a Site folder), Test Connection, Upload Firmware or Delete.

7
MULTIMATE PLUS

2.1.3 Using Site Folders

In addition to creating devices in the Main Menu, users can also create Site folders which allows for organizing
several devices in one directory. A site can only be created on the Main Menu and nested Site folders (ie, a site
within a site) are not permitted. A new Site can be created as shown below:

Create New Device or

1 Site

2 Create New Site

Like devices, sites also contain a context menu which can be displayed by right-clicking on the site. Context menu
options for the site include: Edit (edit the site name), Export (export a site and all devices to a file) and Delete
(delete the site and all devices within the site).

Right clicking a site reveals options to Edit

Site, Export Site or Delete.

8
MULTIMATE PLUS

To move a device into a Site, users should select the “Move To” option from the device context menu and select
the site to move the device into the selected site. While inside a site, the “Move To” option will contain a
Workspace option that will send the selected device back to the Main Menu screen.

Open the device context menu Select a site to move the

by right-clicking on a device. 1 device into the site. 2

To view the devices within a site, double-click on the site to update the device list. Within a site, users can create
a new device and the device will be added directly to the open site. To go back to the Main Menu display, select
the Workspace link.

Site name (TTL) shows that we’re within a site.

Click on the Workspace link to

get back to the Main Menu.

9
MULTIMATE PLUS

2.1.4 Importing and Exporting Devices / Sites

MultiMate Plus also has the option to export devices and sites to a .zip file which can then be sent to other
MultiMate Plus users and imported into their own MultiMate Plus software. Users can export a single device, a
site (with all the devices in the site included) or all devices and sites.

When exporting a device or site, the selected device configurations will be exported as well as device profile
information and any prompts used for those devices.

Exporting a device or site can be accessed from either the device or site context menu (display by right-clicking on
a device or site) or alternatively, by selecting a device and then pressing the Export button in the Main Menu. To
export all devices and sites, select the “Export All Devices and Sites” button from the Export button menu.

Select the device or site to Either export the selected device or export all
export. 1 2 devices and sites from the Export button.

To import devices and sites, select the Import button from the main menu and select the Multiload .zip file that
was exported previously. If there are any naming conflicts on import, MultiMate Plus will add a date and time
stamp to the imported devices and sites.

Import a device or site

1 from the Import button.

10
MULTIMATE PLUS

3
Chapter

Chapter 3 Create a New Device

This chapter walks through the steps on how to create a new device/file in the application and how-to setup a
connection to a MultiLoad using 3 different ways: Ethernet communication, via a TMS Line Controller or an
offline configuration setup.

Upon launching MultiMate Plus, you can configure the connection with the MultiLoad preset you wish to link up
with and run a test.

Connect to a MultiLoad using Ethernet

This section provides a guideline to setup a connection to a MultiLoad using Ethernet communication.

Enter the Name & corresponding IP Address

of your new MultiLoad device. 2 Select Create New Device. 1

11
MULTIMATE PLUS

Connect to a MultiLoad using Line Controller (LC)

Connecting to a MultiLoad device using the TMS6 or TMS7 Line Controller (LC) connection is outlined in the
diagram below.

Enter device Name, corresponding IP Address, Select Create New Device.

2 1
Terminal ID (not required for TMS7) and LC Name
of your new MultiLoad device.

12
MULTIMATE PLUS

Create New Device without a Connection

Setting up a configuration, but without a predefined unit/connection is also possible. If you would like to edit a
configuration, but not specifically linked to a certain MultiLoad you can go ahead and create a blank connection.
This file can then be saved in the application and uploaded to MultiLoad devices later.

Enter device Name & leave IP Address blank. 2 Select Create New Device. 1

13
MULTIMATE PLUS

Test connection
Verify the connection to your device by selecting Test Connection in your devices drop down menu. If your device
fails to connect check your connection settings on MultiMate Plus and your MultiLoad.

14
MULTIMATE PLUS

4
Chapter

Chapter 4 Navigating and Editing Configuration

Now you finished establishing a connection between MultiMate Plus and the MultiLoad, get ready to
configure the unit! This section shows you how to navigate the configuration menus and how you can
easily adjust and set the parameters on the MultiLoad using MultiMate Plus in 4 areas: Network & Serial
Communication, Equipment, Products and Alarms.
More information on defining configuration parameters and how to set up your device can be found in the
MultiLoad User Guide.

Configuration Options
After defining the connection settings to your device, select one of three configuration options from the
New Device window before editing the configuration settings.

Start configuration from Copy configuration from Start configuration

factory defaults. MultiLoad device to MultiMate. from a saved .mlc file.

MultiMate Plus provides firmware prompts v x.31.11 and newer, older prompts should be downloaded from
your device.

15
MULTIMATE PLUS

When loading a new configuration onto an existing configuration the MultiMate Plus tool will highlight all the
differences in parameters. By using the checkboxes, you can accept or reject individual changes in parameters
before importing the new configuration.

Un-checked parameters will

be accepted.

Checked parameters will be

rejected.

16
MULTIMATE PLUS

Configuration Toolbar
When working on the actual configuration there is a toolbar displayed in the right-hand corner. Find out here
what each of the icons do:

Edit connection settings, test connection, upload firmware

and access the command console.

Save changes status.

Import Configuration file from computer to MultiMate or download the

configuration from MultiLoad into MultiMate.

Export reports from MultiMate to a computer file, upload configuration from MultiMate to
device, or export configuration from MultiMate to computer file.

Save configuration changes.

Save Status

Changes have been saved.

Changes have not been saved.

17
MULTIMATE PLUS

Navigating Configuration Menus

MultiMate Plus provides easy navigation to change and review the following configuration menus: Network &
Serial Communication, Equipment, Products and Alarms.

Configuration menus follow the same structure, a left menu bar for navigation and the detail parameter settings
in the right window.

Navigation menu. Available configuration

parameters associated
with the level that was
selected.

18
MULTIMATE PLUS

4.3.1 Editing Configurations

When modifying parameters MultiMate Plus uses a color code to highlight parameters with a different value than
the default setting. Red means the value entered is outside the configurable range, yellow means the value is
different than the default, and blue means the value is current being edited.

Red = value enter is out

of range

Yellow = different than

default setting

Blue = value currently

being edited

The parameters in red text indicate a Weights & Measures protected parameter – just like in the MultiLoad itself.

19
MULTIMATE PLUS

4.3.2 Network & Serial Comm Menu

After establishing connection to a device, the network and serial communication settings can be changed.

Navigate through Serial

connection options.

Navigate through
Network connection
options.

Setting up Network & Serial Comm configuration will update the configuration settings but will not change the
current connection profile in MultiMate Plus.

4.3.3 Equipment Configuration Menu

In the equipment configuration screen, the left menu bar allows for easy navigation between presets and lower
level equipment set ups.

In the equipment configuration menu, there are two parameter types, numerical values and drop-down menus.
Numerical value data types require a number within the allowable range of the MultiLoad. Drop down menus
have an arrow to the right revealing the available parameter options. For simple navigation a MultiLoad symbol
designates the default setting and pink text specifies the current parameter setting in drop down menus.

20
MULTIMATE PLUS

Numerical value data field.

Arrow indicates drop down menu

option.

MultiLoad symbol indicates default

setting.

Pink indicates current setting.

4.3.4 Products Configuration Menu

The product configuration menu allows for easy setup and navigation of base components, additives, samplers,
and saleable products.

4.3.4.1 Easily create base Components, Additives and Samplers

Base components, additives and samplers can be easily created and authorized by using the top three windows in
the configuration window.

See how to navigate the screen:

21
MULTIMATE PLUS

Select the garbage icon to delete

multiple components at once.

Up arrow indicates side menu is

expanded.

Down arrow indicates side

menu is contracted.

Assign component to preset(s).

Delete individual component.

Configure the Product code, Short and Long Description.

4.3.4.2 Easily create Saleable Products

The product wizard of the MultiMate Plus application simplifies setting up saleable products into five steps. Using
the wizard, you will be able to edit the product code, short description, long description, and product recipe.

22
MULTIMATE PLUS

Select the ‘+’ to access the product wizard.

Follow the 5 steps in the product setup wizard to have a finalized saleable product.

1 Define the Product code, Short and Long Description.

23
MULTIMATE PLUS

Select the base components, additives, and samplers that are a part of the saleable product. More than one of
each can be selected; product recipe percentages can be adjusted in the final step of the product wizard.

2 3 4

Select base components. Select additives. Select samplers.

After defining the components of the product recipe, edit the recipe percentages for each component and
additive. Additional adjustments can be made in the product configuration menu.

5 Select Finish to finalize product setup. Edit the recipes.

4

24
MULTIMATE PLUS

Additional changes can be made in the Saleable Products menu, including preset authorization and all features
available in the product setup wizard.

Select to edit authorized

presets for product.
Configure product recipe percentages.

Select contributing
components, additives
and samplers.

25
MULTIMATE PLUS

4.3.5 Alarms Configuration Menu

Use the alarms configuration menu to define alarm conditions and permissives at the various configuration levels.
All alarm setup screens will indicate who has the authority to clear the alarm or how the alarm is to be cleared.

Select which level alarm to configure.

Configurable connection settings, alarm names and FCM output ports can be edited from the detailed screen.

Edit alarm names by selecting

the pencil icon.

Select the ‘?’ icon to know more

alarm information and what triggers
it.

Setup FCM output address within

alarm configuration.

26
MULTIMATE PLUS

5
Chapter

Chapter 5 Generating Reports

MultiMate Plus also includes features allowing users to generate and view different types of configuration
reports and export them to .csv file formats.

FCM Map Report

The FCM Map report can be used to generate a list of the FCMs and ports used by the device. The FCM Map
Report is available by selecting FCM Map in the navigation bar at the top of the device project page:

Open
FCM Map report.

27
MULTIMATE PLUS

After opening the FCM Map report, users should import their configuration from a device or file if they
haven’t done so already. Importing the device configuration will automatically update the FCM Map report
for the device.

FCM Number. FCM warnings and FCM Type.

errors will be displayed
when hovered over.

The FCM Type is not configurable in the MultiMate Plus application. If you want to modify the FCM Type, then
you need to configure it using the keypad on the MultiLoad device.

28
MULTIMATE PLUS

To export the FCM Map report to a .csv file, users should select Export Configuration Icon > Export Report >
FCM Map option from the toolbar. This will allow the user to save the file in .csv format to a directory of
their choice on their local machine.

Export Configuration
1 icon.

Configuration Report
The Configuration report can be used to generate a .csv file that will contain a table listing all the
equipment configuration parameters (Low Flow Rate, High Flow Rate, K-Factor, Meter Factors, etc.). To
export the Configuration report to a .csv file, users should select Export Configuration Icon > Export Report
> Configuration Report option from the toolbar. This will allow the user to save the file in .csv format to a
directory of their choice on their local machine.

Export Configuration
1 icon.

29
MULTIMATE PLUS

Transaction Report
The Transaction report can be used to generate a .csv file that will contain a table listing all the
transactions as produced by the MultiLoad (with BOL#, Start / Stop Time, Product Code, Delivered etc). To
export the Transaction report to a .csv file, users should select Export Configuration Icon > Export Report >
Transaction Report option from the toolbar. This will allow the user to save the file in .csv format to a
directory of their choice on their local machine.

Export Configuration
1 icon.

W&M and Audit Log

The W&M and Audit Log can be used to generate a .csv file that will contain a table listing recent W&M or
Audit log changes. Once these logs have been retrieved from the device, they cannot be retrieved again. To
export the W&M or Audit log to a .csv file, users should select Export Configuration Icon > Export Report >
W&M Log (or Audit Log) option from the toolbar. This will allow the user to save the file in .csv format to a
directory of their choice on their local machine.

Export Configuration
1 icon.

30
MULTIMATE PLUS

6
Chapter

Chapter 6 MultiLoad Utilities

MultiMate Plus utilities are additional features allowing user to more easily setup, customize and update
their MultiLoad. These features include importing logos, editing and viewing a BOL, the command console
and using the application to help with a firmware upgrade.

Importing Logos
Using the Import Logo feature users can easily display their logo on the MultiLoad home screen. This feature
helps to position and upload the logo to the device.

Open compatible Use Save As... to 3 Upload image to

1 image (.jpeg .png). save imported logo. selected devices.

Preview the final image in the Preview

Image. Easily adjust the size and
2 position of the logo in the Original
Image.

Coloring and edits to the logo cannot be made within this tool.

After adjusting the logo size and position press upload and this dialogue box will appear. Select the MultiLoad
devices to upload your logo and press accept.

31
MULTIMATE PLUS

Command Console
After opening a device connection, the command console allows users to read and update registers within the
MultiLoad configuration. Selecting the name of your MultiLoad Device in the upper right corner will reveal a
menu with the firmware version, connection profile, and command console, test connection and firmware
upload feature.

After selecting the command console feature a dialogue box will appear. Typing R### will read a specific register,
typing U### followed by a command will update that register with the new command.

32
MULTIMATE PLUS

Command console log.

Send command to MultiLoad.

Type read or write commands here.

Any changes made using the command console will update the MultiLoad configuration immediately.

An ESC character will be represented as an ← and can be inserted by copying and pasting it from another
program (i.e. Notepad++) or by pressing ALT + 27 at the same time. In order to use the hotkey method, you will
need to use the number pad on your keyboard when typing in the number 27.

More information on register locations is in the MultiLoad Communications Manual.

33
MULTIMATE PLUS

Upload Firmware
The MultiMate Plus application allows users to update the firmware of their MultiLoad via Ethernet or Line
Controller.

You can find this feature in the configuration menu of your device accessing it through the menu when clicking
the device name.

After establishing a connection to the MultiLoad, the firmware version can be updated using the Upload
Firmware tool. Open a firmware file (.bin) specific to your version of MultiLoad.

34
MULTIMATE PLUS

Uploading firmware might take some time. Be aware that uploading firmware using the MultiMate Plus over line
controller is significantly slower than over Ethernet.

After the firmware finishes loading, a confirmation screen will appear. Verify the MultiLoad is not in use and you
have saved your configuration before accepting. Accepting will initiate the upgrade process.

Download the latest firmware at https://www.toptech.com/documentation.html

Select the latest version of MultiLoad Firmware and download the .zip file to your computer.
When upgrading firmware version older than v x.31.07 - if you experience any issue - contact Toptech Systems.

35
MULTIMATE PLUS

BOL Editor
The BOL Editor utility in the MultiMate Plus allows users to easily create a custom meter ticket and upload the
template to your MultiLoad. After modifying the ticket users can also save the template to their computer and
upload it to later to (other) MultiLoad devices. At the same the tool allows to download an existing template from
a device to work on this one and open & use an existing BOL template from your computer.

The BOL Editor opens to the default MultiLoad meter ticket. Header components, detail components and total
components can all be easily added, deleted and rearranged by dragging and dropping them on the BOL ticket
area. The static text can be added by selecting the Text button on the screen and clicking in the BOL work area in
the place where you want to add it. After dragging and dropping components and adding static text these fields
can still be repositioned using the cursors of your keyboard.

Import BOL templates from device or computer.

Save BOL templates to device or computer.

Text within BOL editor is indicated by black

for static text and red for populated fields.

Pin value to the product detail line.

The paper size of the BOL work area can be easily adjusted using the ‘Page button’ in the ribbon. For custom
paper sizes you can resize the page by sliding the edges of the BOL work area. The actual size will be displayed as
a number of rows and columns in the top right corner.

You can toggle the grid button to see a print preview of your ticket.

36
MULTIMATE PLUS

Add a line of text. Clear the BOL window. Change the paper size. Toggle grid display.

Drag and drop header, detail and Total

components on the grid to customize your BOL.

There is a maximum of 30 lines of static text available per meter ticket.

37
MULTIMATE PLUS

Custom Logic
The custom logic utility in MultiMate Plus provides a user-friendly tool to build, edit, and comment custom
logic configurations. Custom Logic made easy!

Select Custom Logic button to reach this utility.

Line number displays Function displays the Comments are

the registers storing custom logic functions entered by users and
custom logic values. used to build the do not affect the logic.
logic.

38
MULTIMATE PLUS

6.5.1 Getting started

To open the Custom Logic utility from the Workspace screen, click the ‘Custom Logic’ Utility. On the main
page the first 15 lines of a blank custom logic configuration will be displayed.

There are two ways to begin a custom logic configuration:

1. Import a custom logic configuration from a device or file
2. Create a configuration from scratch in the tool

Select up arrow to export to file or device.

Selecting firmware
identifies functions not
Select down arrow to import from file or
available in that version.
device.

Comments entered in the custom logic utility will only be saved on firmware versions X.31.39 or greater.

39
MULTIMATE PLUS

6.5.2 Building a configuration

Whether opening an existing custom logic configuration or starting a new configuration, select the function
field in the custom logic tool to begin. Use the mouse or arrow keys to navigate the group drop down menu
to select a function.

Typing the beginning of a function will autofill the field with relevant functions.

Groups Functions
menu. menu.

Functions are characterized by the line number, equipment level assignment and input/output parameters.
See an example of this below:

Group = Write Configuration

Function = PRESET_WRITE_CFG
Input Parameters = Low Flow Rate, Preset Number
Output Parameter = Line Number [0004]

40
MULTIMATE PLUS

6.5.3 Continuing Configurations

The custom logic utility includes editing and comments that are not available on the MultiLoad devices.

Function buttons allow for quick editing features.

Select the ‘?’ for more information on the group,

Select the ‘+’ to add 15 more lines, function, inputs, available firmware version,
up to 1024 total lines. description and examples.

Multiple lines can be selected at a time and the editing features can be controlled by shortcuts or right
clicking with the mouse. The following hot key shortcuts below are available in the Custom Logic Utility:

Hot-Key Function Description

CTRL+C Copy Copy the highlighted row(s).

41
MULTIMATE PLUS

Hot-Key Function Description

CTRL+V Paste Paste copied row(s)

CTRL+A Select All Select all rows in the worksheet

CTRL+X Cut Cut the selected row(s)

CTRL+S Save To File Opens the file explorer to save custom logic configuration to a file

Delete Delete Row(s) Delete the highlighted rows

Backspace Delete Row(s) Delete the highlighted rows

Esc Escape De-selects any highlighted or copied rows

For more information on groups, functions and parameters consult the MultiLoad User’s Guide.

42
MULTIMATE PLUS

6.5.4 Saving / Exporting Custom Logic Configurations

After completing a custom logic configuration in MultiMate Plus you can export the configuration to:

1. A .mlc file

2. A device or multiple devices

When uploading the configuration to a device, a button to “Validate Configuration” will be available in the
“Save Custom Logic To Device” dialog box.
Check configuration by selecting the
“Validate Configuration” button.

Selecting “Validate Configuration” will check if there are any configuration warnings or errors. If issues are
found with the configuration, a “View Issues” button will appear next to the device.

Firmware version and custom logic incompatibility

are displayed after clicking ‘View Issues’.

43
MULTIMATE PLUS

Any issues found will be displayed in the “Custom Logic Issues” dialog box after selecting the “View Issues”
button above. Issues are displayed as either warnings (yellow symbol) or errors (red symbol).

A warning is typically displayed when a custom logic function in the custom logic tool is exported to a
device where the custom logic function isn’t available in the device’s current firmware version.

Warning Symbol Function Name Warning Message

Line Number Group Name

An error is displayed when the custom logic line has been configured incorrectly. This can be due to
configuring an incorrect function, parameter or selecting a firmware version from the “Select Firmware
Version” dropdown box that is incompatible with the configured custom logic function.

Error Symbol Function Name Error Message

Line Number Group Name

The Custom Logic Utility will only read and write the 1024 custom logic registers. All other configuration
parameters will be ignored.

44
MULTIMATE PLUS

Known conflicts between the MultiLoad and MutliMate Plus custom logic are listed below.

Functions Version Description

Meter_Reset_Totalizers vX.31.17-19 The line reference parameter is not being saved correctly.

Component_Reset_Totalizers vX.31.17-19 The line reference parameter is not being saved correctly.

Additive_Reset_Totalizers vX.31.17-19 The line reference parameter is not being saved correctly.

Sampler_Reset_Totalizers vX.31.17-19 The line reference parameter is not being saved correctly.

Email_Message vX.31.37 – vX.31.39 MultiLoad does not import parameters correctly. The
Email_Message parameter will be set to Email Msg 1 and the line
reference will be set to [0000].

45
MULTIMATE PLUS

6
Chapter

Chapter 7 Software Revision History

7.1.1 Overview
This revision summary is designed to assist in the determination of what changes have been made between
different software builds and releases.

7.1.2 Software Changes

10/4/2016 TF:
Initial Release: v4.31.30.05

*************************************************************
Changed version to v1.1
*************************************************************
2/20/2016 TF:
Fix: Text input fields for configuration parameters.
Reduced wasted space in the equipment registers page, the alarms page, and the config changelists dialog box.

3/14/2017 MH
Added logo editor

6/22/2017 MH
Added support for communication through the LC to pull configuration from MultiLoad.

6/27/2017 TF
Fix: Bug with creating/saving more than one set of additive configuration parameters.

8/21/2017 TF
Got rid of the grid view from the workspace.

8/28/2017 TF
Fix: Bug in page layouts for the products page and product wizards for versions 4.32.x
Fix: Exporting base sampler products were broken for versions 4.32.x
Added alarm description for *DIVERT alarm.
Fix: The unsaved/saved changes icon would not update after a menu item parameter was changed (API Table, Processing Mode, etc...).

8/31/2017 TF
Fix: Alarms and Network page layouts when window was minimized.
Fix: Download/Import alibi printer configuration parameter.
Fix: Download/Import terminal name and print # of copies parameters.
Fix: Bug with exporting sampler assignments to the preset definitions for versions 4.32.x
Fix: Bug with importing configuration file, if number of samplers or additives were configured to zero. If the user attempted to increase the
number from 0, the pages for the additive/sampler equipment configs would be blank.

46
MULTIMATE PLUS

Workaround (MTL Bug): Added missing serial parameters for all versions less than vx.31.14.
Workaround (MTL Bug): Added missing prompt for parameter "Flow Control Valve Type". Version x.31.36 would not return the prompt.
Updated the default configs to version 4.31.36

*************************************************************
Version to v1.2
*************************************************************
9/15/2017 TF
Added BOL Editor Tab to workspace navigation bar
BOL Editor (Step 1): Display a grid and allow the user to adjust the dimensions.

9/27/2017 TF
BOL Editor (Step 2): Display all BOL components in a container on the left-hand side of the page.

10/13/2017 CM
Change List View icon to Home icon.
BOL Editor (Step 3): Download BOL parameters.
BOL Editor (Step 4): Download BOL literals.

10/19/2017 CM
BOL Editor (Step 5): Upload BOL parameters.

10/23/2017 CM
BOL Editor (Step 6): Upload BOL literals.

10/30/2017 CM
Firmware Update: Firmware update functionality added.
Firmware initiate added.

10/31/2017 CM
Enter key functionality on command console added

11/2/2017 TF
BOL Editor (Step 7): Added drag and drop functionality for components list.

11/6/2017 CM
BOL Editor (Step 8): Export BOL to file and import BOL from file.

11/10/2017 TF
BOL Editor (Step 9): Added the enforcement of business rules for the BOL editor.
- We will ensure that the product detail components are always on the same line.
- We will allow a user to pin the totals to the line below the product details (99 rule)
- We will auto generate text based on the configuration of some of the components (MTL logic is used)

11/10/2017 CM
BOL Editor (Step 10): Added the BOL editor sub-toolbar
BOL Editor (Step 10): Added the option to import a BOL directly from the device into the BOL Editor

11/28/2017 TF
BOL Editor (Step 11): Added the ability to add/modify static text
Fix: Bug in import logo tool that wouldn't open the same image file twice after leaving the import logo page. After leaving the page you
would have to open a different image file, and then reopen the previous one.

11/29/2017 TF
Fix: Bug in the alarm configuration pages that wouldn't download/show/upload the new Require Authentication alarm parameter. This
only affects MultiLoads with firmware version greater than x.31.35

47
MULTIMATE PLUS

12/7/2017 TF
Added a dialog box that displays a progress bar while uploading a configuration and will warn the user when the W&M bolt is still in the
device when trying to upload the config.

12/21/2017 TF
Fix: Added the equipment security registers (R134...) to the Import/Export routines when Importing/Exporting a configuration.

12/28/2017 TF
Fix: Flow Control Valve Type prompt for the MultiLoad default config. The UI wasn't displaying a dropdown menu.
Fix: Importing/Exporting of FCM Analog Input type parameters (BSW1 Sensor FCM#, BSW2 Sensor FCM#, API Gravity Sensor FCM#, etc...)
Fix: Equipment page input boxes for signed_div format types not allowing you to set a value below -0.9 (SIGNED_DIV10), -0.99
(SIGNED_DIV100), -0.999 (SIGNED_DIV1000), or -0.9999 (SIGNED_DIV10000).

*************************************************************
Version to v1.3
*************************************************************
3/6/2018 CM
Added Custom Logic Tab to workspace navigation bar
Custom Logic Tool (Step 1): Added custom logic sub-toolbar

3/15/2018 TF
Custom Logic Tool (Step 2): Created a custom logic worksheet to allow a user to configure a line of custom logic.

3/16/2018 TF
Custom Logic Tool (Step 3): Created a "+" button at the bottom of the worksheet to display more rows in the worksheet.

3/19/2018 CM
Custom Logic Tool (Step 4): Import custom logic registers from device and file.
Custom Logic Tool (Step 5): Export custom logic registers to device and file.

3/23/2018 CM
Custom Logic Tool (Step 6): Added a question mark tooltip to display function information when clicked.

3/23/2018 TF
Custom Logic Tool (Step 7): Added group menu display and nested menu displays.

4/10/2018 CM
Custom Logic Tool (Step 8): Added "Validate Configuration" button to check for errors between configured functions firmware version and
device firmware version when uploading to device.

4/12/2018 TF
Custom Logic Tool (Step 9): Added support to filter through function menus while typing.

4/13/2018 CM
Added ability to upload firmware to a device by right clicking on a device in the "Projects" page.

4/24/2018 CM
Fix: Bug in the "Products" page when entering percentages into the additive and component input box. Also fixed in the Saleable Wizard
screens.

4/30/2018 CM
Custom Logic Tool (Step 10): Added a tooltip when configuring a custom logic function to show the function name, active parameter and all
parameter types in the function.

5/4/2018 TF
Custom Logic Tool (Step 11): Added real time parameter, read / write configuration and real time alarms dropdown menu with selectable
menu items.

48
MULTIMATE PLUS

5/8/2018 CM
Custom Logic Tool (Step 12): Added the ability to insert, cut (ctrl+x), copy (ctrl+c), paste (ctrl+v), delete (del or backspace key) and select all
(ctrl+a) custom logic rows.

5/17/2018 CM
Fix: GMT timezone parameter for NTP server added.

6/15/2018 CM
Custom Logic Tool (Step 13): Added a check for incorrect configurations in the worksheet in the "Validate Configuration" button when
uploading to device. These are displayed with a yellow icon as "warnings"

6/21/2018 TF
Added support for Preset/Meter/Component/Sampler/Additive permissives and alarms 0-5 added in MultiLoad firmware version X.X.39.

6/28/2018 CM
Custom Logic Tool (Step 14): Added the ability to select a firmware version from a dropdown list which filters out functions and parameters
for that firmware. Also checks if configured lines in the worksheet are supported by the selected firmware version.

7/27/2018 TF
Fix: Uploading of FCM_ADDRESS type registers for versions older than versions x.31.27. The formatting of the value was incorrect for these
versions.

*************************************************************
Version to v1.4
*************************************************************
3/5/2019 CM
Fix: bug causes screen to freeze when navigating from configuration page to the custom logic page.

3/11/2019 TF
Modified the permissive 1 - 5 alarm descriptions for Preset, Meter, Component, Additive, and Sampler levels to match description format at
the bay level.

3/28/2019 CM
Fix: Custom Logic and BOL import of configuration file from old MM tool (handle Q and F commands).

4/17/2019 CM
Encode MM+ characters sent to MultiLoad as UTF8 to allow for multilingual support.

5/2/2019 CM
Removed all references to Gross and Net and replaced them with GOV and GSV.
Added IV, NSV, K-Factor and Meter Factor to the BOL Editor.

5/10/2019 CM
Added an SCS level in MM+ for SCS devices. Includes Default Report Day / Time Triggers, SCS Prompting and SCS Default Report Type
Add support for registers added in firmware versions 4.33.00 and 4.33.01 (SCS parameters, Meter Names)

5/14/2019 CM
Fix: Importing a configuration without any parameters assigned to additive #1 on preset #1 causes the application to display a blank page
when selecting the new additive page.

6/7/2019 CM
Added an FCM Map report. Can be accessed by selecting a device in the 'Workspace' page and then 'Reports' from the toolbar. The FCM
Map Report can also be exported as a .csv file.

6/11/2019 CM
Fix: Importing custom logic into the custom logic tool didn't automatically set the firmware version for the configuration in the toolbar.

49
MULTIMATE PLUS

6/13/2019 TF
Fix: Improved performance when uploading / downloading config or firmware to a device when using the line controller.

*************************************************************
Version to v1.5
*************************************************************
10/2/2019 CM
Fix: Exception occasionally thrown when downloading Products / Bay Alarms (reduced message chunk size). This also addresses issues
related to some parameters not being uploaded to the device if communicating via an ethernet connection.

10/4/2019 CM
Added configuration .csv report.

10/31/2019 CM
Removed Material-UI RaisedButton components and replaced them with our own UI components.

11/12/2019 CM
Removed Material-UI Checkboxes components and replaced them with our own UI components.

1/16/2020 TF
Upgrade CefSharp browser to version 57 which should resolve issues related to not being able to install/run the application on some PCs.

3/27/2020 TF
Fix: Not being able to send the <ESC> character from the command console. Users can now use ALT + 27 hotkey to insert the <ESC>
character. It will be displayed as a ← character.

Fix: Spawning of orphaned RX threads which could drastically slow down communications.

Modified the UI for the Equipment, Products, and Alarms pages to reduce unused white space and display more information on a single
page.

Added the ability to display estimated time remaining on the firmware upload dialog box.

*************************************************************
Version to v1.6
*************************************************************
9/1/2020 TF
Fix: Application from locking up when trying to modify a saleable product recipe by clicking the components, additives, or samplers button at
the bottom the saleable product card.

9/9/2020 TF
Fix: Products – when trying to delete a single component / additive / sampler it deletes everything out the list. Steps to reproduce: Click the
trash can on the Components title bar -> deselect “select all” -> select a single component to delete -> hit the delete button

9/18/2020 TF
Fix: The Import Logo tool wasn’t rendering the image on the screen after importing it into the application.

*************************************************************
Version to v1.7
*************************************************************
12/7/2020 CM
Added a "Sites" feature allowing users to create their own site directories to organize their devices by clicking on the "Create New Device or
Site" button. Note: sites cannot be nested within site folders and to access a device, users should double-click devices instead of using a
single-click like previous versions of MultiMate Plus.

50
MULTIMATE PLUS

Added the ability to Copy / Paste / Delete devices and sites from the Workspace by using the toolbar buttons, or using hotkeys CTRL-C
(copy), CTRL-V (paste) and DEL or Backspace (delete).

12/11/2020 CM
Added breadcrumbs to the workspace menu to allow users to quickly navigate back to the Workspace from a site.

1/18/2021 MB
Added support for TMS7 Line Controller connections.

1/27/2021 CM
Added the ability to import and export a device, site or all devices and sites so they can be shared between users.
Added a "Move To" feature in the device context menu (right-click on a device) to allow users to move their device into a site.

2/19/2021 CM
Fix: Custom logic didn't display all lines when a custom logic line used a comment with no function configured.

51