esp32vn · tuanpmt · Jun 18, 2017 · Jun 17, 2017 · Jun 17, 2017
diff --git a/docs/_static/connection-board.jpg b/docs/_static/connection-board.jpg
diff --git a/docs/_static/setup-board.png b/docs/_static/setup-board.png
diff --git a/docs/_static/win-gui-get-exe.png b/docs/_static/win-gui-get-exe.png
diff --git a/docs/_static/win-gui-get-exe2.png b/docs/_static/win-gui-get-exe2.png
diff --git a/docs/basic/connection.rst b/docs/basic/connection.rst
@@ -0,0 +1,32 @@
+Kết nối phần cứng và cài đặt
+----------------------------
+Kết nối phần cứng
+=================
+Kết nối USB với Board mạch **ESP32 WiFi Uno** như hình bên dưới, đảm bảo đèn LED nguồn sáng.
+
+.. image:: ../_static/connection-board.jpg
+    :target: ../_static/connection-board.jpg
+    :width: 800
+
+Cài đặt USB Driver
+==================
+Tùy thuộc từng hệ điều hành mà chọn và tải bản cài đặt `CP210x USB to UART`_ phù hợp.
+
+
+Cấu hình kết nối
+=================
+
+* Sau khi cài đặt xong và kết nối, sẽ xuất hiện cổng COM ảo trên máy tính (Tùy từng loại hệ điều hành mà có những tên cổng như: ``COM1, COM2 ...`` đối với Windows, ``/dev/tty.wchusbserial1420`` trên Mac OS), ``/dev/ttyUSB0`` trên Ubuntu Linux)
+
+* Mở Arduino IDE và lựa chọn board (tham khảo cấu hình kết nối như hình dưới):
+
+    * Board: ``ESP32vn IoT Uno``
+    * Flash Frequency: ``80MHz``
+    * Port: chọn cổng khi gắn thiết bị vào sẽ thấy xuất hiện
+    * Upload speed: Chọn cao nhất, nếu nạp không được chọn thấp dần
+
+.. image:: ../_static/setup-board.png
+    :target: ../_static/setup-board.png
+    :width: 800
+
+.. _`CP210x USB to UART`: http://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers
diff --git a/docs/basic/hello.rst b/docs/basic/hello.rst
@@ -0,0 +1 @@
+## aaaaa
diff --git a/docs/basic/index.rst b/docs/basic/index.rst
@@ -1,2 +1,12 @@
-Basic
------
+Cài đặt
+*******
+
+.. toctree::
+   :maxdepth: 2
+
+   Cài đặt Arduino IDE<install>
+   Board ESP32vn IoT Uno <board>
+   Kết nối máy tính <connection>
+   Cài đặt thư viện <library>
+
+
diff --git a/docs/basic/install.rst b/docs/basic/install.rst
@@ -0,0 +1,96 @@
+Arduino cơ bản
+--------------
+
+Có thể tìm thấy hướng dẫn cài đặt Tiếng Anh và được cập nhật tại `Arduino for ESP32`_
+
+
+Chuẩn bị
+********
+
+- `Arduino 1.6.8`_ (hay mới hơn, nếu bạn biết bạn đang làm gì)
+- git
+- python 2.7
+- terminal, console, or command prompt (phụ thuộc hệ điều hành của bạn)
+- Kết nối Internet
+
+Hướng dẫn
+*********
+
+Cài đặt cho Debian/Ubuntu Linux
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+- Clone repository đến thư mục ``hardware/esp32com``. Hoặc bạn có thể clone vào nơi nào đó và tạo symlink bằng ``ln -s``, nếu Hệ điều hành hỗ trợ::
+
+    cd hardware
+    mkdir esp32com
+    cd esp32com
+    git clone https://github.com/espressif/arduino-esp32
+
+Cấu trúc dự án sau khi bạn thực hiện xong::
+
+    Arduino
+        |- hardware
+        |- esp32com
+            |- arduino-esp32
+                |- cores
+                |- doc
+                |- libraries
+                |- package
+                |- tools
+                |- variants
+                |- package.json
+                |- platform.txt
+                |- programmers.txt
+                |- README.md
+                |- boards.txt
+                |- component.mk
+                |- Kconfig
+                `- Makefile.projbuild
+
+- Tải binary tools::
+
+    cd tools/
+    python get.py
+
+- Khởi động lại Arduino IDE.
+
+Cài đặt cho Mac
+^^^^^^^^^^^^^^^
+
+- Mở ``terminal``, copy và past các command sau ::
+
+    mkdir -p ~/Documents/Arduino/hardware/espressif && \
+    cd ~/Documents/Arduino/hardware/espressif && \
+    git clone https://github.com/espressif/arduino-esp32.git esp32 && \
+    cd esp32/tools/ && \
+    python get.py
+
+- Khởi động lại Arduino IDE.
+
+Cài đặt cho Windows
+^^^^^^^^^^^^^^^^^^^
+
+- Mở ``terminal`` và cd đến thư mục Arduino. Nó có thể là thư mục *sketchbook* (thường là ``<Documents>/Arduino``), hay thư mục của Ứng dụng Arduino, tùy bạn chọn.
+
+- Clone/download repository https://github.com/espressif/arduino-esp32.git này đến thư mục ``hardware/esp32com`` 
+
+- Thường là ``C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/espressif/esp32``
+
+- Hoặc thay đổi *sketchbook* trên phù hợp với thư mục đã cài đặt Ứng dụng Arduino phù hợp trên máy. 
+
+- Mở ``C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/esp32/tools`` và double-click vào ``get.exe``
+
+.. image:: ../_static/win-gui-get-exe.png
+    :target: _static/win-gui-get-exe.png
+    :width: 800
+
+- Khi ``get.exe`` thực hiện xong, cấu trúc có thể thấy như sau: 
+
+.. image:: ../_static/win-gui-get-exe2.png
+    :target: _static/win-gui-get-exe2.png
+    :width: 800
+
+- Khởi động lại Arduino IDE.
+
+.. _`Arduino for ESP32`: https://github.com/espressif/arduino-esp32
+.. _`Arduino 1.6.8`: https://www.arduino.cc/en/Main/OldSoftwareReleases#previous
diff --git a/docs/index.rst b/docs/index.rst
@@ -37,8 +37,10 @@ Mạch nguyên lý
 .. toctree::
    :caption: Cơ bản
    :maxdepth: 2
-
+   
    Cài đặt <basic/index>
+   Hello World <basic/hello>
+
 
 .. toctree::
    :caption: Network/Protocol