Improve package docs

This commit is contained in:
2023-01-11 11:12:00 +02:00
parent e92a39c74e
commit 04317c5608
6 changed files with 127 additions and 16 deletions

109
README.md
View File

@@ -1,19 +1,40 @@
# drawing-robot-ros2 # drawing-robot-ros2
## Building
``` sh ``` sh
source install/local_setup.bash ./rebuild.sh
cd src/ign_moveit2_examples/src/draw_svg/ ```
rosdep install --from-paths . --ignore-src -r -y ``` sh
colcon build source src//install/local_setup.bash
source install/local_setup.bash
ros2 launch draw_svg draw_svg.launch.py
``` ```
## xArm lite6 ## Running
- web interface: http://192.168.1.150:18333 Run
``` sh
ros2 run robot_controller dummy_controller
```
or
``` sh
ros2 launch axidraw_controller axidraw_controller
```
or
``` sh
ros2 launch lite6_controller lite6_gazebo.launch.py
```
or
``` sh
ros2 launch lite6_controller lite6_real.launch.py
```
or
``` sh
ros2 launch lite6_controller lite6_real_no_gui.launch.py
```
free drive mode: https://github.com/xArm-Developer/xarm_ros#6-mode-change And simultaneously run
``` sh
ros2 run drawing_controller drawing_controller src/draw_svg/svg/test.svg
```
## ROS2 rpi4 ## ROS2 rpi4
https://github.com/ros-realtime/ros-realtime-rpi4-image/releases https://github.com/ros-realtime/ros-realtime-rpi4-image/releases
@@ -33,10 +54,80 @@ apt update && apt upgrade
apt install ros-dev-tools apt install ros-dev-tools
``` ```
``` sh
adduser ubuntu dialout #give access to serial devices (axidraw)
```
### Misc commands
``` sh
apt update
apt install tmux python3-colcon-ros python3-pip ros-humble-moveit
```
``` sh
apt install colcon
apt search colcon
apt install ros-dev-tools
vi /etc/issue
systemctl stop wpa_supplicant
wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf
wpa_cli
ip link set wlan0 up
wpa_cli
dhclient wlan0
ping google.com
apt install ros-galactic-moveit
apt install xauth
vim /etc/ssh/sshd_config
systemctl restart sshd
colcon build --packages-select robot_interfaces robot_controller
```
sets priority for wlan0; uses it as gateway if connected.
/etc/netplan/50-cloud-init.yaml
``` sh
network:
wifis:
wlan0:
dhcp4: true
dhcp4-overrides:
route-metric: 100
optional: true
access-points:
"SSID":
password: "PSK"
ethernets:
eth0:
dhcp4: true
dhcp4-overrides:
route-metric: 200
optional: true
version: 2
```
/etc/ssh/sshd:
```
X11Forwarding yes
X11UseLocalhost no
```
### Access xarm webUI from different network ### Access xarm webUI from different network
If connected to the pi on 192.168.22.199, one can forward the webUI to localhost:8080 with the following: If connected to the pi on 192.168.22.199, one can forward the webUI to localhost:8080 with the following:
``` sh ``` sh
ssh -L 8080:192.168.1.150:18333 ubuntu@192.168.22.199 ssh -L 8080:192.168.1.150:18333 ubuntu@192.168.22.199
``` ```
## Moveit2 docs
``` sh
git clone https://github.com/ros-planning/moveit2.git
cd moveit2
git checkout humble
sudo apt-get install doxygen graphviz
DOXYGEN_OUTPUT_DIRECTORY=docs doxygen
firefox docs/index.html
```

View File

@@ -1,10 +1,8 @@
# Axidraw controller # axidraw controller
## High-level python api Implements robot_controller for the Axidraw robot.
https://axidraw.com/doc/py_api/ `axidraw_serial.py` is used to communicate with the robot using the python API.
If more direct control is desired, this can be implemented by sending serial commands directly to the [EBB control board](http://evil-mad.github.io/EggBot/ebb.html) of the Axidraw.
## Low-level serial API On linux systems the board appears on `/dev/ttyACM0`.
Can be used to send commands directly to the Axidraw controller board over serial.
http://evil-mad.github.io/EggBot/ebb.html

4
src/draw_svg/README.md Normal file
View File

@@ -0,0 +1,4 @@
# draw_svg
WILL BE REMOVED
Contains initial testing of libraries and launch files.

View File

@@ -0,0 +1,11 @@
# lite6 controller
Implements robot_controller for the xArm lite6 robot.
- web interface: http://192.168.1.150:18333
## free drive mode
This mode should allow the robot to be positioned by hand, this can be used for a homing procedure.
https://github.com/xArm-Developer/xarm_ros#6-mode-change
I have not found a way to access the button on the robot arm in code.

View File

@@ -0,0 +1,4 @@
# Robot controller
This package contains the `robot_controller` interface.
It also contains a `dummy_controller` that can be used for testing or reference.

View File

@@ -0,0 +1,3 @@
# Robot interfaces for drawing robot
Contains the custom messges, services, and actions used in the project.