Mobitouch LITE USB configuration tool

From Mobitouch cube

1 Download
2 System requirements
3 Installation procedure
4 Mobitouch USB configuration tool

Download

Version: 7.0.1

* Mobitouch USB Configuration Tool

System requirements

Minimum system requirements necessary for the installation of Mobitouch CMS:

CPU Pentium III – 500 MHz or above (32 bit architecture)
128 MB RAM
60 MB HD Free
OS: Microsoft Windows (2000, XP, Vista)

The following software components are required (included in the installation CD):

Microsoft .Net Framework 2.0 or above

Installation procedure

Unpack the .zip file
Double-click on the file Setup.exe
Follow step-by-step the instructions on screen.

When the installation is finished, Mobitouch USB Configuration Tool should has been correctly installed. Launch the USB configuration tool by double clicking on the Mobitouch-USBTool icon in the start menu (or on the Desktop).

Mobitouch USB configuration tool

USB Node settings

The upper area of the USB Node Management section contains the node settings that will be applied to a WLP using the USB dongle.

Modify USB Node settings

it is possible to modify the USB Node settings clicking on the “Modify node” button.

Within the form showed above is it possible to adjust the following node settings:

Bluetooth name, the name that will be prompt on users mobile phones when contacted
Accepted/Rejected/Failed Blacklist, the time the node will wait before trying to contact once more a mobile phone stored into one of the three black lists.
Bluetouch Enable/Range, enabling the Bluetouch function will lead the WLP to bypass the blacklists when detecting mobile phones very close to it (“TOUCH”)
Distance Range, the coverage area of the node, approximately: “short” is between 5 and 10 meters, “medium” between 10 and 15 meters, “long” between 15 to 25 and “very long” between 25 and 35
Monitor Devices, to setup a monitor device follow the steps below:
- Click on “Modify Node” button in the USB Nodes Management area.
- Add, in the Monitor device manager area, the Bluetooth address of the mobile device that you want to use as monitor device.
- Click on “Add New Device” button to apply insertion.
- To remove a device, insert its Bluetooth address and click on “Delete Device” button.

Content Manager

The lower area of the USB Node Management section lists the contents to be uploaded on the WLP using the USB dongle.

Upload new contents

To upload a new file follow the steps below: Click on “Choose a File...” button Select the files to upload Click on “Upload File” button All the files uploaded are shown in the list (please note that you won't be able to upload files whom size exceed 15MB). “Delete File” and “Delete All Files” buttons allow to delete the previously uploaded.

USB Campaigns Management

The Campaign Management section provides an overview of the defined campaigns to be loaded onto WLPs using a USB dongle. It allows to create new campaigns, to remove and to manage existing campaigns.

The USB Campaigns Management section is divided in two parts: through the upper panel it is possible to manage existing campaigns, while the lower panel contains the boxes used to add new campaigns. To operate on an existing campaign, first of all, select a campaign from those shown in the list. Then use the following buttons:

“Delete campaign”: deletes permanently the selected campaign
“Modify campaign”: allows to edit all the information about the selected campaign
“Campaign details”: displays details about the selected campaign
“Copy campaign”: allows to copy all the information about the selected campaign into a new campaign with the same content (useful to easily duplicate campaigns)

Create campaigns

The USB Campaigns Management section provides two ways to add new campaigns:

Quick campaign creation
Advanced campaign creation

Quick campaign creation

It is the faster way to add a new campaign to a node. Using the Quick Campaign Creation box in the panel it is possible to define campaigns specifying only general settings. This campaigns are defined by name, starting date/time, ending date/time and the content to dispatch. Just click on “Quick Create” and the new campaign is added to defined campaigns list.

Advanced campaign creation

It is used to have a deeper control on campaign parameters and therefore to create campaigns with more complex scheduling settings and contents policies. Clicking on “Advanced Campaigns” button produce the form below to be shown. Advanced Campaign Management allows to define two different campaign types, depending on scheduling policy. To select one of the two configuration mode use the radio button on the current form:

Simple scheduling: allows to define start date/time and end date/time (the same parameters specified in Quick Campaign Creation mode).
Periodic scheduling: allows to define a campaigns that can be execute periodically. To define scheduling time is necessary to click on “Settings” button on the right of periodic scheduling radio button.

Periodic scheduling campaigns

A periodic campaign is a campaign that can be executed in a peculiar time of the year. Using this scheduling setting it's possible to configure a monthly, daily or hourly scheduling for a proximity marketing campaign. It is moreover possible to set specific months, days, etc. of campaign execution.

Two periodic scheduling configuration methods are supported:

Custom mode
Advanced mode

It is possible to choose the preferred method by clicking on the proper radio button.

Custom periodic campaign scheduling

Custom scheduling in a user friendly way leads unexperienced users: by simply selecting specifics desired Months, Days, Hours and Minutes in the appropriate tab, the WLP configuration string will be automatically created. The first parameter to set is the campaign duration time, writing or selecting Hours and Minutes in the proper fields, shown in the Summary form. The campaign duration time represents the activity duration of the campaign, each time it starts. Successively, to complete the configuration, it needs to choose, for each tab (Months, Days, Hours and Minutes), the preferred periodicity (when the campaign should start). In each tab it's possible to choose directly every element of the list by simply clicking on the proper radio button (ex. “Every Month”). Alternatively it's possible to choose only the preferred ones by selecting or deselecting the items in the lists. In the Days tab is also required to select (at least one) “Day(s) of week” of the periodic campaign scheduling. Now you can click “Apply” button to confirm the configuration.

Advanced periodic campaign scheduling

Selecting the Advanced radio button in Setting mode (), the “Advanced Setting” box will be enabled. It is now possible to manually write the configuration string, which has a syntax similar to Crontab utility on Unix-like operating systems. Help button provides a quick reference to this syntax:

Configuration string is made of 6 fields separated by one space.
The first 5 fields represent a time of the year, respectively: minutes (0-59), hours (0-23), days of month (1-31), months (1-12), days of week (1-7). The sixth field represents, in minutes, the campaign execution lifetime, each time it starts.
Concerning the days of the week, value ‘1’ refers to Sunday, ‘2’ refers to Monday and so on, up to '7' Saturday.
Day of month (field 3) and day of week (field 5) are associated with the AND logic: the campaign is executed only if the system recognize a matching between the two fields. For example, choosing 1, 7, 27 as days of month and 1,5 (Monday, Friday) as days of week, the campaign will be executed only if occurs one of this couples of values Monday-1, Monday-7, Monday-27 or Friday-1, Friday-7, Friday-27.
All fields are mandatory.
Single or multiple values are supported:
- Comma ',' operator specifies a list of single values (e.g. 1,3,7,8);
- Dash '-' operator specifies a range of values (e.g. 1-6 which is equivalent to 1,2,3,4,5,6);
- Asterisk '*' operator specifies all possible values for a field (e.g. an asterisk in the hour time field would be equivalent to 'every hour');
- Comma separated values and dashed lists can be used at the same time.
- Clicking on “Set” button makes string setting effective. Tab Overview provides an overview of the current periodic time string setting.

Note: different campaigns cannot overlap. Be careful on campaigns definition, specially when both simple and periodic campaigns are defined. As for simple campaign, if start/end date overlaps with start/end date of a campaign already set, a warning message will be shown and the overlapped campaign will not be added. As for periodic campaign or both simple-periodic campaigns overlapping, be aware that only the first campaign will be taken into account in the overlapping period.

Contents dispatching policies

Advanced Campaign Management allows to specify different types of contents. Using “Delete content” and “Content details” buttons it is possible to manage contents defined for the campaign. By clicking “Add new content” button a new window appears. The new form displayed allows to choose between the different policies.

To create a “Simple content” select Simple policy from the cascade window and select a file from the list. Then click on “Add content” confirm button;
To create a “Class content” select Class policy from the cascade window and choose for each class the content you want to send.
To create a “Bonus content” is as easy as create a “Simple content”: select Bonus policy from the cascade windows and specify bonus file, then select, by the Period numeric combo box, the number of successfully sent messages to wait before sending the bonus content.

Export configuration

When you want to export the configuration created into the USB configuration tool all you have to do is plug in a USB dongle and click on “Export configuration”. Locate the folder where your Operative System mounted the USB dongle and click on ok. A WLP configuration package will be stored into the USB dongle. Please note that if the USB dongle contains one of the following items:

A folder called “contents”
A file named “parameters.conf”
A file named “campaigns.xml”
A file with “.psu” extension

No USB configuration will be exported in the USB pen drive.

USB dongle usage

Once the configuration has been exported into the USB pen drive, remove it from your PC and follow the steps below:

Unplug everything from the WLP unit (i.e. USB dongles, Ethernet cable, USB HUB, power supply)
Plug the USB pen drive into one of the two USB ports
Plug the power supply
Wait 2 minutes (you're not supposed to wait exactly 2 minutes but try to wait a period of time around 2 minutes)
unplug the USB dongle

In the USB dongle you should find a folder named with the WLP serial number and the date of the USB configuration execution. Inside that folder you can find the raw statistics file of the campaigns the WLP was executing before the USB configuration to take place, you can use them to elaborate reports related to the previous campaigns.

Note: when you apply a USB configuration the WLP configuration is completed overwritten by the USB configuration.

Retrieved from "http://help.mobitouchcube.com/Mobitouch_LITE_USB_configuration_tool"

Navigation