From c7e421e1d926c392ba5e79d4f32b09f6b02fd607 Mon Sep 17 00:00:00 2001 From: Raienryu97 Date: Fri, 4 Aug 2017 14:41:19 +0530 Subject: [PATCH 1/5] DOCUMENTATION: Moved installation instructions to separate page * Added Fedora to contents table * Added Issue/Bug Report section to README * Some minor improvements --- README.md | 152 +++--------------- doc/arduino-ide/debian_ubuntu.md | 19 +++ doc/arduino-ide/fedora.md | 16 ++ doc/arduino-ide/mac.md | 14 ++ .../win-screenshots}/arduino-ide.png | Bin .../win-screenshots}/win-gui-1.png | Bin .../win-screenshots}/win-gui-2.png | Bin .../win-screenshots}/win-gui-3.png | Bin .../win-screenshots}/win-gui-4.png | Bin .../win-screenshots}/win-gui-5.png | Bin .../win-screenshots}/win-gui-update-1.png | Bin .../win-screenshots}/win-gui-update-2.png | Bin doc/{ => arduino-ide}/windows.md | 38 ++--- doc/esp-idf_component.md | 55 +++++++ doc/make.md | 4 + doc/platformio.md | 12 ++ 16 files changed, 162 insertions(+), 148 deletions(-) create mode 100644 doc/arduino-ide/debian_ubuntu.md create mode 100644 doc/arduino-ide/fedora.md create mode 100644 doc/arduino-ide/mac.md rename doc/{ => arduino-ide/win-screenshots}/arduino-ide.png (100%) rename doc/{ => arduino-ide/win-screenshots}/win-gui-1.png (100%) rename doc/{ => arduino-ide/win-screenshots}/win-gui-2.png (100%) rename doc/{ => arduino-ide/win-screenshots}/win-gui-3.png (100%) rename doc/{ => arduino-ide/win-screenshots}/win-gui-4.png (100%) rename doc/{ => arduino-ide/win-screenshots}/win-gui-5.png (100%) rename doc/{ => arduino-ide/win-screenshots}/win-gui-update-1.png (100%) rename doc/{ => arduino-ide/win-screenshots}/win-gui-update-2.png (100%) rename doc/{ => arduino-ide}/windows.md (76%) create mode 100644 doc/esp-idf_component.md create mode 100644 doc/make.md create mode 100644 doc/platformio.md diff --git a/README.md b/README.md index 4825795e8ca..4474fec8e05 100644 --- a/README.md +++ b/README.md @@ -2,17 +2,21 @@ [![Build Status](https://travis-ci.org/espressif/arduino-esp32.svg?branch=master)](https://travis-ci.org/espressif/arduino-esp32) -## Need help or have a question? Join the chat at [![https://gitter.im/espressif/arduino-esp32](https://badges.gitter.im/espressif/arduino-esp32.svg)](https://gitter.im/espressif/arduino-esp32?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) +### Need help or have a question? Join the chat at [![https://gitter.im/espressif/arduino-esp32](https://badges.gitter.im/espressif/arduino-esp32.svg)](https://gitter.im/espressif/arduino-esp32?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) +## Contents - [Development Status](#development-status) - [Installation Instructions](#installation-instructions): - + [Using Arduino IDE](#using-through-arduino-ide) - + [Windows](https://github.com/espressif/arduino-esp32/blob/master/doc/windows.md) - + [Mac OS](#instructions-for-mac) - + [Debian/Ubuntu](#instructions-for-debianubuntu-linux) - + [Decoding Exceptions](#decoding-exceptions) - + [Using PlatformIO](#using-platformio) - + [Using as ESP-IDF component](#using-as-esp-idf-component) + + Using Arduino IDE + + [Windows](https://github.com/espressif/arduino-esp32/blob/master/doc/arduino-ide/windows.md) + + [Mac OS](https://github.com/espressif/arduino-esp32/blob/master/doc/arduino-ide/mac.md) + + [Debian/Ubuntu](https://github.com/espressif/arduino-esp32/blob/master/doc/arduino-ide/debian_ubuntu.md) + + [Fedora](https://github.com/espressif/arduino-esp32/blob/master/doc/arduino-ide/fedora.md) + + [Using PlatformIO](doc/platformio.md) + + [Building with make](doc/make.md) + + [Using as ESP-IDF component](doc/esp-idf_component.md) +- [Decoding Exceptions](#decoding-exceptions) +- [Issue/Bug report template](#Issue/Bug report template) - [ESP32Dev Board PINMAP](#esp32dev-board-pinmap) ## Development Status @@ -23,133 +27,24 @@ Most of the framework is implemented. Most noticable is the missing analogWrite. ## Installation Instructions -### Using through Arduino IDE - -#### [Instructions for Windows](doc/windows.md) - -#### Instructions for Mac -- Install latest Arduino IDE from [arduino.cc](https://www.arduino.cc/en/Main/Software) -- Open Terminal and execute the following command (copy->paste and hit enter): - - ```bash - 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 - ``` -- Restart Arduino IDE - -#### Instructions for Debian/Ubuntu Linux -- Install latest Arduino IDE from [arduino.cc](https://www.arduino.cc/en/Main/Software) -- Open Terminal and execute the following command (copy->paste and hit enter): - - ```bash - sudo usermod -a -G dialout $USER && \ - sudo apt-get install git && \ - wget https://bootstrap.pypa.io/get-pip.py && \ - sudo python get-pip.py && \ - sudo pip install pyserial && \ - mkdir -p ~/Arduino/hardware/espressif && \ - cd ~/Arduino/hardware/espressif && \ - git clone https://github.com/espressif/arduino-esp32.git esp32 && \ - cd esp32/tools/ && \ - python get.py - ``` -- Restart Arduino IDE - -#### Instructions for Fedora -- Install the latest Arduino IDE from [arduino.cc](https://www.arduino.cc/en/Main/Software). `$ sudo dnf -y install arduino` will most likely install an older release. -- Open Terminal and execute the following command (copy->paste and hit enter): - - ```bash - sudo usermod -a -G dialout $USER && \ - sudo dnf install git python3-pip python3-pyserial && \ - mkdir -p ~/Arduino/hardware/espressif && \ - cd ~/Arduino/hardware/espressif && \ - git clone https://github.com/espressif/arduino-esp32.git esp32 && \ - cd esp32/tools/ && \ - python get.py - ``` -- Restart Arduino IDE +- Using Arduino IDE + + [Instructions for Windows](doc/arduino-ide/windows.md) + + [Instructions for Mac](doc/arduino-ide/mac.md) + + [Instructions for Debian/Ubuntu Linux](doc/arduino-ide/debian_ubuntu.md) + + [Instructions for Fedora](doc/arduino-ide/fedora.md) +- [Using PlatformIO](doc/platformio.md) +- [Building with make](doc/make.md) +- [Using as ESP-IDF component](doc/esp-idf_component.md) #### Decoding exceptions You can use [EspExceptionDecoder](https://github.com/me-no-dev/EspExceptionDecoder) to get meaningful call trace. -### Using PlatformIO - -[PlatformIO](http://platformio.org) is an open source ecosystem for IoT -development with cross platform build system, library manager and full support -for Espressif ESP32 development. It works on the popular host OS: Mac OS X, Windows, -Linux 32/64, Linux ARM (like Raspberry Pi, BeagleBone, CubieBoard). - -- [What is PlatformIO?](http://docs.platformio.org/page/what-is-platformio.html) -- [PlatformIO IDE](http://platformio.org/platformio-ide) -- Quick Start with [PlatformIO IDE](http://docs.platformio.org/page/ide/atom.html#quick-start) or [PlatformIO Core](http://docs.platformio.org/page/core.html) -- [Integration with Cloud and Standalone IDEs](http://docs.platformio.org/page/ide.html) - - Cloud9, Codeanywehre, Eclipse Che (Codenvy), Atom, CLion, Eclipse, Emacs, NetBeans, Qt Creator, Sublime Text, VIM and Visual Studio -- [Project Examples](https://github.com/platformio/platform-espressif32/tree/develop/examples) -- [Using "Stage" (Git) version of Arduino Core](http://docs.platformio.org/page/platforms/espressif32.html#using-arduino-framework-with-staging-version) - -### Building with make +#### Issue/Bug report template +Before reporting an issue, make sure you've searched for similar one that was already created. Also make sure to go through all the issues labelled as [for reference](https://github.com/espressif/arduino-esp32/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3A%22for%20reference%22%20). -[makeEspArduino](https://github.com/plerup/makeEspArduino) is a generic makefile for any ESP8266/ESP32 Arduino project. -Using make instead of the Arduino IDE makes it easier to do automated and production builds. +Finally, if you're sure no one else had the issue, follow the [ISSUE_TEMPLATE](https://github.com/espressif/arduino-esp32/blob/master/ISSUE_TEMPLATE.md) while reporting any issue. -### Using as ESP-IDF component -- Download and install [esp-idf](https://github.com/espressif/esp-idf) -- Create blank idf project (from one of the examples) -- in the project folder, create a folder called components and clone this repository inside - - ```bash - mkdir -p components && \ - cd components && \ - git clone https://github.com/espressif/arduino-esp32.git arduino && \ - cd .. && \ - make menuconfig - ``` -- ```make menuconfig``` has some Arduino options - - "Autostart Arduino setup and loop on boot" - - If you enable this options, your main.cpp should be formated like any other sketch - - ```arduino - //file: main.cpp - #include "Arduino.h" - - void setup(){ - Serial.begin(115200); - } - - void loop(){ - Serial.println("loop"); - delay(1000); - } - ``` - - - Else you need to implement ```app_main()``` and call ```initArduino();``` in it. - - Keep in mind that setup() and loop() will not be called in this case. - If you plan to base your code on examples provided in [esp-idf](https://github.com/espressif/esp-idf/tree/master/examples), please make sure move the app_main() function in main.cpp from the files in the example. - - ```arduino - //file: main.cpp - #include "Arduino.h" - - extern "C" void app_main() - { - initArduino(); - pinMode(4, OUTPUT); - digitalWrite(4, HIGH); - //do your own thing - } - ``` - - "Disable mutex locks for HAL" - - If enabled, there will be no protection on the drivers from concurently accessing them from another thread/interrupt/core - - "Autoconnect WiFi on boot" - - If enabled, WiFi will start with the last known configuration - - Else it will wait for WiFi.begin -- ```make flash monitor``` will build, upload and open serial monitor to your board ## ESP32Dev Board PINMAP @@ -158,4 +53,3 @@ Using make instead of the Arduino IDE makes it easier to do automated and produc ## Hint Sometimes to program ESP32 via serial you must keep GPIO0 LOW during the programming process - diff --git a/doc/arduino-ide/debian_ubuntu.md b/doc/arduino-ide/debian_ubuntu.md new file mode 100644 index 00000000000..0f95cf2ac31 --- /dev/null +++ b/doc/arduino-ide/debian_ubuntu.md @@ -0,0 +1,19 @@ +Installation instructions for Debian / Ubuntu OS +================================================= + +- Install latest Arduino IDE from [arduino.cc](https://www.arduino.cc/en/Main/Software) +- Open Terminal and execute the following command (copy->paste and hit enter): + + ```bash + sudo usermod -a -G dialout $USER && \ + sudo apt-get install git && \ + wget https://bootstrap.pypa.io/get-pip.py && \ + sudo python get-pip.py && \ + sudo pip install pyserial && \ + mkdir -p ~/Arduino/hardware/espressif && \ + cd ~/Arduino/hardware/espressif && \ + git clone https://github.com/espressif/arduino-esp32.git esp32 && \ + cd esp32/tools/ && \ + python get.py + ``` +- Restart Arduino IDE diff --git a/doc/arduino-ide/fedora.md b/doc/arduino-ide/fedora.md new file mode 100644 index 00000000000..6672183989f --- /dev/null +++ b/doc/arduino-ide/fedora.md @@ -0,0 +1,16 @@ +Installation instructions for Fedora +===================================== + +- Install the latest Arduino IDE from [arduino.cc](https://www.arduino.cc/en/Main/Software). `$ sudo dnf -y install arduino` will most likely install an older release. +- Open Terminal and execute the following command (copy->paste and hit enter): + + ```bash + sudo usermod -a -G dialout $USER && \ + sudo dnf install git python3-pip python3-pyserial && \ + mkdir -p ~/Arduino/hardware/espressif && \ + cd ~/Arduino/hardware/espressif && \ + git clone https://github.com/espressif/arduino-esp32.git esp32 && \ + cd esp32/tools/ && \ + python get.py + ``` +- Restart Arduino IDE diff --git a/doc/arduino-ide/mac.md b/doc/arduino-ide/mac.md new file mode 100644 index 00000000000..e8c4c6cc290 --- /dev/null +++ b/doc/arduino-ide/mac.md @@ -0,0 +1,14 @@ +Installation instructions for Mac OS +===================================== + +- Install latest Arduino IDE from [arduino.cc](https://www.arduino.cc/en/Main/Software) +- Open Terminal and execute the following command (copy->paste and hit enter): + + ```bash + 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 + ``` +- Restart Arduino IDE diff --git a/doc/arduino-ide.png b/doc/arduino-ide/win-screenshots/arduino-ide.png similarity index 100% rename from doc/arduino-ide.png rename to doc/arduino-ide/win-screenshots/arduino-ide.png diff --git a/doc/win-gui-1.png b/doc/arduino-ide/win-screenshots/win-gui-1.png similarity index 100% rename from doc/win-gui-1.png rename to doc/arduino-ide/win-screenshots/win-gui-1.png diff --git a/doc/win-gui-2.png b/doc/arduino-ide/win-screenshots/win-gui-2.png similarity index 100% rename from doc/win-gui-2.png rename to doc/arduino-ide/win-screenshots/win-gui-2.png diff --git a/doc/win-gui-3.png b/doc/arduino-ide/win-screenshots/win-gui-3.png similarity index 100% rename from doc/win-gui-3.png rename to doc/arduino-ide/win-screenshots/win-gui-3.png diff --git a/doc/win-gui-4.png b/doc/arduino-ide/win-screenshots/win-gui-4.png similarity index 100% rename from doc/win-gui-4.png rename to doc/arduino-ide/win-screenshots/win-gui-4.png diff --git a/doc/win-gui-5.png b/doc/arduino-ide/win-screenshots/win-gui-5.png similarity index 100% rename from doc/win-gui-5.png rename to doc/arduino-ide/win-screenshots/win-gui-5.png diff --git a/doc/win-gui-update-1.png b/doc/arduino-ide/win-screenshots/win-gui-update-1.png similarity index 100% rename from doc/win-gui-update-1.png rename to doc/arduino-ide/win-screenshots/win-gui-update-1.png diff --git a/doc/win-gui-update-2.png b/doc/arduino-ide/win-screenshots/win-gui-update-2.png similarity index 100% rename from doc/win-gui-update-2.png rename to doc/arduino-ide/win-screenshots/win-gui-update-2.png diff --git a/doc/windows.md b/doc/arduino-ide/windows.md similarity index 76% rename from doc/windows.md rename to doc/arduino-ide/windows.md index 6764cb034c4..efd38fc05f6 100644 --- a/doc/windows.md +++ b/doc/arduino-ide/windows.md @@ -5,45 +5,45 @@ 2. Download and install Git from [git-scm.com](https://git-scm.com/download/win) 3. Start ```Git GUI``` and run through the following steps: - Select ```Clone Existing Repository``` - - ![Step 1](win-gui-1.png) - + + ![Step 1](win-screenshots/win-gui-1.png) + - Select source and destination - Source Location: ```https://github.com/espressif/arduino-esp32.git``` - Target Directory: ```C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/espressif/esp32``` - Change this to your Sketchbook Location if you have a different directory listed underneath the "Sketchbook location" in Arduino preferences. - Click ```Clone``` to start cloning the repository - - ![Step 2](win-gui-2.png) - ![Step 3](win-gui-3.png) - + + ![Step 2](win-screenshots/win-gui-2.png) + ![Step 3](win-screenshots/win-gui-3.png) + - Open ```C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/espressif/esp32/tools``` and double-click ```get.exe``` - - ![Step 4](win-gui-4.png) - + + ![Step 4](win-screenshots/win-gui-4.png) + - When ```get.exe``` finishes, you should see the following files in the directory - - ![Step 5](win-gui-5.png) - + + ![Step 5](win-screenshots/win-gui-5.png) + 4. Plug your ESP32 board and wait for the drivers to install (or install manually any that might be required) 5. Start Arduino IDE 6. Select your board in ```Tools > Board``` menu 7. Select the COM port that the board is attached to 8. Compile and upload (You might need to hold the boot button while uploading) - ![Arduino IDE Example](arduino-ide.png) + ![Arduino IDE Example](win-screenshots/arduino-ide.png) ### How to update to the latest code 1. Start ```Git GUI``` and you should see the repository under ```Open Recent Repository```. Click on it! - ![Update Step 1](win-gui-update-1.png) - + ![Update Step 1](win-screenshots/win-gui-update-1.png) + 2. From menu ```Remote``` select ```Fetch from``` > ```origin``` - ![Update Step 2](win-gui-update-2.png) - + ![Update Step 2](win-screenshots/win-gui-update-2.png) + 3. Wait for git to pull any changes and close ```Git GUI``` 4. Open ```C:/Users/[YOUR_USER_NAME]/Documents/Arduino/hardware/espressif/esp32/tools``` and double-click ```get.exe``` - ![Step 4](win-gui-4.png) + ![Step 4](win-screenshots/win-gui-4.png) diff --git a/doc/esp-idf_component.md b/doc/esp-idf_component.md new file mode 100644 index 00000000000..abf6f0c4ea0 --- /dev/null +++ b/doc/esp-idf_component.md @@ -0,0 +1,55 @@ +To use as a component of ESP-IDF +================================================= + +- Download and install [esp-idf](https://github.com/espressif/esp-idf) +- Create blank idf project (from one of the examples) +- in the project folder, create a folder called components and clone this repository inside + + ```bash + mkdir -p components && \ + cd components && \ + git clone https://github.com/espressif/arduino-esp32.git arduino && \ + cd .. && \ + make menuconfig + ``` +- ```make menuconfig``` has some Arduino options + - "Autostart Arduino setup and loop on boot" + - If you enable this options, your main.cpp should be formated like any other sketch + + ```arduino + //file: main.cpp + #include "Arduino.h" + + void setup(){ + Serial.begin(115200); + } + + void loop(){ + Serial.println("loop"); + delay(1000); + } + ``` + + - Else you need to implement ```app_main()``` and call ```initArduino();``` in it. + + Keep in mind that setup() and loop() will not be called in this case. + If you plan to base your code on examples provided in [esp-idf](https://github.com/espressif/esp-idf/tree/master/examples), please make sure move the app_main() function in main.cpp from the files in the example. + + ```arduino + //file: main.cpp + #include "Arduino.h" + + extern "C" void app_main() + { + initArduino(); + pinMode(4, OUTPUT); + digitalWrite(4, HIGH); + //do your own thing + } + ``` + - "Disable mutex locks for HAL" + - If enabled, there will be no protection on the drivers from concurently accessing them from another thread/interrupt/core + - "Autoconnect WiFi on boot" + - If enabled, WiFi will start with the last known configuration + - Else it will wait for WiFi.begin +- ```make flash monitor``` will build, upload and open serial monitor to your board diff --git a/doc/make.md b/doc/make.md new file mode 100644 index 00000000000..1fca5d79f9f --- /dev/null +++ b/doc/make.md @@ -0,0 +1,4 @@ +To use make +============ + + [makeEspArduino](https://github.com/plerup/makeEspArduino) is a generic makefile for any ESP8266/ESP32 Arduino project.Using make instead of the Arduino IDE makes it easier to do automated and production builds. diff --git a/doc/platformio.md b/doc/platformio.md new file mode 100644 index 00000000000..afa5c93187a --- /dev/null +++ b/doc/platformio.md @@ -0,0 +1,12 @@ +Installation instructions for using PlatformIO +================================================= + +[PlatformIO](http://platformio.org) is an open source ecosystem for IoT development with cross platform build system, library manager and full support for Espressif ESP32 development. It works on the popular host OS: Mac OS X, Windows,Linux 32/64, Linux ARM (like Raspberry Pi, BeagleBone, CubieBoard). + +- [What is PlatformIO?](http://docs.platformio.org/page/what-is-platformio.html) +- [PlatformIO IDE](http://platformio.org/platformio-ide) +- Quick Start with [PlatformIO IDE](http://docs.platformio.org/page/ide/atom.html#quick-start) or [PlatformIO Core](http://docs.platformio.org/page/core.html) +- [Integration with Cloud and Standalone IDEs](http://docs.platformio.org/page/ide.html) - + Cloud9, Codeanywehre, Eclipse Che (Codenvy), Atom, CLion, Eclipse, Emacs, NetBeans, Qt Creator, Sublime Text, VIM and Visual Studio +- [Project Examples](https://github.com/platformio/platform-espressif32/tree/develop/examples) +- [Using "Stage" (Git) version of Arduino Core](http://docs.platformio.org/page/platforms/espressif32.html#using-arduino-framework-with-staging-version) From c7dc13c295b1f8f15b6b8cd762af3f7845b22560 Mon Sep 17 00:00:00 2001 From: Raienryu97 Date: Fri, 4 Aug 2017 22:33:12 +0530 Subject: [PATCH 2/5] DOCUMENTATION: Rename directory doc to docs * Also move ISSUE_TEMPLATE.md to docs directory --- README.md | 32 +++++++++--------- ISSUE_TEMPLATE.md => docs/ISSUE_TEMPLATE.md | 0 {doc => docs}/arduino-ide/debian_ubuntu.md | 0 {doc => docs}/arduino-ide/fedora.md | 0 {doc => docs}/arduino-ide/mac.md | 0 .../win-screenshots/arduino-ide.png | Bin .../arduino-ide/win-screenshots/win-gui-1.png | Bin .../arduino-ide/win-screenshots/win-gui-2.png | Bin .../arduino-ide/win-screenshots/win-gui-3.png | Bin .../arduino-ide/win-screenshots/win-gui-4.png | Bin .../arduino-ide/win-screenshots/win-gui-5.png | Bin .../win-screenshots/win-gui-update-1.png | Bin .../win-screenshots/win-gui-update-2.png | Bin {doc => docs}/arduino-ide/windows.md | 0 {doc => docs}/esp-idf_component.md | 0 {doc => docs}/esp32_pinmap.png | Bin {doc => docs}/make.md | 0 {doc => docs}/platformio.md | 0 18 files changed, 16 insertions(+), 16 deletions(-) rename ISSUE_TEMPLATE.md => docs/ISSUE_TEMPLATE.md (100%) rename {doc => docs}/arduino-ide/debian_ubuntu.md (100%) rename {doc => docs}/arduino-ide/fedora.md (100%) rename {doc => docs}/arduino-ide/mac.md (100%) rename {doc => docs}/arduino-ide/win-screenshots/arduino-ide.png (100%) rename {doc => docs}/arduino-ide/win-screenshots/win-gui-1.png (100%) rename {doc => docs}/arduino-ide/win-screenshots/win-gui-2.png (100%) rename {doc => docs}/arduino-ide/win-screenshots/win-gui-3.png (100%) rename {doc => docs}/arduino-ide/win-screenshots/win-gui-4.png (100%) rename {doc => docs}/arduino-ide/win-screenshots/win-gui-5.png (100%) rename {doc => docs}/arduino-ide/win-screenshots/win-gui-update-1.png (100%) rename {doc => docs}/arduino-ide/win-screenshots/win-gui-update-2.png (100%) rename {doc => docs}/arduino-ide/windows.md (100%) rename {doc => docs}/esp-idf_component.md (100%) rename {doc => docs}/esp32_pinmap.png (100%) rename {doc => docs}/make.md (100%) rename {doc => docs}/platformio.md (100%) diff --git a/README.md b/README.md index 4474fec8e05..b23579b50b1 100644 --- a/README.md +++ b/README.md @@ -8,13 +8,13 @@ - [Development Status](#development-status) - [Installation Instructions](#installation-instructions): + Using Arduino IDE - + [Windows](https://github.com/espressif/arduino-esp32/blob/master/doc/arduino-ide/windows.md) - + [Mac OS](https://github.com/espressif/arduino-esp32/blob/master/doc/arduino-ide/mac.md) - + [Debian/Ubuntu](https://github.com/espressif/arduino-esp32/blob/master/doc/arduino-ide/debian_ubuntu.md) - + [Fedora](https://github.com/espressif/arduino-esp32/blob/master/doc/arduino-ide/fedora.md) - + [Using PlatformIO](doc/platformio.md) - + [Building with make](doc/make.md) - + [Using as ESP-IDF component](doc/esp-idf_component.md) + + [Windows](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/windows.md) + + [Mac OS](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/mac.md) + + [Debian/Ubuntu](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/debian_ubuntu.md) + + [Fedora](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/fedora.md) + + [Using PlatformIO](docs/platformio.md) + + [Building with make](docs/make.md) + + [Using as ESP-IDF component](docs/esp-idf_component.md) - [Decoding Exceptions](#decoding-exceptions) - [Issue/Bug report template](#Issue/Bug report template) - [ESP32Dev Board PINMAP](#esp32dev-board-pinmap) @@ -28,13 +28,13 @@ Most of the framework is implemented. Most noticable is the missing analogWrite. ## Installation Instructions - Using Arduino IDE - + [Instructions for Windows](doc/arduino-ide/windows.md) - + [Instructions for Mac](doc/arduino-ide/mac.md) - + [Instructions for Debian/Ubuntu Linux](doc/arduino-ide/debian_ubuntu.md) - + [Instructions for Fedora](doc/arduino-ide/fedora.md) -- [Using PlatformIO](doc/platformio.md) -- [Building with make](doc/make.md) -- [Using as ESP-IDF component](doc/esp-idf_component.md) + + [Instructions for Windows](docs/arduino-ide/windows.md) + + [Instructions for Mac](docs/arduino-ide/mac.md) + + [Instructions for Debian/Ubuntu Linux](docs/arduino-ide/debian_ubuntu.md) + + [Instructions for Fedora](docs/arduino-ide/fedora.md) +- [Using PlatformIO](docs/platformio.md) +- [Building with make](docs/make.md) +- [Using as ESP-IDF component](docs/esp-idf_component.md) #### Decoding exceptions @@ -43,12 +43,12 @@ You can use [EspExceptionDecoder](https://github.com/me-no-dev/EspExceptionDecod #### Issue/Bug report template Before reporting an issue, make sure you've searched for similar one that was already created. Also make sure to go through all the issues labelled as [for reference](https://github.com/espressif/arduino-esp32/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3A%22for%20reference%22%20). -Finally, if you're sure no one else had the issue, follow the [ISSUE_TEMPLATE](https://github.com/espressif/arduino-esp32/blob/master/ISSUE_TEMPLATE.md) while reporting any issue. +Finally, if you're sure no one else had the issue, follow the [ISSUE_TEMPLATE](https://github.com/espressif/arduino-esp32/blob/master/docs/ISSUE_TEMPLATE.md) while reporting any issue. ## ESP32Dev Board PINMAP -![Pin Functions](doc/esp32_pinmap.png) +![Pin Functions](docs/esp32_pinmap.png) ## Hint diff --git a/ISSUE_TEMPLATE.md b/docs/ISSUE_TEMPLATE.md similarity index 100% rename from ISSUE_TEMPLATE.md rename to docs/ISSUE_TEMPLATE.md diff --git a/doc/arduino-ide/debian_ubuntu.md b/docs/arduino-ide/debian_ubuntu.md similarity index 100% rename from doc/arduino-ide/debian_ubuntu.md rename to docs/arduino-ide/debian_ubuntu.md diff --git a/doc/arduino-ide/fedora.md b/docs/arduino-ide/fedora.md similarity index 100% rename from doc/arduino-ide/fedora.md rename to docs/arduino-ide/fedora.md diff --git a/doc/arduino-ide/mac.md b/docs/arduino-ide/mac.md similarity index 100% rename from doc/arduino-ide/mac.md rename to docs/arduino-ide/mac.md diff --git a/doc/arduino-ide/win-screenshots/arduino-ide.png b/docs/arduino-ide/win-screenshots/arduino-ide.png similarity index 100% rename from doc/arduino-ide/win-screenshots/arduino-ide.png rename to docs/arduino-ide/win-screenshots/arduino-ide.png diff --git a/doc/arduino-ide/win-screenshots/win-gui-1.png b/docs/arduino-ide/win-screenshots/win-gui-1.png similarity index 100% rename from doc/arduino-ide/win-screenshots/win-gui-1.png rename to docs/arduino-ide/win-screenshots/win-gui-1.png diff --git a/doc/arduino-ide/win-screenshots/win-gui-2.png b/docs/arduino-ide/win-screenshots/win-gui-2.png similarity index 100% rename from doc/arduino-ide/win-screenshots/win-gui-2.png rename to docs/arduino-ide/win-screenshots/win-gui-2.png diff --git a/doc/arduino-ide/win-screenshots/win-gui-3.png b/docs/arduino-ide/win-screenshots/win-gui-3.png similarity index 100% rename from doc/arduino-ide/win-screenshots/win-gui-3.png rename to docs/arduino-ide/win-screenshots/win-gui-3.png diff --git a/doc/arduino-ide/win-screenshots/win-gui-4.png b/docs/arduino-ide/win-screenshots/win-gui-4.png similarity index 100% rename from doc/arduino-ide/win-screenshots/win-gui-4.png rename to docs/arduino-ide/win-screenshots/win-gui-4.png diff --git a/doc/arduino-ide/win-screenshots/win-gui-5.png b/docs/arduino-ide/win-screenshots/win-gui-5.png similarity index 100% rename from doc/arduino-ide/win-screenshots/win-gui-5.png rename to docs/arduino-ide/win-screenshots/win-gui-5.png diff --git a/doc/arduino-ide/win-screenshots/win-gui-update-1.png b/docs/arduino-ide/win-screenshots/win-gui-update-1.png similarity index 100% rename from doc/arduino-ide/win-screenshots/win-gui-update-1.png rename to docs/arduino-ide/win-screenshots/win-gui-update-1.png diff --git a/doc/arduino-ide/win-screenshots/win-gui-update-2.png b/docs/arduino-ide/win-screenshots/win-gui-update-2.png similarity index 100% rename from doc/arduino-ide/win-screenshots/win-gui-update-2.png rename to docs/arduino-ide/win-screenshots/win-gui-update-2.png diff --git a/doc/arduino-ide/windows.md b/docs/arduino-ide/windows.md similarity index 100% rename from doc/arduino-ide/windows.md rename to docs/arduino-ide/windows.md diff --git a/doc/esp-idf_component.md b/docs/esp-idf_component.md similarity index 100% rename from doc/esp-idf_component.md rename to docs/esp-idf_component.md diff --git a/doc/esp32_pinmap.png b/docs/esp32_pinmap.png similarity index 100% rename from doc/esp32_pinmap.png rename to docs/esp32_pinmap.png diff --git a/doc/make.md b/docs/make.md similarity index 100% rename from doc/make.md rename to docs/make.md diff --git a/doc/platformio.md b/docs/platformio.md similarity index 100% rename from doc/platformio.md rename to docs/platformio.md From cf8438c7e07728473b1db513bf1e95b71fa7c430 Mon Sep 17 00:00:00 2001 From: Raienryu97 Date: Fri, 4 Aug 2017 22:43:05 +0530 Subject: [PATCH 3/5] DOCUMENTATION: Use current repo's files * This makes it consistent instead of having few local and few pointing to espressif/arduino-esp32 by all linking to local files --- README.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index b23579b50b1..bfca2c39ba6 100644 --- a/README.md +++ b/README.md @@ -8,10 +8,10 @@ - [Development Status](#development-status) - [Installation Instructions](#installation-instructions): + Using Arduino IDE - + [Windows](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/windows.md) - + [Mac OS](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/mac.md) - + [Debian/Ubuntu](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/debian_ubuntu.md) - + [Fedora](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/fedora.md) + + [Windows](docs/arduino-ide/windows.md) + + [Mac OS](docs/arduino-ide/mac.md) + + [Debian/Ubuntu](docs/arduino-ide/debian_ubuntu.md) + + [Fedora](docs/arduino-ide/fedora.md) + [Using PlatformIO](docs/platformio.md) + [Building with make](docs/make.md) + [Using as ESP-IDF component](docs/esp-idf_component.md) @@ -21,9 +21,9 @@ ## Development Status Most of the framework is implemented. Most noticable is the missing analogWrite. While analogWrite is on it's way, there are a few other options that you can use: -- 16 channels [LEDC](https://github.com/espressif/arduino-esp32/blob/master/cores/esp32/esp32-hal-ledc.h) which is PWM -- 8 channels [SigmaDelta](https://github.com/espressif/arduino-esp32/blob/master/cores/esp32/esp32-hal-sigmadelta.h) which uses SigmaDelta modulation -- 2 channels [DAC](https://github.com/espressif/arduino-esp32/blob/master/cores/esp32/esp32-hal-dac.h) which gives real analog output +- 16 channels [LEDC](cores/esp32/esp32-hal-ledc.h) which is PWM +- 8 channels [SigmaDelta](cores/esp32/esp32-hal-sigmadelta.h) which uses SigmaDelta modulation +- 2 channels [DAC](cores/esp32/esp32-hal-dac.h) which gives real analog output ## Installation Instructions @@ -43,7 +43,7 @@ You can use [EspExceptionDecoder](https://github.com/me-no-dev/EspExceptionDecod #### Issue/Bug report template Before reporting an issue, make sure you've searched for similar one that was already created. Also make sure to go through all the issues labelled as [for reference](https://github.com/espressif/arduino-esp32/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3A%22for%20reference%22%20). -Finally, if you're sure no one else had the issue, follow the [ISSUE_TEMPLATE](https://github.com/espressif/arduino-esp32/blob/master/docs/ISSUE_TEMPLATE.md) while reporting any issue. +Finally, if you're sure no one else had the issue, follow the [ISSUE_TEMPLATE](docs/ISSUE_TEMPLATE.md) while reporting any issue. ## ESP32Dev Board PINMAP From 464329ccec04ee2fa5917e9f0ccbba398b0a71f2 Mon Sep 17 00:00:00 2001 From: Raienryu97 Date: Sun, 6 Aug 2017 15:23:30 +0530 Subject: [PATCH 4/5] DOCUMENTATION: Fix hyperlink to issue/bug template in contents --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bfca2c39ba6..1c05ec3337a 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ + [Building with make](docs/make.md) + [Using as ESP-IDF component](docs/esp-idf_component.md) - [Decoding Exceptions](#decoding-exceptions) -- [Issue/Bug report template](#Issue/Bug report template) +- [Issue/Bug report template](#issuebug-report-template) - [ESP32Dev Board PINMAP](#esp32dev-board-pinmap) ## Development Status From 32a4f26ab78362d1189de7f77cb8283ac63f44f5 Mon Sep 17 00:00:00 2001 From: Raienryu97 Date: Tue, 8 Aug 2017 13:09:24 +0530 Subject: [PATCH 5/5] DOCUMENTATION: contents: supress platform specific installation instruction --- README.md | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/README.md b/README.md index 1c05ec3337a..2ed2e00e805 100644 --- a/README.md +++ b/README.md @@ -6,15 +6,7 @@ ## Contents - [Development Status](#development-status) -- [Installation Instructions](#installation-instructions): - + Using Arduino IDE - + [Windows](docs/arduino-ide/windows.md) - + [Mac OS](docs/arduino-ide/mac.md) - + [Debian/Ubuntu](docs/arduino-ide/debian_ubuntu.md) - + [Fedora](docs/arduino-ide/fedora.md) - + [Using PlatformIO](docs/platformio.md) - + [Building with make](docs/make.md) - + [Using as ESP-IDF component](docs/esp-idf_component.md) +- [Installation Instructions](#installation-instructions) - [Decoding Exceptions](#decoding-exceptions) - [Issue/Bug report template](#issuebug-report-template) - [ESP32Dev Board PINMAP](#esp32dev-board-pinmap)