AmbrogioClientManual p1-p24
AmbrogioClientManual p1-p24
Ambrogio Client
Manual
by
MD-CT-RO-51 R9 AmbrogioClient 2 / 70
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.
MD-CT-RO-51 R9 AmbrogioClient 3 / 70
2. Update robot software
The present document applies to all the robots (L30, L50, L75, L85, L200, L200R, L300, L400) and ARC
Console.
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
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
MD-CT-RO-51 R9 AmbrogioClient 4 / 70
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.
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.
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.).
MD-CT-RO-51 R9 AmbrogioClient 5 / 70
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 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.
MD-CT-RO-51 R9 AmbrogioClient 6 / 70
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
MD-CT-RO-51 R9 AmbrogioClient 7 / 70
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
3. Select the desired language for the installation procedure and select OK
4. Select Install
MD-CT-RO-51 R9 AmbrogioClient 8 / 70
5. Wait for end of installation and select Next
MD-CT-RO-51 R9 AmbrogioClient 9 / 70
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).
MD-CT-RO-51 R9 AmbrogioClient 10 / 70
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.
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.
MD-CT-RO-51 R9 AmbrogioClient 11 / 70
Installation is performed automatically and a message is showed at the end of the process.
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.
MD-CT-RO-51 R9 AmbrogioClient 12 / 70
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.
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.
Robot L2EL 09
V. 2010//03/08
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.
MD-CT-RO-51 R9 AmbrogioClient 14 / 70
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
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
5. Select OK
6. Close and run AmbrogioClient again
MD-CT-RO-51 R9 AmbrogioClient 15 / 70
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.
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
MD-CT-RO-51 R9 AmbrogioClient 16 / 70
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.
MD-CT-RO-51 R9 AmbrogioClient 17 / 70
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)
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
MD-CT-RO-51 R9 AmbrogioClient 18 / 70
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).
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.
MD-CT-RO-51 R9 AmbrogioClient 19 / 70
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
5. Select Detect. Ambrogio Client will start communication with the robot to identify robot model.
MD-CT-RO-51 R9 AmbrogioClient 20 / 70
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.
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.
MD-CT-RO-51 R9 AmbrogioClient 21 / 70
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.
MD-CT-RO-51 R9 AmbrogioClient 22 / 70
8. Select full update and select Next
9. Select Program
MD-CT-RO-51 R9 AmbrogioClient 23 / 70