Difference between revisions of "Category:HamsterProKit"

From cogniteam
Jump to: navigation, search
(2. Run installation script)
 
(18 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
[[File:Charger_LLC_Battery_rev2.jpg|800px]]
 
[[File:Charger_LLC_Battery_rev2.jpg|800px]]
 
[[File:ProKitLLC.png|600px]]
 
[[File:ProKitLLC.png|600px]]
 +
== Landing page ==
 +
* [https://up-board.org/up-squared-robomaker-pro-kit/]
  
 
==3rd party things need to know to work with kit==
 
==3rd party things need to know to work with kit==
  
 
* ROS general information: [http://wiki.ros.org/ROS/Introduction WHAT IS ROS]
 
* ROS general information: [http://wiki.ros.org/ROS/Introduction WHAT IS ROS]
 
* ROS master - what is it? [http://wiki.ros.org/Master ROS MASTER]
 
  
 
* ROS2 general information: [https://index.ros.org/doc/ros2/ ROS2]
 
* ROS2 general information: [https://index.ros.org/doc/ros2/ ROS2]
Line 20: Line 20:
 
===1. Connecting all parts within the kit ===
 
===1. Connecting all parts within the kit ===
 
* Use the LLC cable (in the picture) to both monitor and charge the battery
 
* Use the LLC cable (in the picture) to both monitor and charge the battery
   * Port 9 can be used to charge the Lipo Battery
+
   * Port 8 can be used to charge the Lipo Battery
   * Port 8 should connect the the Lipo battery balancer (JST connector)
+
   * Port 9 should connect the the Lipo battery balancer (JST connector)
 
   * Port 7 should connect to the LLC board  
 
   * Port 7 should connect to the LLC board  
 
   * Red T connector (rightmost on the picture)
 
   * Red T connector (rightmost on the picture)
Line 32: Line 32:
 
* Connect the D435i camera to a USB3 Port using the cable
 
* Connect the D435i camera to a USB3 Port using the cable
  
'''Note: Camera D435 must be already updated with latest firmware and have calibrated IMU. Visit official site for more information.'''
+
'''Note: Camera D435i must be already updated with latest firmware and have calibrated IMU. Visit official site for more information.'''
 
 
===2. Download the image and burn the image into your robot ===
 
 
 
Download image:
 
 
 
[https://cloud.cogni.io/index.php/s/wEBt55X5qKoV5WN IMAGE]
 
 
 
Burn your image:
 
 
 
[https://wiki.cogni.io/Category:HamsterProKit/ImageUploading INSTRUCTIONS]
 
 
 
===3. '''Configure your robot''' ===
 
 
 
* ''''' ON ROBOT WIFI / ETHERNET'''''
 
 
 
You need to access your robot via '''HDMI''' and configure wifi/ethernet settings '''ON ROBOT'''.
 
 
 
After configuration you will be able to access your robot through ssh.
 
 
 
Configure your '''wifi''' like described below:
 
 
 
[https://wiki.cogni.io/Category:HamsterProKit/WifiSetup WIFI SETUP]
 
 
 
or use '''Ethernet''' connection:
 
 
 
[https://wiki.cogni.io/Category:HamsterProKit/EthernetSetup ETHERNET SETUP]
 
 
 
'''Note: in both cases you configure [http://wiki.ros.org/Master ROS MASTER]. Links and descriptions above'''
 
 
 
* '''''ON ROBOT ENVIRONMENT DESCRIPTION AND CONFIGURATION'''''
 
 
 
Each robot should be configured with unique ID.
 
 
 
ID - gives your topics unique prefix - agent* (relevant for ROS1).
 
 
 
Set this name in home directory '''hamster.config''' file:
 
 
 
<code> export HAMSTER_ID=agent1</code>
 
 
 
'''There are two ros distro provided:'''
 
 
 
ROS1 - melodic
 
 
 
ROS2 - dashing
 
 
 
All relative source commands are available in .bashrc file,
 
just comment/uncomment required command and execute<code><span style="color:black"></span>source .bashrc</code> from terminal
 
 
 
ros melodic workspace - '''hamster_ws'''
 
 
 
ros dashing workpace - '''hamster2_ws'''
 
 
 
===4. '''Run examples and see output''' ===
 
 
 
* '''''I want to run examples and see some output on robot'''''
 
 
 
- '''''ROS1'''''
 
 
 
1. Connect to your robot with HDMI.
 
 
 
2. Uncomment melodic relative rows in .bashrc file below page
 
 
 
3. Save changes
 
 
 
4. Execute <code>source .bashrc</code> from terminal
 
 
 
5. Follow these [https://wiki.cogni.io/Category:HamsterProKit/RosExample RUN INSTRUCTIONS]
 
 
 
- '''''ROS2'''''
 
 
 
1. Connect to your robot with HDMI.
 
 
 
2. Uncomment dashing relative rows in .bashrc file below page
 
 
 
3. Save changes
 
 
 
4. Execute <code>source .bashrc</code> from terminal
 
 
 
5. Follow these [https://wiki.cogni.io/Category:HamsterProKit/Ros2Example RUN INSTRUCTIONS]
 
  
* '''''(optionally) I want to run examples and see some output on remote machine '''''
+
===2. Run installation script ===
  
- '''''ROS1 on remote machine'''''
+
Internet connection requires
  
1. Install [http://wiki.ros.org/ROS/Installation ROS1]  on remote machine
+
<code>sudo wget https://cloud.cogni.io/index.php/s/9Lde7aBNHfyQM6K/download -O - | sudo bash</code>
  
2. Connect to the robot via ssh (if you robot is already configured with wifi - just connect remote machine to access point and make ssh)
+
Reboot board after installation.
  
3. Run launch commands on robot like described [https://wiki.cogni.io/Category:HamsterProKit/RosExample HERE]
+
===3. Configure ROS IP ===
  
'''Note: In case remote machine visualization you don't need to run rviz on robot'''
+
Configure IP for ROS applications:
  
4. From remote machine make export to robots' master:
+
<code>pico hamster.config</code> in home directory
  
<code>export ROS_MASTER_URI=htts://ROBOT_IP:11311</code>
+
Edit row with your board IP:
  
<code>export ROS_IP=REMOTE_MACHINE_IP</code>
+
<code>export HAMSTER_IP=your_IP</code>
  
'''Note: you should do it for each spawned terminal or add this exports to .bashrc file'''
+
===4. Launch examples ===
  
5. On remote machine run <code>rviz</code> in terminal and make config like [https://wiki.cogni.io/Category:HamsterProKit/RosExample HERE]
+
'''NOTE: examples work properly just with full-connected kit, be sure you did step 1 from this page.'''
  
- '''''ROS2 on remote machine'''''
+
To run examples in ROS run command:
  
1. Install [https://index.ros.org/doc/ros2/Installation/Crystal/Linux-Install-Binary/ ROS2]  on remote machine
+
<code>ros_prokit</code>
  
2. Connect to the robot via ssh (if you robot is already configured with wifi - just connect remote machine to access point and make ssh)
+
[https://wiki.cogni.io/Category:HamsterProKit/RosExample ROS_EXAMPLES]
  
3. Run launch commands on robot like described [https://wiki.cogni.io/Category:HamsterProKit/Ros2Example HERE]
+
To run example in ROS2 run command:
  
'''Note: if you are connected via ssh - rviz, launched on robot, may fall with mistake. Ignore this.'''
+
<code>ros2_prokit</code>
  
4. On remote machine you can see all available topics with <code>ros2 topic list</code> command
+
[https://wiki.cogni.io/Category:HamsterProKit/Ros2Example ROS2_EXAMPLES]

Latest revision as of 14:15, 6 December 2021

AAEON Pro Kit support page

Charger LLC Battery rev2.jpg ProKitLLC.png

Landing page

3rd party things need to know to work with kit

  • ROS2 general information: ROS2
  • RVIZ - instrument for visualization: RVIZ

Kit prerequisite (not included in the kit)

  • Lipo battery with T connector 7.4V 2 cell.
  • Battery charger

1. Connecting all parts within the kit

  • Use the LLC cable (in the picture) to both monitor and charge the battery
 * Port 8 can be used to charge the Lipo Battery
 * Port 9 should connect the the Lipo battery balancer (JST connector)
 * Port 7 should connect to the LLC board 
 * Red T connector (rightmost on the picture)
  • Connect the Up Squared board to the LLC as shown in the picture
 * TX/RX should be connected to GPIO ports
 * Power should be connected through DC connector
  • Connect the MX2 wifi module
  • Connect the two WIFI antennas using the SMT connector to the integrated chip
  • Connect the Movidius chip using the PCI connector
  • Connect the D435i camera to a USB3 Port using the cable

Note: Camera D435i must be already updated with latest firmware and have calibrated IMU. Visit official site for more information.

2. Run installation script

Internet connection requires

sudo wget https://cloud.cogni.io/index.php/s/9Lde7aBNHfyQM6K/download -O - | sudo bash

Reboot board after installation.

3. Configure ROS IP

Configure IP for ROS applications:

pico hamster.config in home directory

Edit row with your board IP:

export HAMSTER_IP=your_IP

4. Launch examples

NOTE: examples work properly just with full-connected kit, be sure you did step 1 from this page.

To run examples in ROS run command:

ros_prokit

ROS_EXAMPLES

To run example in ROS2 run command:

ros2_prokit

ROS2_EXAMPLES

Subcategories

This category has the following 4 subcategories, out of 4 total.

Pages in category "HamsterProKit"

This category contains only the following page.