Skip to content

Commit

Permalink
Promote official board
Browse files Browse the repository at this point in the history
  • Loading branch information
omersiar committed Aug 8, 2018
1 parent 0c4cf5a commit c7e69dd
Show file tree
Hide file tree
Showing 3 changed files with 22 additions and 11 deletions.
23 changes: 19 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Access Control system using a cheap MFRC522, PN532 RFID readers or Wiegand RFID

[See Demo Here](https://bitadvise.com/esp-rfid/)

[![Showcase Gif](https://raw.githubusercontent.com/omersiar/esp-rfid/stable/demo/showcase.gif)](https://bitadvise.com/esp-rfid/)
[![Showcase Gif](https://raw.githubusercontent.com/omersiar/esp-rfid/stable/demo/showcase.gif)](https://bitadvise.com/esp-rfid/)[![Board](https://raw.githubusercontent.com/omersiar/esp-rfid/stable/demo/board.jpg)](https://www.tindie.com/products/nardev/esp-rfid-relay-board-12v-in-esp8266-board/)

## Features
### For Users
Expand Down Expand Up @@ -34,6 +34,8 @@ This project still in its development phase. New features (and also bugs) are in

### What You Will Need
### Hardware
* [Official ESP-RFID Relay Board](https://www.tindie.com/products/nardev/esp-rfid-relay-board-12v-in-esp8266-board/)
or
* An ESP8266 module or a development board like **WeMos D1 mini** or **NodeMcu 1.0** with at least **32Mbit Flash (equals to 4MBytes)** (ESP32 does not supported for now)
* A MFRC522 RFID PCD Module or PN532 NFC Reader Module or Wiegand based RFID reader
* A Relay Module (or you can build your own circuit)
Expand All @@ -42,9 +44,12 @@ This project still in its development phase. New features (and also bugs) are in
### Software

#### Using Compiled Binaries
Compiled firmware binary and flasher tool for Windows PCs are available in directory **/bin**. On Windows you can use **"flash.bat"**, it will ask you which COM port that ESP is connected and then flashes it. You can use any flashing tool and do the flashing manually. The flashing process itself has been described at numerous places on Internet.
Download compiled binaries from GitHub Releases page
https://github.com/omersiar/esp-rfid/releases
On Windows you can use **"flash.bat"**, it will ask you which COM port that ESP is connected and then flashes it. You can use any flashing tool and do the flashing manually. The flashing process itself has been described at numerous places on Internet.

#### Building With PlatformIO
##### Backend
The build enviroment is based on [PlatformIO](http:https://platformio.org). Follow the instructions found here: http:https://platformio.org/#!/get-started for installing it but skip the ```platform init``` step as this has already been done, modified and it is included in this repository. In summary:

```
Expand All @@ -57,14 +62,24 @@ platformio run

When you run ```platformio run``` for the first time, it will download the toolchains and all necessary libraries automatically.

#### Useful commands:
##### Useful commands:

* ```platformio run``` - process/build all targets
* ```platformio run -e nodemcu -t upload``` - process/build and flash just the ESP12e target (the NodeMcu v2)
* ```platformio run -e generic -t upload``` - process/build and flash just the ESP12e target (the NodeMcu v2)
* ```platformio run -t clean``` - clean project (remove compiled files)

The resulting (built) image(s) can be found in the directory ```/bin``` created during the build process.

##### Frontend
You can not simply edit Web UI files because you will need to convert them to C arrays, which can be done automaticaly by a gulp script that can be found in tools directory.

If you want to edit esp-rfid's Web UI you will need:
* NodeJS
* npm (comes with NodeJS installer)
* Gulp (can be installed with npm)

Gulp script also minifies HTML and JS files and compresses (gzip) them.

### Pin Layout

The following table shows the typical pin layout used for connecting MFRC522 hardware to ESP:
Expand Down
Binary file added demo/board.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 3 additions & 7 deletions platformio.ini
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
env_default = generic

[common]
platform = https://github.com/platformio/platform-espressif8266.git#feature/stage
platform = https://github.com/platformio/platform-espressif8266.git
lib_deps =
ArduinoJson
ESPAsyncTCP
Expand All @@ -15,20 +15,17 @@ lib_deps =

; boards which GPIO0 and RESET controlled using two NPN transistors as nodemcu devkit (includes wemos d1 mini)
[env:generic]
lib_ldf_mode = deep+
board_build.f_cpu = 160000000L
platform = ${common.platform}
framework = arduino
board = esp12e
upload_resetmethod = nodemcu
lib_deps = ${common.lib_deps}
build_flags = -Wl,-Teagle.flash.4m2m.ld
extra_scripts = scripts/GENdeploy.py
build_flags = -Wl,-Teagle.flash.4m.ld
upload_speed = 921600
monitor_speed = 115200

[env:relayboard]
lib_ldf_mode = deep+
board_build.f_cpu = 160000000L
platform = ${common.platform}
framework = arduino
Expand All @@ -42,12 +39,11 @@ monitor_speed = 115200

; for Travis CI deployment
[env:deploy]
lib_ldf_mode = deep+
board_build.f_cpu = 160000000L
platform = ${common.platform}
framework = arduino
board = esp12e
lib_deps = ${common.lib_deps}
extra_scripts = scripts/GENdeploy.py
build_flags = -Wl,-Teagle.flash.4m2m.ld
build_flags = -Wl,-Teagle.flash.4m.ld
src_build_flags = !echo "-DBUILD_TAG="$TRAVIS_TAG

0 comments on commit c7e69dd

Please sign in to comment.