aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJuneChul Roh2020-12-15 13:35:00 -0600
committerJuneChul Roh2020-12-15 13:35:00 -0600
commit9f55241644b8a0f251ec8455599c59e049bfd62c (patch)
treee937e6389df235e772d7106006a4dd275e401399
parent1c9e484c75c792d05d0b5764a25fc3f1d5951e17 (diff)
downloadjacinto_ros_perception-9f55241644b8a0f251ec8455599c59e049bfd62c.tar.gz
jacinto_ros_perception-9f55241644b8a0f251ec8455599c59e049bfd62c.tar.xz
jacinto_ros_perception-9f55241644b8a0f251ec8455599c59e049bfd62c.zip
Minor update to README.md
-rw-r--r--README.md6
-rw-r--r--docker/README.md46
-rw-r--r--docker/README.pdfbin148734 -> 0 bytes
3 files changed, 26 insertions, 26 deletions
diff --git a/README.md b/README.md
index 87b2b33..75b6817 100644
--- a/README.md
+++ b/README.md
@@ -32,11 +32,11 @@ The TI Vision Apps Library is a set of APIs for the target deployment that are d
32The TI Vision Apps Library is included in the pre-built package of [J721E Processor SDK RTOS 7.1.0](https://software-dl.ti.com/jacinto7/esd/processor-sdk-rtos-jacinto7/latest/index_FDS.html). 32The TI Vision Apps Library is included in the pre-built package of [J721E Processor SDK RTOS 7.1.0](https://software-dl.ti.com/jacinto7/esd/processor-sdk-rtos-jacinto7/latest/index_FDS.html).
33 33
34## How to Set Up TI OpenVX + ROS Docker Container Environment on J7 Target 34## How to Set Up TI OpenVX + ROS Docker Container Environment on J7 Target
35<a href="docker/README.pdf" download>Click to download docker/README.pdf</a> 35<a href="https://tidrive.ext.ti.com/fss/public/link/public/stream/read/docker_README.pdf?linkToken=7yUfdiUlH3r9JR93&itemName=4633a68d-435b-4f2b-af36-74d97d5dc9fd" download>Click to Download J7ROS_Docker_README.pdf</a>
36 36
37<a href="https://tidrive.ext.ti.com/fss/public/link/public/stream/read/docker_README.pdf?linkToken=7yUfdiUlH3r9JR93&itemName=4633a68d-435b-4f2b-af36-74d97d5dc9fd" download>Click to download docker/README.pdf</a> 37<!-- <a href="https://software-dl.ti.com/jacinto7/esd/processor-sdk-rtos-jacinto7/ros_perception/J7ROS_Docker_READMD.pdf" download>Click to Download J7ROS_Docker_README.pdf</a> -->
38 38
39For debugging (Caution: there are formatting issues): [docker/README.md](docker/README.md) 39For debugging (Caution: there is formatting issue): [docker/README.md](docker/README.md)
40 40
41## TI OpenVX + ROS Demo Applications 41## TI OpenVX + ROS Demo Applications
42 42
diff --git a/docker/README.md b/docker/README.md
index 5bfe8cc..b1c3c04 100644
--- a/docker/README.md
+++ b/docker/README.md
@@ -16,7 +16,7 @@ This TI OpenVX + ROS development framework works with [pre-built package](https:
16### Ubuntu PC 16### Ubuntu PC
17A Ubuntu (18.04 recommended) PC is required. For RViz visualization of input/output topics published from the J7, it is assumed that ROS (Melodic recommended) is installed on the Ubuntu PC. 17A Ubuntu (18.04 recommended) PC is required. For RViz visualization of input/output topics published from the J7, it is assumed that ROS (Melodic recommended) is installed on the Ubuntu PC.
18 18
19Once finding the IP address assigned to J7 EVM (using a serial port communications program, for example, `minicom`), connect to J7 Linux with SSH:<br> 19Once finding the IP address assigned to J7 EVM (using a serial port communications program, for example, `minicom`), connect to J7 Linux with SSH:
20``` 20```
21ssh root@<J7_IP_address> 21ssh root@<J7_IP_address>
22``` 22```
@@ -41,7 +41,7 @@ Figure 1 shows the hardware setup and high-level installation steps on the J7 ta
41 41
42## Clone Git Repository 42## Clone Git Repository
43 43
441. Set up the project directory and the catkin workspace:<br> 441. Set up the project directory and the catkin workspace:
45 ``` 45 ```
46 WORK_DIR=$HOME/j7ros_home 46 WORK_DIR=$HOME/j7ros_home
47 CATKIN_WS=$WORK_DIR/catkin_ws 47 CATKIN_WS=$WORK_DIR/catkin_ws
@@ -50,20 +50,20 @@ Figure 1 shows the hardware setup and high-level installation steps on the J7 ta
50 cd $CATKIN_WS/src 50 cd $CATKIN_WS/src
51 ``` 51 ```
52 52
532. Clone the project GIT repository:<br> 532. Clone the project GIT repository:
54 ``` 54 ```
55 git clone https://git.ti.com/git/processor-sdk-vision/jacinto_ros_perception.git 55 git clone https://git.ti.com/git/processor-sdk-vision/jacinto_ros_perception.git
56 ``` 56 ```
57 57
58## Download TIDL Model & ROSBAG File 58## Download TIDL Model & ROSBAG File
59 59
601. For convenience, set up following soft-links:<br> 601. For convenience, set up following soft-links:
61 ``` 61 ```
62 cd $WORK_DIR 62 cd $WORK_DIR
63 ln -s $CATKIN_WS/src/jacinto_ros_perception/docker/Makefile 63 ln -s $CATKIN_WS/src/jacinto_ros_perception/docker/Makefile
64 ``` 64 ```
65 65
662. To download data files, run the following in `$WORK_DIR`:<br> 662. To download data files, run the following in `$WORK_DIR`:
67 ``` 67 ```
68 make data_download 68 make data_download
69 ``` 69 ```
@@ -75,13 +75,13 @@ Figure 1 shows the hardware setup and high-level installation steps on the J7 ta
751. Following [this link](https://docs.docker.com/get-started/#test-docker-installation), 751. Following [this link](https://docs.docker.com/get-started/#test-docker-installation),
76check that Docker and network work correctly on the J7 host Linux. 76check that Docker and network work correctly on the J7 host Linux.
77 77
782. To generate bash scripts for building and running a Docker image for the project:<br> 782. To generate bash scripts for building and running a Docker image for the project:
79 ``` 79 ```
80 make scripts 80 make scripts
81 ``` 81 ```
82 Make sure that two bash scripts named `docker_build.sh` and `docker_run.sh` are generated. 82 Make sure that two bash scripts named `docker_build.sh` and `docker_run.sh` are generated.
83 83
843. To build the Docker image, at `$WORK_DIR` run:<br> 843. To build the Docker image, at `$WORK_DIR` run:
85 ``` 85 ```
86 ./docker_build.sh 86 ./docker_build.sh
87 ``` 87 ```
@@ -93,7 +93,7 @@ check that Docker and network work correctly on the J7 host Linux.
93## Set Up Remote PC for Visualization 93## Set Up Remote PC for Visualization
94Open another terminal on Ubuntu PC to set up environment for RViz visualization. 94Open another terminal on Ubuntu PC to set up environment for RViz visualization.
95 95
961. Clone GIT repository:<br> 961. Clone GIT repository:
97 ``` 97 ```
98 CATKIN_WS=$HOME/j7ros_home/catkin_ws 98 CATKIN_WS=$HOME/j7ros_home/catkin_ws
99 mkdir -p $CATKIN_WS/src 99 mkdir -p $CATKIN_WS/src
@@ -101,25 +101,25 @@ Open another terminal on Ubuntu PC to set up environment for RViz visualization.
101 git clone https://git.ti.com/git/processor-sdk-vision/jacinto_ros_perception.git 101 git clone https://git.ti.com/git/processor-sdk-vision/jacinto_ros_perception.git
102 ``` 102 ```
103 103
1042. Build ROS nodes:<br> 1042. Build ROS nodes:
105 ``` 105 ```
106 cd $CATKIN_WS 106 cd $CATKIN_WS
107 catkin_make 107 catkin_make
108 ``` 108 ```
109 109
1103. ROS network setting: For convenience, set up a soft-link:<br> 1103. ROS network setting: For convenience, set up a soft-link:
111 ``` 111 ```
112 ln -s src/jacinto_ros_perception/setup_env_pc.sh 112 ln -s src/jacinto_ros_perception/setup_env_pc.sh
113 ``` 113 ```
114 114
115 Update the following lines in `setup_env_pc.sh`:<br> 115 Update the following lines in `setup_env_pc.sh`:
116 ``` 116 ```
117 PC_IP_ADDR=<PC_IP_address> 117 PC_IP_ADDR=<PC_IP_address>
118 J7_IP_ADDR=<J7_IP_address> 118 J7_IP_ADDR=<J7_IP_address>
119 ``` 119 ```
120 `<J7_IP_address>` can be found by running `make ip_show` on **J7 terminal**. 120 `<J7_IP_address>` can be found by running `make ip_show` on **J7 terminal**.
121 121
122 To set up the PC environment, run the following:<br> 122 To set up the PC environment, run the following:
123 ``` 123 ```
124 source setup_env_pc.sh 124 source setup_env_pc.sh
125 ``` 125 ```
@@ -129,12 +129,12 @@ After launching ROS nodes on the J7, we can check the all the ROS topics by runn
129<!-- ================================================================================= --> 129<!-- ================================================================================= -->
130## Build Demo ROS Applications 130## Build Demo ROS Applications
131 131
1321. To run the docker image:<br> 1321. To run the docker image:
133 ``` 133 ```
134 ./docker_run.sh 134 ./docker_run.sh
135 ``` 135 ```
136 136
1372. To build ROS applications, inside the Docker container:<br> 1372. To build ROS applications, inside the Docker container:
138 ``` 138 ```
139 cd $CATKIN_WS 139 cd $CATKIN_WS
140 catkin_make 140 catkin_make
@@ -143,47 +143,47 @@ After launching ROS nodes on the J7, we can check the all the ROS topics by runn
143 143
144## Run Stereo Vision Application 144## Run Stereo Vision Application
145 145
1461. **[J7]** To launch `ti_sde` node with playing back a ROSBAG file, run the following in `$WORK_DIR` on the J7 host Linux:<br> 1461. **[J7]** To launch `ti_sde` node with playing back a ROSBAG file, run the following in `$WORK_DIR` on the J7 host Linux:
147 ``` 147 ```
148 ./docker_run.sh roslaunch ti_sde bag_sde.launch 148 ./docker_run.sh roslaunch ti_sde bag_sde.launch
149 ``` 149 ```
150 Alternatively, you can run the following `roslaunch` command **inside** the Docker container:<br> 150 Alternatively, you can run the following `roslaunch` command **inside** the Docker container:
151 ``` 151 ```
152 roslaunch ti_sde bag_sde.launch 152 roslaunch ti_sde bag_sde.launch
153 ``` 153 ```
154 154
1552. **[Remote PC]** For visualization, on the PC:<br> 1552. **[Remote PC]** For visualization, on the PC:
156 ``` 156 ```
157 roslaunch ti_sde rviz.launch 157 roslaunch ti_sde rviz.launch
158 ``` 158 ```
159 159
160## Run CNN Semantic Segmentation Application 160## Run CNN Semantic Segmentation Application
161 161
1621. **[J7]** To launch `ti_semseg_cnn` node with playing back a ROSBAG file, run the following in `$WORK_DIR` on the J7 host Linux:<br> 1621. **[J7]** To launch `ti_semseg_cnn` node with playing back a ROSBAG file, run the following in `$WORK_DIR` on the J7 host Linux:
163 ``` 163 ```
164 ./docker_run.sh roslaunch ti_semseg_cnn bag_semseg_cnn.launch 164 ./docker_run.sh roslaunch ti_semseg_cnn bag_semseg_cnn.launch
165 ``` 165 ```
166 Alternatively, you can run the following `roslaunch` command **inside** the Docker container:<br> 166 Alternatively, you can run the following `roslaunch` command **inside** the Docker container:
167 ``` 167 ```
168 roslaunch ti_semseg_cnn bag_semseg_cnn.launch 168 roslaunch ti_semseg_cnn bag_semseg_cnn.launch
169 ``` 169 ```
170 170
1712. **[Remote PC]** For visualization, on the PC:<br> 1712. **[Remote PC]** For visualization, on the PC:
172 ``` 172 ```
173 roslaunch ti_semseg_cnn rviz.launch 173 roslaunch ti_semseg_cnn rviz.launch
174 ``` 174 ```
175## Run Stereo Vision and CNN Semantic Segmentation Together 175## Run Stereo Vision and CNN Semantic Segmentation Together
176 176
1771. **[J7]** To launch `ti_sde` and `ti_semseg_cnn` together with playing back a ROSBAG file, run the following in `$WORK_DIR` on the J7 host Linux:<br> 1771. **[J7]** To launch `ti_sde` and `ti_semseg_cnn` together with playing back a ROSBAG file, run the following in `$WORK_DIR` on the J7 host Linux:
178 ``` 178 ```
179 ./docker_run.sh roslaunch ti_sde bag_sde_semseg.launch 179 ./docker_run.sh roslaunch ti_sde bag_sde_semseg.launch
180 ``` 180 ```
181 Alternatively, you can run the following `roslaunch` command **inside** the Docker container:<br> 181 Alternatively, you can run the following `roslaunch` command **inside** the Docker container:
182 ``` 182 ```
183 roslaunch ti_sde bag_sde_semseg.launch 183 roslaunch ti_sde bag_sde_semseg.launch
184 ``` 184 ```
185 185
1862. **[Remote PC]** For visualization, on the PC:<br> 1862. **[Remote PC]** For visualization, on the PC:
187 ``` 187 ```
188 roslaunch ti_sde rviz_sde_semseg.launch 188 roslaunch ti_sde rviz_sde_semseg.launch
189 ``` 189 ```
diff --git a/docker/README.pdf b/docker/README.pdf
deleted file mode 100644
index 9c8edff..0000000
--- a/docker/README.pdf
+++ /dev/null
Binary files differ