manual ambrogio client - paradise robotics · 2018-03-01 · 2. bluetooth adapter for the robot,...

WorkShop

Manual

MD-CT-RO-51 R.9 18/12/2014

by

Ambrogio Client

MD-CT-RO-51 R9 AmbrogioClient 1 / 70

1. Summary

1. Summary ....................................................................................................................................... 1

1.1 Robot platforms and models identification ........................................................................... 3

2. Update robot software ................................................................................................................... 4

2.1 Required tools........................................................................................................................ 4

2.1.1 Bluetooth connection ................................................................................................................. 5

2.1.2 Serial connection ....................................................................................................................... 6

2.1.3 Download and install AmbrogioClient ...................................................................................... 8

2.1.4 Download and install WT-11 bluetooth adapter driver ........................................................... 10

2.2 Preliminary information ...................................................................................................... 13

2.2.1 Ambrogio Client language selection ....................................................................................... 15

2.3 Wizard programming .......................................................................................................... 16

2.3.1 Connection parameters selection ............................................................................................. 16

2.3.1.1 Serial connection configuration ............................................................................................... 16

2.3.1.2 Bluetooth connection configuration ........................................................................................ 17

2.3.2 Robot Programming ................................................................................................................ 20

2.4 Archive import / export procedure ...................................................................................... 25

2.5 ARC Console programming ................................................................................................ 27

3. Robot report – Robot setup data and statistics ............................................................................ 30

3.1 Data on Robot Report .......................................................................................................... 31

4. Test battery ................................................................................................................................. 34

4.1 Purpose of the test ............................................................................................................... 34

4.2 Required tools...................................................................................................................... 34

4.3 Test procedure ..................................................................................................................... 36

4.4 Reading test results .............................................................................................................. 40

5. L50 robot model test ................................................................................................................... 41

5.1.1 Test set-up ............................................................................................................................... 41

5.1.2 Test procedure ......................................................................................................................... 42

6. Advanced Services ...................................................................................................................... 50

6.1 Enable Advanced Services .................................................................................................. 51

6.1.1 Enable Advanced Mode ........................................................................................................... 51

6.1.2 Activations ............................................................................................................................... 52

6.1.3 Enable Service Utilities ........................................................................................................... 55

6.2 Password reset ..................................................................................................................... 56

6.3 Test motor............................................................................................................................ 57

6.3.1 Purpose of the test.................................................................................................................... 57

6.3.2 Required tools .......................................................................................................................... 57

6.3.2.1 Brush motor test....................................................................................................................... 57

6.3.2.1.1 Brush blade motor connection for the test ........................................................................... 58

6.3.2.2 Brushless motor test................................................................................................................. 60

6.3.3 Test procedure ......................................................................................................................... 61

6.3.4 Reading test results .................................................................................................................. 63

6.4 Special versions (Beta) programming ................................................................................. 64


6.5 Package programming ......................................................................................................... 65

7. Cassiopea - download area ......................................................................................................... 66


1.1 Robot platforms and models identification

This document includes references to robot platforms / models that identify the applicability of the

content.

To avoid having to list every time all the references of the various brands (Ambrogio, Wiper, Tech) and/or

specific models (L200 Basic, Runner-L, AC127, etc...), we decided to refer to the nomenclature BASIC LINE.

Please refer to the "MD-CT-RO-50 Installation" or "MD-CT-RO-52 Robot set-up" or "MD-CT-RO-53

Troubleshooting" document for a cross reference between BASIC LINE and specific robot models,

depending on robot brand.

Robot belonging to different brands may differ in features and equipment that do not jeopardize what is

reported in this document.

The present document is applicable for all robot models and platforms, regardless of robot manufacturing

year.


2. Update robot software

The present document applies to all the robots (L30, L50, L75, L85, L200, L200R, L300, L400) and ARC

Console.

2.1 Required tools

In order to perform robot software update, the following hardware and software tools are required:

1. PC (Personal Computer) provided with:

a. Windows operating system. All the Windows operating system versions are supported,

excluding versions older than XP - SP3 (Service Pack 3)

b. RS-232 Serial port or USB port

Picture 1 - RS-232 Serial port (9 male pins)

Picture 2 - USB port

2. AmbrogioClient. This is the program that runs on the PC and is used to connect to the robot or ARC

Console. Instruction to install AmbrogioClient on the PC are provided in paragraph 2.1.3

Picture 3 - AmbrogioClient icon on PC desktop

3. In order to establish data connection with the robot, there are the two following main options, with

related required tools. See paragraphs 2.1.1 and 2.1.2


2.1.1 Bluetooth connection

In this case, the data connection is established wireless, so there is no need to open the robot to establish

any physical connection.

The following tools are required:

1. WT-11 bluetooth adapter for PC, manufactured by ZUCCHETTI CENTRO SISTEMI, part number

CS_BT_USB.

a. It must be connected to the USB port of the PC

b. The proper driver must be installed on the PC. See procedure provided in paragraph 2.1.4.

Picture 4 - WT-11 bluetooth adapter

Picture 5 - WT-11 bluetooth adapter connected on

PC USB port

2. Bluetooth adapter for the robot, connected to the serial port on motherboard. Some robot models

are provided with bluetooth adapter as series equipment (refer to the proper datasheet, see

reference in paragraph Errore. L'origine riferimento non è stata trovata.).

Picture 6 - Robot bluetooth adapter

Picture 7 - Bluetooth adapter installed on

robot motherboard


2.1.2 Serial connection

In this case, a physical connection must be established between the PC and the serial port located on robot

motherboard.

Each time it is necessary to establish connection with the robot, the robot must be opened to get access to

the serial port.

In order to establish connection, a standard RS-232 cable is necessary.

It is either available as AMBCAPROG, provided by Zucchetti Centro Sistemi, or as a standard commercial off

the shelf product.

AMBCAPROG

Provided by Zucchetti Centro Sistemi

Standard commercial off the shelf

RS-232 male - female pin-to-pin cable

Picture 8 - AMBCAPROG provided by Zucchetti

Centro Sistemi

Picture 9 - Example of commercial off the shelf RS-

232 cable

In case the PC is not provided with RS-232 serial port, it is necessary to use a standard USB - serial converter

(commercial off the shelf, NOT provided by Zucchetti Centro Sistemi).

Generally, such kind of converters come with a CD (Compact Disc) with driver to be installed on PC before

use. Follow proper instructions provided by converter manufacturer.


Picture 10 - Example of commercial off the shelf USB - serial converter

Picture 11 - Robot software update set-up - serial connection: PC + connection cable + USB-serial

converter + robot

Picture 12 - Robot software update set-up - USB-serial converter to connection cable


2.1.3 Download and install AmbrogioClient

In order to install the AmbrogioClient software on the PC, execute the following steps:

1. Download the installer from Cassiopea download area, according to the instruction provided in

paragraph 7

2. Run the AmbrogioClient installer file from the folder in your PC where the file has been

downloaded from Cassiopea according to point 1

Picture 13 - AmbrogioClient installer icon

3. Select the desired language for the installation procedure and select OK

Picture 14 - AmbrogioClient set-up: language selection

4. Select Install

Picture 15 - AmbrogioClient set-up


5. Wait for end of installation and select Next

Picture 16 - AmbrogioClient set-up: installation complete

6. Finally select Finish

Picture 17 - AmbrogioClient set-up: exit installation process


2.1.4 Download and install WT-11 bluetooth adapter driver

First time the WT-11 adapter is connected to the USB port of the PC, the drivers have to be installed.

Normally, drivers are automatically found by the Windows operating system, so their installation is

automatically performed.

At the end of correct drivers installation, the WT-11 adapter is mapped as a serial port on the PC. The new

device is showed on Windows Control Panel - Device Manager, as USB SERIAL PORT. A port number (COM#)

is associated to the device (for example, COM23 in Picture 18).

Picture 18 - Windows Control Panel: device manager


In case you have multiple devices identified as USB SERIAL PORT, you can be sure about proper selection by

inspecting the Properties of each device. The WT-11 adapter is the one with FTDI as manufacturer.

Picture 19 - WT-11 device properties

In case the driver is not automatically found and a corresponding error message is showed by Windows

operating system (in such condition, the device USB Serial Port is showed on Windows Control Panel -

Device Manger with a yellow question mark), it is necessary to manually install the driver.

The driver is provided by Zucchetti Centro Sistemi and can be downloaded from Download Area of

Cassiopea (name "WT-11 adapter driver"). See instructions provided in paragraph 7 to download the file.

Once the file has been downloaded, run the application CDM20824_Setup.

Picture 20 - WT-11 driver installer icon


Installation is performed automatically and a message is showed at the end of the process.

Picture 21 - WT-11 driver installation complete

At the end of installation, verify that the WT-11 device is correctly showed on Windows Control Panel -

Device Manager, Picture 18 and Picture 19, without yellow question mark.

Once the WT-11 has been connected and the driver correctly installed the first time, the WT-11 device will

always remain mapped with the same COM# port on the PC, also if it is connected to different USB ports.

The same WT-11 adapter can be used on different PCs. In such case, the same WT-11 adapter can have

different COM# ports on different PCs.


2.2 Preliminary information

1. Each time the AmbrogioClient is launched, it automatically searches for updates on the online

database. It is necessary that the computer on which the Ambrogio client is running is connected

to the internet, otherwise an error message is showed.

Picture 22 - AmbrogioClient: update error

a. The error message is showed if the PC is really disconnected from the internet or in case a

firewall is blocking the application while trying to establish the connection

b. Update research is performed once a day. Once the research has been completed, the PC

can be disconnected from internet.

Picture 23 - AmbrogioClient: update complete


2. When the robot is turned ON, the display shows the hardware and software configuration

(excluding L50, that does not have display)

Robot L2EL 09

V. 2010//03/08

Robot L2EL-> Robot model identifier (L200 Evolution)

V. 2010/03/08 -> installed software release date (after, software release number is showed)

3. During robot start-up, the software installed on the motherboard performs some checks and verify

that all the softwares installed in the different devices (for example the motherboard, the display,

etc…) are correct. In case incongruities are found, the display shows a message like the following:

DISPLAY R 5810

Required R 5814

The message above means that the release 5810 installed on the display is not the last available for

the specific robot and there could be some malfunctions. It is therefore necessary to update the

display software version

Please note that this message could arise in case a spare part is installed in a robot. Therefore,

software update could be necessary after replacement of parts.

4. The robot, once turned ON, automatically enters PAUSE status.

Once entered PAUSE, it automatically turns OFF (L50: enters Stand-by) within 30 seconds if the

programming procedure does not start.

In order to avoid automatic shut down, follow the instructions below:

a. For L50 robot model, push START / STOP key (the robot will start moving) and push it again

after at least 10 seconds.

b. For other robot models, use one of the two following suggested methods:

i. Push PAUSE key. The robot will exit PAUSE status and will start to search the signal

(both in case it is present or not. Attention, if the signal is present, the robot will

start the blade and then will start moving). Push PAUSE key again after about 10

seconds.

ii. Enter user menu down for at least two levels (for example on first working time

submenu).


2.2.1 Ambrogio Client language selection

It is possible to set the AmbrogioClient language:

1. Run AmbrogioClient

2. Select File – Setup

3. Select Language

Picture 24 - AmbrogioClient: language selection

4. On the new screen, there is the opportunity to select the language for:

a. upper section - Client language: the language of the AmbrogioClient windows

b. lower section - Wizard language: the language for the on-line help

Picture 25 - AmbrogioClient: online help example

5. Select OK

6. Close and run AmbrogioClient again


2.3 Wizard programming

Prior to proceed with robot programming, it is necessary to configure the AmbrogioClient software, setting:

· connection method with device to the programmed: serial or bluetooth

· connection parameters: serial port number or bluetooth device to be programmed.

The following paragraphs explain how to perform such configurations.

2.3.1 Connection parameters selection

2.3.1.1 Serial connection configuration

1. Run AmbrogioClient

2. Select File - Setup

3. Select “Cable” and then the number of the serial port to be used for connection with the robot

Note: In order to identify the number of the port used for communication with the robot (COM#), use

Device manager from Windows control panel.

Picture 26 - Windows Control Panel: identify port number COM# for communication with the robot

Picture 27 - AmbrogioClient: COM# port selection for communication with the robot

4. Select OK to confirm the configuration.


2.3.1.2 Bluetooth connection configuration

Be sure that the configurations described in paragraph 2.1.4 have been executed before starting with the

next steps.

1. Connect the WT-11 adapter to the USB port

2. Select File - Setup

3. Select “WT11 Bluetooth”.

4. Specify the WT-11 adapter COM port (see paragraph 2.1.4 for identification of the WT-11 adapter

COM port number). It is set to COM23 in the example in Picture 28)

Picture 28 - AmbrogioClient: WT-11 COM port number selection


5. Perform device selection (device to which establish bluetooth connection):

a. Devices already paired are showed with name and address (Robot L200R in figure below).

In case the device to be programmed is already paired, select it, push OK and proceed with

programming procedure as provided in paragraph 2.3.2. In order to verify that the

AmbrogioClient is correctly configured to communicate with the selected device, check on

AmbrogioClient main window, where a message "Selected connection" shall provide the

desired device (see picture below)

Picture 29 - AmbrogioClient: device selection with bluetooth connection

Picture 30 - AmbrogioClient: selected connection device

b. If the device to be programmed has not been yet paired (does not appear in the list in

Picture 29), select Add/Modify and proceed with following step 6.

6. Turn ON the device to be programmed. If it is a robot, pay attention to automatic shut down within

30s as explained in paragraph 2.2


7. On new window select Search. The devices that have been found are showed on the lower part of

the window with name “Robot” (for a robot) or “Console” (for the ARC Console).

Picture 31 - AmbrogioClient: search bluetooth devices

8. Once the research has been completed, move the device on the upper “Paired” section by double

clicking on the name of the device on section “New”. In order to complete pairing, a security code

is asked: insert “0000” or the password set on robot, if active.

9. Once the device has been moved to section “Paired”, the device can be renamed by double clicking

on the name and inserting the new one. Paired devices are devices that do not need new research

for future programming. It is absolutely suggested to rename a device after it has been paired, so

each device / bluetooth receiver has a unique name that cannot be confused with other devices.

IMPORTANT: Not for ARC Console. The paired device is not the robot, but the bluetooth adapter

installed on the robot. So, pay attention if, for some reasons, a bluetooth adapter is moved

among different robots.

10. Select OK to complete pairing

11. The new device is showed on the “Setting” window (showed in the following). Select the device,

then OK and finally proceed with programming procedure as described in paragraph 2.3.2

Picture 32 - AmbrogioClient: device selection with bluetooth connection


2.3.2 Robot Programming

1. Turn ON the device to be programmed. If it is a robot, pay attention to automatic shut-down within

30s as explained in paragraph 2.2

2. From AmbrogioClient select File – Wizard programming

3. Leave flag on autodetection selection

4. Select Next

Picture 33 - AmbrogioClient: robot programming with autodetection

5. Select Detect. Ambrogio Client will start communication with the robot to identify robot model.

Picture 34 - AmbrogioClient: start device detection


6. At the end of correct detection, the status of the software installed in the devices in the robot (for

example motherboard, receiver, alarm board, if installed) is showed. Select Next.

Picture 35 - AmbrogioClient: example of autodetection result

Note: "Not found" message is showed in case a device is not installed / found during the autodetection

procedure. In case a device is installed in the robot, but not detected, investigate the causes of the

malfunction. In case the device is not really installed in the robot (like GSM board in Picture 35) the "Not

found" message is an acceptable condition.


7. At this moment, the software versions available for installation in such robot are showed together

with their identification. Select the version to be installed and select Next.

Note: It could be possible that more than one OFFICIAL versions are available for installation. In such case,

the user has to select the version to be installed, based on his own experience and descriptions provided by

the manufacturer in the "MD-CT-RO-70 Release Note" document.

In the example in figure below, OFFICAL and OFFICIAL 1 versions are available.

In case there are specific important information about a software version, a pop up message is showed as

soon as the "Next" button is selected.

Picture 36 - AmbrogioClient: selection of the software version to be programmed

Picture 37 - AmbrogioClient: on-line help example


8. Select full update and select Next

IMPORTANT: It is suggested to always perform full update

Picture 38 - AmbrogioClient: full update selection

9. Select Program

Picture 39 - AmbrogioClient: device programming

manual ambrogio client - paradise robotics · 2018-03-01 · 2. bluetooth adapter for the robot,...

Documents