Merge pull request #1 from tlk-emb/restruct

Restruct

.gitignore

@@ -4,4 +4,20 @@
 *.bin
 *.history
 
-.metadata/
+# for TrueSTUDIO
+workspace/.metadata/
+workspace/*/.metadata/
+workspace/*/.settings/language.settings.xml
+
+# for ASP
+asp
+asp.*
+cfg1_out*
+kernel_cfg*
+offset.h
+GR-PEACH_mbed.map
+Makefile.depend
+
+# etc.,,,
+*.swp
+.DS_Store

.gitmodules

@@ -1,6 +1,8 @@
 [submodule "opencv-lib"]
 	path = opencv-lib
 	url = https://github.com/d-kato/opencv-lib.git
+  ignore = dirty
 [submodule "asp_mbed/asp-gr_peach_gcc-mbed"]
 	path = asp_mbed/asp-gr_peach_gcc-mbed
 	url = https://github.com/tlk-emb/asp-gr_peach_gcc-mbed.git
+  ignore = dirty

README.md

@@ -6,19 +6,54 @@ A lightweight runtime environment of ROS1 nodes onto embedded systems
 
 - Renesas GR-PEACH
 
-## Environment & Build
-
-- IDE: TrueSTUDIO v.8.0.0
+## How to get
 
 - $ git clone --recursive https://github.com/tlk-emb/mROS
 
-- Build
-  - Open TrueSTUDIO and specify the workspace to `<git_clone_dir>/mROS/truestudio`
-  - Select `camera_app` to target project and build it
-
+## Development Platform and Tools for Host PC
+
+- IDE: [Atollic TrueSTUDIO](https://atollic.com/truestudio/)
+  - Windows 10 Pro
+  - Ubuntu 16.04.5
+    - Currently we tested v.8.0.0, v.9.0.1 and v.9.1.0
+- CUI
+  - macOS High Sierra 10.13.6 / arm-none-eabi version 5.4.1 20160609 (Launchpad distribution)
+  - Ubuntu 16.04 LTS / gcc-arm-none-eabi version 4.9.3 20150529 (apt package)
+    - $ sudo apt install gcc-arm-none-eabi
+  - Ubuntu 14.04.5 LTS / gcc-arm-none-eabi version 4.9.3 20150529 ([Launchpad distribution](https://launchpad.net/gcc-arm-embedded/4.9/4.9-2015-q3-update))
+
+Please let us know if you could develop and build anothoer host OS.
+
+## SW Components
+
+- [asp-gr_peach_gcc-mbed](https://github.com/tlk-emb/asp-gr_peach_gcc-mbed)
+  - Open-source Software Platform Based on TOPPERS/ASP Kernel, mbed and Arduino Library for Renesas GR-PEACH.
+  - located at `asp_mbed/asp-gr_peach_gcc-mbed` as gitsubmodule
+- [opencv-lib](https://github.com/d-kato/opencv-lib.git)
+  - located at `opencv-lib` as gitsubmodule
+- [TOPPERS configurator](http://toppers.jp/cfg-download.html)
+  - located at `asp_mbed/cfg_binary`
+  - (for Win) cfg-mingw-static-1_9_6.zip
+  - (for Linux) cfg-linux-static-1_9_6.gz
+    - $ sudo apt install libstdc++6 lib32stdc++6
+  - (for macOS) cfg-osx-static-1_9_5.gz
+
+## Build
+
+- For TrueSTUDIO
+  - Specify and open `workspace` as workspace
+  - Import `workspace/*` such as `camera_app/`
+    - Currently `app/` cannot be built
+  - Describe `USE_TRUESTUDIO = true` on Makefile
+  - You can bulid and debug the project
+- For CUI (terminal)
+  - cd to project dir such as `workspace/asp_sample1/`
+  - Describe `USE_TRUESTUDIO = false` or comment-out such as `#USE_TRUESTUDIO = true` on Makefile
+  - `$ make` or `$ make depend && make`
 
 ## TODO
 
+- Support `app` example
 
 ## References