Improve package docs
This commit is contained in:
109
README.md
109
README.md
@@ -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
|
||||||
|
|
||||||
|
```
|
||||||
|
|||||||
@@ -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
4
src/draw_svg/README.md
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
# draw_svg
|
||||||
|
WILL BE REMOVED
|
||||||
|
|
||||||
|
Contains initial testing of libraries and launch files.
|
||||||
11
src/lite6_controller/README.md
Normal file
11
src/lite6_controller/README.md
Normal 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.
|
||||||
4
src/robot_controller/README.md
Normal file
4
src/robot_controller/README.md
Normal 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.
|
||||||
3
src/robot_interfaces/README.md
Normal file
3
src/robot_interfaces/README.md
Normal file
@@ -0,0 +1,3 @@
|
|||||||
|
# Robot interfaces for drawing robot
|
||||||
|
|
||||||
|
Contains the custom messges, services, and actions used in the project.
|
||||||
Reference in New Issue
Block a user