Added Provisioning Library Module.

Features include :
- Search for available BLE devices.
- Scan device QR code to provide reference to ESP device.
- Create reference of ESPDevice manually.
- Data Encryption
- Data transmission through BLE and SoftAP.
- Scan for available Wi-Fi networks.
- Provisioning API.
- Support for exchanging custom data.

Author: KhushbuShah25

build.gradle

@@ -7,8 +7,7 @@ buildscript {
         jcenter()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.6.1'
-        classpath 'com.google.protobuf:protobuf-gradle-plugin:0.8.9'
+        classpath 'com.android.tools.build:gradle:3.6.3'
 
         // NOTE: Do not place your application dependencies here; they belong
         // in the individual module build.gradle files

provision/.gitignore

@@ -0,0 +1 @@
+/build

provision/build.gradle

@@ -0,0 +1,77 @@
+apply plugin: 'com.android.library'
+apply plugin: 'com.google.protobuf'
+
+buildscript {
+    repositories {
+        jcenter()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.google.protobuf:protobuf-gradle-plugin:0.8.9'
+    }
+}
+
+allprojects {
+    repositories {
+        jcenter()
+        mavenCentral()
+    }
+}
+
+android {
+    compileSdkVersion 29
+    buildToolsVersion "29.0.1"
+
+    defaultConfig {
+        minSdkVersion 24
+        targetSdkVersion 29
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles 'consumer-rules.pro'
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+protobuf {
+    protoc {
+        artifact = 'com.google.protobuf:protoc:3.5.1'
+    }
+    plugins {
+        javalite {
+            artifact = 'com.google.protobuf:protoc-gen-javalite:3.0.0'
+        }
+    }
+    generateProtoTasks {
+        all().each { task ->
+            task.builtins {
+                remove java
+            }
+            task.plugins {
+                javalite {}
+            }
+        }
+    }
+}
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+
+    implementation 'androidx.appcompat:appcompat:1.1.0'
+    implementation 'org.greenrobot:eventbus:3.1.1'
+    implementation 'com.google.protobuf:protobuf-lite:3.0.1'
+    implementation 'com.google.crypto.tink:tink-android:1.1.0'
+    implementation 'com.google.android.gms:play-services-vision:20.0.0'
+    implementation 'androidx.preference:preference:1.1.1'
+
+    testImplementation 'junit:junit:4.12'
+    androidTestImplementation 'androidx.test.ext:junit:1.1.1'
+    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
+}

provision/consumer-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

provision/proguard-rules.pro

@@ -0,0 +1,27 @@
+package com.espressif.provision;
+
+import android.content.Context;
+
+import androidx.test.platform.app.InstrumentationRegistry;
+import androidx.test.ext.junit.runners.AndroidJUnit4;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+import static org.junit.Assert.*;
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ */
+@RunWith(AndroidJUnit4.class)
+public class ExampleInstrumentedTest {
+    @Test
+    public void useAppContext() {
+        // Context of the app under test.
+        Context appContext = InstrumentationRegistry.getInstrumentation().getTargetContext();
+
+        assertEquals("com.espressif.provision.test", appContext.getPackageName());
+    }
+}

provision/src/androidTest/java/com/espressif/provision/ExampleInstrumentedTest.java

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.espressif.provision" />

provision/src/main/AndroidManifest.xml

@@ -0,0 +1,42 @@
+// Copyright 2020 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package com.espressif.provision;
+
+import android.os.Bundle;
+
+/**
+ * Event class to send device connection / disconnection events to app.
+ */
+public class DeviceConnectionEvent {
+
+    private short eventType;
+    private Bundle data;
+
+    public DeviceConnectionEvent(short type) {
+        eventType = type;
+    }
+
+    public short getEventType() {
+        return eventType;
+    }
+
+    public Bundle getData() {
+        return data;
+    }
+
+    public void setData(Bundle data) {
+        this.data = data;
+    }
+}

provision/src/main/java/com/espressif/provision/DeviceConnectionEvent.java

@@ -0,0 +1,59 @@
+// Copyright 2020 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package com.espressif.provision;
+
+/**
+ * This class has constants and enums used in library.
+ */
+public class ESPConstants {
+
+    public static final String DEFAULT_WIFI_BASE_URL = "192.168.4.1:80";
+
+    public enum TransportType {
+        TRANSPORT_BLE,
+        TRANSPORT_SOFTAP
+    }
+
+    public enum SecurityType {
+        SECURITY_0,
+        SECURITY_1
+    }
+
+    public enum ProvisionFailureReason {
+        AUTH_FAILED,
+        NETWORK_NOT_FOUND,
+        DEVICE_DISCONNECTED,
+        UNKNOWN
+    }
+
+    // End point names
+    public static final String HANDLER_PROV_SCAN = "prov-scan";
+    public static final String HANDLER_PROTO_VER = "proto-ver";
+    public static final String HANDLER_PROV_SESSION = "prov-session";
+    public static final String HANDLER_PROV_CONFIG = "prov-config";
+
+    // Event types
+    public static final short EVENT_DEVICE_CONNECTED = 1;
+    public static final short EVENT_DEVICE_CONNECTION_FAILED = 2;
+    public static final short EVENT_DEVICE_DISCONNECTED = 3;
+
+    // Constants for WiFi Security values (As per proto files)
+    public static final short WIFI_OPEN = 0;
+    public static final short WIFI_WEP = 1;
+    public static final short WIFI_WPA_PSK = 2;
+    public static final short WIFI_WPA2_PSK = 3;
+    public static final short WIFI_WPA_WPA2_PSK = 4;
+    public static final short WIFI_WPA2_ENTERPRISE = 5;
+}