Skip to content

Commit

Permalink
Add files
Browse files Browse the repository at this point in the history
  • Loading branch information
carlwolff committed Jul 10, 2016
1 parent ecdddb6 commit dec048a
Show file tree
Hide file tree
Showing 4 changed files with 48 additions and 0 deletions.
7 changes: 7 additions & 0 deletions part-1-computer-setup/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Summary

This chapter is about installing driver and the application we will use while programming the ESP8266-module. There's applications for Windows which makes it a lot easier to flash, however, they are also more limited in functionality and you have to find the right ones to get the job done.

* [Prepare Mac](mac.md)
* [Prepare Windows](windows.md)
* [Prepare Linux](linux.md)
Empty file added part-1-computer-setup/linux.md
Empty file.
22 changes: 22 additions & 0 deletions part-1-computer-setup/mac.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Install USB-driver

The ESP8266 v1 uses a USB-chip called CP2102 by SiLabs. It's straight forward to install. The driver is required to allow the ESP8266-module to communicate using [emulated serial port](https://en.wikipedia.org/wiki/Serial_port) protocol.

1. Unplug ESP8266
2. Download [driver](https://www.silabs.com/Support%20Documents/Software/Mac_OSX_VCP_Driver.zip) from SiLabs
3. Mount disk image by double clicking the `SiLabsUSBDriverDisk.dmg`. A new windows will pop open.
4. Install driver by double clicking `Silicon Labs VCP Driver.pkg` and follow instructions. You will be asked for your login password during this process.
5. Plugin EPS8266

To verify installation, go to Apple-menu, `About this Mac`, `System Report`, `USB`. You should see `CP2102 USB to UART Bridge Controller` in the list on the right side. If you are not running latest OS X, currently OS X El Capitan, then these steps differs somewhat.

# Install terminal for command input

The NodeMCU firmware will provide us with a prompt (similar to Terminal) on the serial interface we just enabled. What we now need is a tool to display that prompt. To unify the experience in Mac/Windows/Linux we use [PlatformIO IDE](http://platformio.org/platformio-ide).

1. Download [PlatformIO IDE](http://platformio.org/platformio-ide).
2. Open up `platformio-atom-mac.zip` that you just downloaded, it will result in a new application called Atom.
3. Install `Atom` by dragging the icon to `Applications` in Finder
3. Start Atom and wait for it to settle the installation before continuing.

![image](https://gitlab.com/iot-malmo/emergency-fika-button/uploads/383781f79d5ce590bafc36751dc73847/image.png)
19 changes: 19 additions & 0 deletions part-1-computer-setup/windows.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Install USB-driver

The ESP8266 v1 uses a USB-chip called CP2102 by SiLabs. It's straight forward to install. The driver is required to allow the ESP8266-module to communicate using [emulated serial port](https://en.wikipedia.org/wiki/Serial_port) protocol.

1. Unplug ESP8266
2. Download [driver](https://www.silabs.com/Support%20Documents/Software/CP210x_Windows_Drivers.zip) from SiLabs
3. Unzip file and open directory
4. Run either `CP210xVCPInstaller_x64.exe` (most common today) or `CP210xVCPInstaller_x86.exe` installer script depending on your CPU-architecture.
5. Plugin EPS8266

To verify installation, open `Device Manager` and unfold `Ports`. If there's a notion of CP210x, then your driver is installed.

# Install terminal for command input

The NodeMCU firmware will provide us with a prompt (similar to DOS/Powershell) on the serial interface we just enabled. What we now need is a tool to display that prompt. To unify the experience in Windows/Mac/Linux we use [PlatformIO IDE](http://platformio.org/platformio-ide).

1. Download [PlatformIO IDE](http://platformio.org/platformio-ide).
2. Open up `platformio-atom-windows.exe` that you just downloaded.
3. Start Atom and wait for it to settle the installation before continuing.

0 comments on commit dec048a

Please sign in to comment.