/MakerClock_ESP32

Is a standalone Branch of the FHNW Maker Clock - Arduino Software (https://github.com/FHNW-MakerStudio/MakerClockSoftware). The main difference is that it uses 2 Boards to drive the Clock and give it more capabilities.

Primary LanguageC++MIT LicenseMIT

Devlobsters Logo

MakerClock_ESP32

Is a standalone Branch of the FHNW Maker Clock - Arduino Software. The main difference is that it uses 2 Boards to drive the Clock and give it more capabilities.

Boards used in this project:

  • Arduino Nano with Uno Bootloader (Atmega Bootloaders for Nano will work too)
  • Adafruit Espressif ESP32

Dependencies:

  • Libraries:
    • RTCLib by Adafruit
    • Adafruit NeoPixel by Adafruit
    • Encoder by Paul Stoffregen
    • OneButton by Matthias Hertel

Contents

Installation:

1.1 Arduino IDE

Arduino

Please refer to Installation in FHNW Maker Clock - Arduino Software for the regular Arduino IDE.

The instructions are in German but have complementary images to it. If you feel that you need to read the instructions, you can simply translate it. I recommend using DeepL as translator. It is better as Google translator because it uses deep learning for contextual translation.

After installation you must install Adafruit Espressif ESP32 board described here: Adafruit HUZZAH32 - ESP32 Feather Guide After all that you are set for testing the IDE

1.2 PlatformIO

PlatformIO

PlatformIO is an open source ecosystem for IoT development and a free Arduino IDE alternative. It supports +600 embedded boards and is Cross-platform IDE. For more Information please visit platformio.org

Installation instructions:

  1. Visit platformio.org/platformio-ide
  2. Choose your prefferd Editor: Atom or VSCode
  3. Go throw the install steps of the Editor of your choice and install PlatformIO
  4. After PltformIO has been successfully installed on your Editor, go to Libraries tab of it and search and install all dependencies:
    1. VSCode: navigate to PlatformIO symbol on the left panel > in quick access just beside left panel Libraries
    2. Atom: navigate to home button top on the left panel > Libraries in the opened tab

VSCode_Atom

  1. You are all set for testing the IDE

Test your IDE Installation

Arduino:

  1. Open the Arduino file ArduinoMakerClock60.ino in the folder MakerClock_Arduino
  2. Set your target board (either Nano or Uno) and processor

arduino_settings

  1. Click the verify button top left

Button Verify

  1. The terminal at the bottom should indicate that it compiled the code successfully after a few seconds.
  2. You are ready to get started!

PatformIO:

  1. On the home screen click Open Project

PlatformIO_home

  1. Navigate to the folder where you have cloned or downloaded and unpacked this project and select the folder Example_MackerClock_Nano.
  2. In the IDEs explorer open main.cpp under the src folder.
  3. Build the project:
VSCode Atom
VSCode build Atom build
  1. The terminal at the bottom should indicate that it compiled the code successfully after a few seconds.
  2. You are ready to get started!

Connecting to your Board

For the Arduino IDE please refer to the section Programming of MakerStudio/MakerClockSoftware.

PlatformIO automatically detects your board and sets the correct COM Ports when you press upload.

Note there are different types of build, clean and upload!

VSCode:

VSCode_Multi

Atom:

Atom_Target_options Atom_Target_build

Troubleshooting

This is a list of most common mistakes that could happen while preparing your IDE.

Problem Possible solution
The code doesn't compile/has errors Check the error, most of the times it is because a dependency is missing like a library. After installing the missing component it is recommended to restart the IDE that it can load all
Wrong COM port selected check your comport setting in the Arduino IDE under tools
Missing drivers Open Device Manager and update drivers
Wrong Arduino selected Depending on which Bootloader your board is running on, choose the right one. Arduino Nano has 3 different ones, just try one after each other
USB problem on Mac OS X sometimes a USB hub between the Mac and Arduino can help

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments