rename folder to template project

Template Project/.gitignore

@@ -0,0 +1,5 @@
+.pio
+.vscode/.browse.c_cpp.db*
+.vscode/c_cpp_properties.json
+.vscode/launch.json
+.vscode/ipch

Template Project/.vscode/extensions.json

@@ -0,0 +1,10 @@
+{
+    // See http://go.microsoft.com/fwlink/?LinkId=827846
+    // for the documentation about the extensions.json format
+    "recommendations": [
+        "platformio.platformio-ide"
+    ],
+    "unwantedRecommendations": [
+        "ms-vscode.cpptools-extension-pack"
+    ]
+}

Template Project/.vscode/settings.json

@@ -0,0 +1,12 @@
+{
+    "files.associations": {
+        "array": "cpp",
+        "deque": "cpp",
+        "string": "cpp",
+        "unordered_map": "cpp",
+        "unordered_set": "cpp",
+        "vector": "cpp",
+        "string_view": "cpp",
+        "initializer_list": "cpp"
+    }
+}

Template Project/include/README

@@ -0,0 +1,39 @@
+
+This directory is intended for project header files.
+
+A header file is a file containing C declarations and macro definitions
+to be shared between several project source files. You request the use of a
+header file in your project source file (C, C++, etc) located in `src` folder
+by including it, with the C preprocessing directive `#include'.
+
+```src/main.c
+
+#include "header.h"
+
+int main (void)
+{
+ ...
+}
+```
+
+Including a header file produces the same results as copying the header file
+into each source file that needs it. Such copying would be time-consuming
+and error-prone. With a header file, the related declarations appear
+in only one place. If they need to be changed, they can be changed in one
+place, and programs that include the header file will automatically use the
+new version when next recompiled. The header file eliminates the labor of
+finding and changing all the copies as well as the risk that a failure to
+find one copy will result in inconsistencies within a program.
+
+In C, the usual convention is to give header files names that end with `.h'.
+It is most portable to use only letters, digits, dashes, and underscores in
+header file names, and at most one dot.
+
+Read more about using header files in official GCC documentation:
+
+* Include Syntax
+* Include Operation
+* Once-Only Headers
+* Computed Includes
+
+https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html

Template Project/lib/ESPMegaPRO/ESPMegaPRO.cpp

@@ -0,0 +1,72 @@
+#include <ESPMegaPRO.h>
+
+uint8_t inputBufferA;
+uint8_t inputBufferB;
+
+PCF8574 inputBankA(INPUT_BANK_A_ADDRESS);
+PCF8574 inputBankB(INPUT_BANK_B_ADDRESS);
+Adafruit_PWMServoDriver pwmBank = Adafruit_PWMServoDriver(0x5F);
+
+void ESPMega_begin()
+{
+    Wire.begin(14, 33);
+
+    inputBankA.begin();
+    inputBankB.begin();
+    pwmBank.begin();
+
+    #ifdef USE_INTERRUPT
+    attachInterrupt(digitalPinToInterrupt(INPUT_BANK_A_INTERRUPT),refreshInputBankA,FALLING);
+    attachInterrupt(digitalPinToInterrupt(INPUT_BANK_B_INTERRUPT),refreshInputBankB,FALLING);
+    #endif
+}
+
+void ESPMega_loop() {
+    
+}
+
+bool ESPMega_digitalRead(int id)
+{
+    if (id >= 0 && id <= 7)
+    {
+        #ifndef USE_INTERRUPT
+        refreshInputBankA(); //Only poll if interrupt is not enabled
+        #endif
+
+        return ((inputBufferA>>id)&1); //Extract bit from buffer
+    }
+    if (id >= 8 && id <= 15)
+    {
+        id-=8;
+
+        #ifndef USE_INTERRUPT
+        refreshInputBankB(); //Only poll if interrupt is not enabled
+        #endif
+
+        return ((inputBufferB>>id)&1); //Extract bit from buffer
+    }
+    return false;
+}
+
+void ESPMega_analogWrite(int id, int value)
+{
+    pwmBank.setPin(id, value);
+}
+
+void ESPMega_digitalWrite(int id, bool value)
+{
+    if(value)
+        pwmBank.setPin(id, 4095);
+    else
+        pwmBank.setPin(id, 0);
+}
+
+void IRAM_ATTR refreshInputBankA()
+{
+    inputBufferA = inputBankA.read8();
+}
+
+void IRAM_ATTR refreshInputBankB()
+{
+    inputBufferB = inputBankB.read8();
+}

Template Project/lib/ESPMegaPRO/ESPMegaPRO.h

@@ -0,0 +1,61 @@
+#ifndef ESPMEGA
+#define ESPMEGA
+
+#include <Arduino.h>
+#include <Wire.h>
+#include <Adafruit_PWMServoDriver.h>
+#include <PCF8574.h>
+
+#define INPUT_BANK_A_ADDRESS 0x20
+#define INPUT_BANK_B_ADDRESS 0x21
+#define OUTPUT_BANK_ADDRESS 0x21
+#define EEPROM_ADDRESS 0x22
+
+//#define USE_INTERRUPT
+//#define INPUT_BANK_A_INTERRUPT 35
+//#define INPUT_BANK_B_INTERRUPT 39
+
+/**
+ * Initiate ESPMega PRO Internal Components
+ * 
+ * This function will initiate the PWM bank, Input banks, and the EEPROM.
+*/
+void ESPMega_begin();
+
+/**
+ * Run ESPMega PRO Internal Routines
+ * 
+ * This function must be called regularly for the correct
+ * operation of the ESPMega!
+*/
+void ESPMega_loop();
+
+/**
+ * Read one of the ESPMega's Digital Input pins (I0-I15)
+ * 
+ * @param id The number of the pin to be read
+ * @return The state of the pin (HIGH/LOW)
+*/
+bool ESPMega_digitalRead(int id);
+
+/**
+ * Write a pulse wave modulated signal to one of the ESPMega's
+ * PWM pins (P0-P15)
+ * 
+ * @param id The number of the pin to write to
+ * @param value the "HIGH" duty cycle of the PWM wave (0-4095)
+*/
+void ESPMega_analogWrite(int id, int value);
+
+/**
+ * Write a digital signal to one of the ESPMega's
+ * PWM pins (P0-P15)
+ * 
+ * @param id The number of the pin to write to
+ * @param value the new state for the pin (HIGH/LOW)
+*/
+void ESPMega_digitalWrite(int id, bool value);
+void IRAM_ATTR refreshInputBankA();
+void IRAM_ATTR refreshInputBankB();
+
+#endif

Template Project/lib/README

@@ -0,0 +1,46 @@
+
+This directory is intended for project specific (private) libraries.
+PlatformIO will compile them to static libraries and link into executable file.
+
+The source code of each library should be placed in a an own separate directory
+("lib/your_library_name/[here are source files]").
+
+For example, see a structure of the following two libraries `Foo` and `Bar`:
+
+|--lib
+|  |
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |  |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html
+|  |
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |
+|  |- README --> THIS FILE
+|
+|- platformio.ini
+|--src
+   |- main.c
+
+and a contents of `src/main.c`:
+```
+#include <Foo.h>
+#include <Bar.h>
+
+int main (void)
+{
+  ...
+}
+
+```
+
+PlatformIO Library Dependency Finder will find automatically dependent
+libraries scanning project source files.
+
+More information about PlatformIO Library Dependency Finder
+- https://docs.platformio.org/page/librarymanager/ldf.html

Template Project/platformio.ini

@@ -0,0 +1,16 @@
+; PlatformIO Project Configuration File
+;
+;   Build options: build flags, source filter
+;   Upload options: custom upload port, speed and extra flags
+;   Library options: dependencies, extra library storages
+;   Advanced options: extra scripting
+;
+; Please visit documentation for the other options and examples
+; https://docs.platformio.org/page/projectconf.html
+
+[env:wt32-eth01]
+platform = espressif32
+board = wt32-eth01
+framework = arduino
+lib_deps = adafruit/Adafruit PWM Servo Driver Library@^2.4.1
+           robtillaart/PCF8574@^0.3.7

Template Project/src/i2c_scanner.cpp.disabled

@@ -0,0 +1,84 @@
+#include <Arduino.h>
+// --------------------------------------
+// i2c_scanner
+//
+// Version 1
+//    This program (or code that looks like it)
+//    can be found in many places.
+//    For example on the Arduino.cc forum.
+//    The original author is not know.
+// Version 2, Juni 2012, Using Arduino 1.0.1
+//     Adapted to be as simple as possible by Arduino.cc user Krodal
+// Version 3, Feb 26  2013
+//    V3 by louarnold
+// Version 4, March 3, 2013, Using Arduino 1.0.3
+//    by Arduino.cc user Krodal.
+//    Changes by louarnold removed.
+//    Scanning addresses changed from 0...127 to 1...119,
+//    according to the i2c scanner by Nick Gammon
+//    https://www.gammon.com.au/forum/?id=10896
+// Version 5, March 28, 2013
+//    As version 4, but address scans now to 127.
+//    A sensor seems to use address 120.
+// Version 6, November 27, 2015.
+//    Added waiting for the Leonardo serial communication.
+//
+//
+// This sketch tests the standard 7-bit addresses
+// Devices with higher bit address might not be seen properly.
+//
+ 
+#include <Wire.h>
+ 
+ 
+void setup()
+{
+  Wire.begin(14,33);
+ 
+  Serial.begin(9600);
+  while (!Serial);             // Leonardo: wait for serial monitor
+  Serial.println("\nI2C Scanner");
+}
+ 
+ 
+void loop()
+{
+  byte error, address;
+  int nDevices;
+ 
+  Serial.println("Scanning...");
+ 
+  nDevices = 0;
+  for(address = 1; address < 127; address++ )
+  {
+    // The i2c_scanner uses the return value of
+    // the Write.endTransmisstion to see if
+    // a device did acknowledge to the address.
+    Wire.beginTransmission(address);
+    error = Wire.endTransmission();
+ 
+    if (error == 0)
+    {
+      Serial.print("I2C device found at address 0x");
+      if (address<16)
+        Serial.print("0");
+      Serial.print(address,HEX);
+      Serial.println("  !");
+ 
+      nDevices++;
+    }
+    else if (error==4)
+    {
+      Serial.print("Unknown error at address 0x");
+      if (address<16)
+        Serial.print("0");
+      Serial.println(address,HEX);
+    }    
+  }
+  if (nDevices == 0)
+    Serial.println("No I2C devices found\n");
+  else
+    Serial.println("done\n");
+ 
+  delay(5000);           // wait 5 seconds for next scan
+}

Template Project/src/input_demo.cpp.disabled

@@ -0,0 +1,22 @@
+#include <Arduino.h>
+#include <PCF8574.h>
+
+PCF8574 inputbank1(0x21);
+
+void setup() {
+    Wire.begin(14,33);
+    Serial.begin(9600);
+    boolean connected = inputbank1.begin();
+    Serial.println("connection state = "+String(connected));
+    inputbank1.write(0, HIGH);
+    delay(50);
+    inputbank1.write(1, HIGH);
+    delay(50);
+}
+
+void loop() {
+    for(int i=2;i<8;i++) {
+        Serial.println(inputbank1.read(i));
+        delay(100);
+    }
+}

Template Project/src/main.cpp

@@ -0,0 +1,9 @@
+#include <ESPMegaPRO.h>
+
+void setup() {
+    ESPMega_begin();
+}
+
+void loop() {
+    ESPMega_loop();
+}

Template Project/src/pwm_demo.cpp.disabled

@@ -0,0 +1,28 @@
+#include <Arduino.h>
+#include "Wire.h"
+#include <Adafruit_PWMServoDriver.h>
+
+Adafruit_PWMServoDriver pwm = Adafruit_PWMServoDriver(0x5F);
+
+void setup() {
+  Wire.begin(14,33);
+  pwm.begin();
+  pwm.setPin(2, 500);
+  pwm.setPin(3, 1000);
+  pwm.setPin(4, 1500);
+  pwm.setPin(5, 2000);
+  pwm.setPin(6, 2500);
+  pwm.setPin(7, 3000);
+  pwm.setPin(8, 3500);
+  pwm.setPin(9, 4000);
+  pwm.setPin(10, 500);
+  pwm.setPin(11, 1000);
+  pwm.setPin(12, 1500);
+  pwm.setPin(13, 2000);
+  pwm.setPin(14, 2500);
+  pwm.setPin(15, 3000);
+
+}
+
+  void loop() {
+}

Template Project/test/README

@@ -0,0 +1,11 @@
+
+This directory is intended for PlatformIO Test Runner and project tests.
+
+Unit Testing is a software testing method by which individual units of
+source code, sets of one or more MCU program modules together with associated
+control data, usage procedures, and operating procedures, are tested to
+determine whether they are fit for use. Unit testing finds problems early
+in the development cycle.
+
+More information about PlatformIO Unit Testing:
+- https://docs.platformio.org/en/latest/advanced/unit-testing/index.html