* [Gazebo] - Work in progress but with satisfactory results (**Version >= 2.2.2 alongside gazebo-ros-pkgs >= 2.3.4 and [roboticsgroup_gazebo_plugins]**) [optional]
*This requires that you have connected to the Robot/Simulation via nao_dcm driver* and will open up **rviz with the Navigation plugin configured** to give Nao trajectories to execute.
###Webots Simulation
Launch your **Webots for Nao Simulator** and then **follow the instructions above to bringup nao_dcm driver** (remotely). *On some versions of Webots, it is required that you move the head before you get camera feedback. Also, changing the camera resolution via dynamic reconfigure will not have any effect as Webots uses fixed resolution.*
**NOTE: **This is work in progress and may not work very well.
This will **launch Gazebo Simulator** and **trajectory controllers** to simulate the real robot. *This is somewhat equivalent as bringing up nao_dcm_driver (remotely)*. Thus, then for example you can use MoveIt Demo to give trajectories to Nao to execute.
All properties are located in the [gazebo launch] files (in each body type).
* **use_pid** - true/false => Choose whether to use pid control in motors or not. Currently, usage without PIDs is highly unstable. Also, PID values REALLY need tuning. So, please contribute to that direction.
* **nao_meshes** - true/false => Choose whether to use nao_meshes 3D Objects or not
* **use_helmet** - true/false => Choose whether to mount on Nao the Helmet (along with 2 cameras)
* **helmet_cameras_viz** - true/false => Choose whether to visualize the cameras on Helmet
* **use_odroid** - true/false => Choose whether to mount Odroid Bag on Nao
* **use_hector_imu** - true/false => Choose whether to use hector_imu_plugin or the default by Gazebo for IMU simulation
###nao_meshes Integration
Download [nao_meshes] repo, generate the meshes (it creates .obj for visual and .ply for collisions) and convert them to collada (.dae) in the same folders with Blender or Meshlab (do not change any orientation [visual components are rotated] - export only the parts and not the whole scene). No \*\_dcm\_\* is needed for the nao\_meshes. For quick results you can always fall-back to boxes and cylinders (simple change to false the xacro property {nao_meshes} at this file). All packages work the same with or without nao_meshes.
* **nao_dcm can be run locally**, *but you need to have built and installed ROS Hydro on Nao as nao_dcm requires ros_controls packages* (available only on >= Hydro). Yet, running **nao_dcm** driver remotely is identical in performance as running it locally (if the connection is strong and persistent - Wi-Fi usage is not recommended).
* Integration with [nao_meshes] for better visual feedback. You can disable it if you want a rough 3D model made of boxes and cylinders. **NOTE**: *You need to convert the .obj and the .ply 3D objects to the collada format (in the same folder).*
* Although my intension is to provide ROS integration to the machine, basic gait and motion planning schemes are on the way for those that want quick results/feedback.
* *Integration for LED, IR and Audio hardware is not available and is not on my agenda*. So, **feel free to contribute in that direction**.
* **This is only ONE part of my Diploma Thesis** (*"Navigation of Humanoid Robots in Unknown Space With Dynamic Obstacles"*), so many parts of the code are not perfect and well-thought. So, **PRs for code improvement are welcomed.**
