Getting started

From Rsewiki
(Difference between revisions)
Jump to: navigation, search
(WiFi)
(Battery maintenance)
 
(42 intermediate revisions by one user not shown)
Line 1: Line 1:
 
Back to [[Regbot]] main page.
 
Back to [[Regbot]] main page.
  
==GUI==
+
==The robot==
  
The GUI is a python-QT application used to configure the REGBOT. Runs under Windows (regbot.exe) or Linux (regbot.py, but requires the right python packages to be installed first)
+
[[File:regbot_med_kabler_og_pc_ann.png | 600px]]
 +
 
 +
The robot can connect to a PC using USB (or Wifi), but start with USB.
 +
 
 +
=== Battery maintenance ===
 +
 
 +
The battery is nominal 11.1V (3 LiPo cells) and the robot shuts down if below 10V. Some robots have a small display on the PCB with the battery voltage.
 +
 
 +
'''NB!''' The charger cable to the battery (4-wire balance plug) is disconnected on some robots.
 +
See [[Regbot maintenance]] for more details.
 +
 
 +
'''NB2!''' Connecting the charger, or connecting the USB cable while charging, sometimes disturbs the processor on REGBOT. Especially if the PC also is connected to 230V.
 +
 
 +
==Start the GUI==
 +
 
 +
For installation see [[Regbot GUI]].
 +
 
 +
Go to the directory with the GUI Python files.
 +
 
 +
Start the regbot.py file.
  
 
==Connect==
 
==Connect==
Line 11: Line 30:
 
[[File:screenshot-regbot.png | 800px]]
 
[[File:screenshot-regbot.png | 800px]]
  
Figure 1. REGBOT GUI, then top-left frame controls the connection. Etiher communication over an USB com-port or using WiFi.
+
Figure 1. REGBOT GUI, then the top-left frame controls the USB connection.
  
 
===USB===
 
===USB===
  
Connect USB cable and figure out which COM port is created for the robot (NB! each robot connected to the PC has probably reserved a COM-port number). The control panel may help.
+
Connect the USB cable and figure out which COM port is created for the robot (NB! In Windows, each robot ever connected to the PC has probably a reserved COM port number).
  
In figure 1 the robot has created COM6:.
+
=====Windows=====
  
===WiFi===
+
To find com-port number, see the Windows configuration (control panel) under 'Bluetooth and other devices'
  
At DTU the robots attempt to connect to the DEVICE WiFi access point (SSID=device), it may take 20 seconds to establish the connection.
+
In Figure 1, the robot is connected using COM6:.
  
Each robot has a reserved IP:
+
===== Linux and MAC =====
  
10.16.166.XXX
+
The USB port will most likely be called
  
Where XXX is the robot number. The robot Thea has number 51, so its IP number is 10.16.166.51.
+
/dev/ttyACM0
  
A number of remarks and debug messages (shown in the lower left frame in figure 1) will not be send over WiFi (lower bandwidth).
+
Enter this (/dev/ttyACM0) instead of the 'com6' in the USB frame.
 +
 
 +
(Not too sure about MAC, sorry)
  
 
===Status===
 
===Status===
  
Once connected the robot time and name is shown in green (figure 1). Below the green frame is a frame to start and stop missions.
+
Once connected to a robot time and name are shown (figure 1). Time should increase, to show that the connection is active.
 +
 
 
The start button is a replication of the green button on the robot.
 
The start button is a replication of the green button on the robot.
  
The "Load" field shows how much time the robot uses for every sample (it samples all sensors and calculations every ms), so the load should be less than 1000 at all times.
+
The "Load" field shows how much time the robot uses for every sample in microseconds (in %).
 +
The load increases while running, but should be less than 100% at all times.
  
When the configuration or mission is changed it can be saved to a small flash disk (2kB) on the robot with the "save to flash" button.
+
When the configuration or mission changes, it can be saved to a small flash disk (4kB) on the robot with the "save to flash" button.
  
 
===Menu===
 
===Menu===
  
The menus has some extra features.
+
The menus have some extra features.
  
===Help===
+
'File' -> 'Save' saves some of the settings in the GUI and from the robot (including the com-port).
  
Most fields has explanations, when the mouse hoovers over the field.
+
'View' can hide or show tab pages.
  
===Control configuration===
+
'Help' -> 'About' shows the version of the software.
  
This is a control exercise robot, so some control must be configured to run missions.
+
===Help===
  
Control is configured from the control tab - see also [[User_interface#Controller_configuration]].
+
Most fields have explanations when the mouse hovers over the field.
  
The velocity control is the most important, and in the dialog shown below in figure 2, set the values in the figure text.
+
===User interface===
  
[[File:Gui_control_dialog.png | 500px]]
+
More details on user interface on [[User_interface]]
  
Figure 2. A Kp = 0, but enabled is fine if "Feed forward" Kf = 4. Set output limit to 9V and disable the "Lead/lag in feedback" and all other settings. This will translate a mission velocity of 0.5 m/s by a factor 4 to a motor voltage of 2 Volt, which in turn approximately gives a velocity of 0.5 m/s.
+
More details on missions on [[Mission]]

Latest revision as of 20:19, 7 December 2023

Back to Regbot main page.

Contents

[edit] The robot

Regbot med kabler og pc ann.png

The robot can connect to a PC using USB (or Wifi), but start with USB.

[edit] Battery maintenance

The battery is nominal 11.1V (3 LiPo cells) and the robot shuts down if below 10V. Some robots have a small display on the PCB with the battery voltage.

NB! The charger cable to the battery (4-wire balance plug) is disconnected on some robots. See Regbot maintenance for more details.

NB2! Connecting the charger, or connecting the USB cable while charging, sometimes disturbs the processor on REGBOT. Especially if the PC also is connected to 230V.

[edit] Start the GUI

For installation see Regbot GUI.

Go to the directory with the GUI Python files.

Start the regbot.py file.

[edit] Connect

The GUI looks like shown here in figure 1.

Screenshot-regbot.png

Figure 1. REGBOT GUI, then the top-left frame controls the USB connection.

[edit] USB

Connect the USB cable and figure out which COM port is created for the robot (NB! In Windows, each robot ever connected to the PC has probably a reserved COM port number).

[edit] Windows

To find com-port number, see the Windows configuration (control panel) under 'Bluetooth and other devices'

In Figure 1, the robot is connected using COM6:.

[edit] Linux and MAC

The USB port will most likely be called

/dev/ttyACM0

Enter this (/dev/ttyACM0) instead of the 'com6' in the USB frame.

(Not too sure about MAC, sorry)

[edit] Status

Once connected to a robot time and name are shown (figure 1). Time should increase, to show that the connection is active.

The start button is a replication of the green button on the robot.

The "Load" field shows how much time the robot uses for every sample in microseconds (in %). The load increases while running, but should be less than 100% at all times.

When the configuration or mission changes, it can be saved to a small flash disk (4kB) on the robot with the "save to flash" button.

[edit] Menu

The menus have some extra features.

'File' -> 'Save' saves some of the settings in the GUI and from the robot (including the com-port).

'View' can hide or show tab pages.

'Help' -> 'About' shows the version of the software.

[edit] Help

Most fields have explanations when the mouse hovers over the field.

[edit] User interface

More details on user interface on User_interface

More details on missions on Mission

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox