v1.4.0

- restructure library
- add platformio configuration for testing
- set default MTU to 517
- add QR links
- add hourly forecast data
- add remote touch

Author: fbiego

.gitignore

@@ -1,2 +1,6 @@
 
 *.py
+.pio
+.vscode
+
+navigation.txt

README.md

@@ -12,6 +12,7 @@ Setup your ESP32 as a smartwatch and connect to Chronos app over BLE.
 - [x] Notifications
 - [x] Weather
 - [x] Controls (Music, Find Phone, Camera)
+- [x] Phone Battery (Level, Charging state) (Chronos app v3.5.1+)
 - [ ] Alarms
 
 ## Companion App
@@ -39,14 +40,15 @@ bool isCameraReady();
 
 // notifications
 int getNotificationCount();
-Notification getNotificationAt(int index);
+Notification getNotificationAt(int index); // index [0-9]
 void clearNotifications();
 
 // weather
 int getWeatherCount();
 String getWeatherCity();
 String getWeatherTime();
-Weather getWeatherAt(int index);
+Weather getWeatherAt(int index); // index[0-6]
+HourlyForecast getForecastHour(int hour); // hour [0-23]
 
 // alarms
 Alarm getAlarm(int index);
@@ -68,6 +70,9 @@ uint8_t getPhoneBattery();
 int getAppCode();
 String getAppVersion();
 
+RemoteTouch getTouch(); // RemoteTouch(bool state, uint32_t x, uint32_t y)
+String getQrAt(int index); // index [0-8]
+
 // helper functions for ESP32Time
 int getHourC(); // return hour based on hour 24 variable
 String getHourZ(); // return zero padded hour string based on hour 24 variable
@@ -81,6 +86,10 @@ void setDataCallback(void (*callback)(uint8_t *, int));
 void setRawDataCallback(void (*callback)(uint8_t *, int));
 ```
 
+## PlatformIO
+
+Open the project folder in VS Code with PlatformIO installed to directly run the example sketches. This makes it easier to develop and test features
+
 ## Dependencies
 - [`ESP32Time`](https://github.com/fbiego/ESP32Time)
 - [`NimBLE-Arduino`](https://github.com/h2zero/NimBLE-Arduino)

examples/watch/watch.ino

@@ -212,7 +212,7 @@ void configCallback(Config config, uint32_t a, uint32_t b)
   case CF_PBAT:
     // state is saved internally
     Serial.print("Phone battery: ");
-    Serial.println(a == 1 ? "Charging" : "Not Charing"); // bool state = watch.isPhoneCharging();
+    Serial.println(a == 1 ? "Charging" : "Not Charging"); // bool state = watch.isPhoneCharging();
     Serial.print("Level: ");
     Serial.print(b); // uint8_t level = watch.getPhoneBattery();
     Serial.println("%");
@@ -224,6 +224,20 @@ void configCallback(Config config, uint32_t a, uint32_t b)
     Serial.print(" Version: ");
     Serial.println(watch.getAppVersion());
     break;
+  case CF_QR:
+    // qr links
+    if (a == 0){
+      // individual qr links (b is the index)
+      Serial.print("QR code: ");
+      Serial.println(watch.getQrAt(b));
+    }
+    if (a == 1)
+    {
+      // end of qr links transmission
+      Serial.print("QR Links received. Count: ");
+      Serial.println(b);
+    }
+    break;
   case CF_WEATHER:
     // weather is saved
     Serial.println("Weather received");
@@ -292,6 +306,7 @@ void setup()
   watch.setDataCallback(dataCallback);
 
   watch.begin(); // initializes the BLE
+  // make sure the ESP32 is not paired with your phone in the bluetooth settings
   // go to Chronos app > Watches tab > Watches button > Pair New Devices > Search > Select your board
   // you only need to do it once. To disconnect, click on the rotating icon (Top Right)
 

keywords.txt

@@ -31,13 +31,18 @@ capturePhoto	KEYWORD2
 setNotifyBattery	KEYWORD2
 isPhoneCharging	KEYWORD2
 getPhoneBattery	KEYWORD2
+getForecastHour	KEYWORD2
+getTouch	KEYWORD2
+getQrAt	KEYWORD2
 
 Notification	LITERAL1
 Alarm	LITERAL1
 Weather	LITERAL1
 ChronosTimer	LITERAL1
 ChronosData	LITERAL1
 ChronosScreen	LITERAL1
+RemoteTouch	LITERAL1
+HourlyForecast	LITERAL1
 
 MUSIC_PLAY	LITERAL1
 MUSIC_PAUSE	LITERAL1
@@ -67,6 +72,7 @@ CF_WEATHER	LITERAL1
 CF_CAMERA	LITERAL1
 CF_PBAT	LITERAL1
 CF_APP	LITERAL1
+CF_QR	LITERAL1
 
 CS_0x0_000_CFF	LITERAL1
 CS_240x240_130_STF	LITERAL1

library.json

@@ -1,6 +1,6 @@
 {
   "name": "ChronosESP32",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "keywords": "Arduino, ESP32, Time, BLE, Watch",
   "description": "A library for ESP32 to interface with Chronos app over BLE",
   "repository":

library.properties

@@ -1,5 +1,5 @@
 name=ChronosESP32
-version=1.3.0
+version=1.4.0
 author=fbiego
 maintainer=fbiego
 sentence=Setup your ESP32 as a smartwatch and connect to Chronos app over BLE.

platformio.ini

@@ -0,0 +1,37 @@
+; 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
+
+[platformio]
+default_envs = esp32dev
+
+; Uncomment only one to test
+src_dir = examples/watch
+; src_dir = examples/camera
+; src_dir = examples/control
+
+
+[env]
+platform = espressif32
+framework = arduino
+
+lib_deps = 
+	; use src folder as library
+	file://./src
+	; external library dependencies
+	fbiego/ESP32Time@^2.0.6
+	h2zero/NimBLE-Arduino@^1.4.1
+
+[env:esp32dev]
+board = esp32dev
+
+[env:devkit]
+board = esp32doit-devkit-v1
+
+

ChronosESP32.cpp renamed to src/ChronosESP32.cpp

@@ -43,6 +43,8 @@ ChronosESP32::ChronosESP32()
 {
 	connected = false;
 	cameraReady = false;
+	batteryChanged = true;
+	qrLinks[0] = "https://chronos.ke/";
 }
 
 /*!
@@ -64,6 +66,7 @@ void ChronosESP32::begin()
 {
 	BLEDevice::init(watchName.c_str());
 	BLEServer *pServer = BLEDevice::createServer();
+	BLEDevice::setMTU(517);
 	pServer->setCallbacks(this);
 
 	BLEService *pService = pServer->createService(SERVICE_UUID);
@@ -269,6 +272,16 @@ Weather ChronosESP32::getWeatherAt(int index)
 	return weather[index % WEATHER_SIZE];
 }
 
+/*!
+	@brief  return the weatherforecast for the hour
+	@param  hour
+			position of the weather to be returned
+*/
+HourlyForecast ChronosESP32::getForecastHour(int hour)
+{
+	return hourlyForecast[hour % FORECAST_SIZE];
+}
+
 /*!
 	@brief  get the alarm at the index
 	@param	index
@@ -398,6 +411,25 @@ String ChronosESP32::getAmPmC(bool caps)
 	return "";
 }
 
+
+/*!
+	@brief  get remote touch data
+*/
+RemoteTouch ChronosESP32::getTouch()
+{
+	return touch;
+}
+
+/*!
+	@brief  get the qr link at the index
+	@param	index
+			position of the qr link to be returned
+*/
+String ChronosESP32::getQrAt(int index)
+{
+	return qrLinks[index % QR_SIZE];
+}
+
 /*!
 	@brief  set the connection callback
 */
@@ -451,7 +483,7 @@ void ChronosESP32::setRawDataCallback(void (*callback)(uint8_t *, int))
 */
 void ChronosESP32::sendInfo()
 {
-	uint8_t infoCmd[] = {0xab, 0x00, 0x11, 0xff, 0x92, 0xc0, 0x01, 0x00, 0x00, 0xfb, 0x1e, 0x40, 0xc0, 0x0e, 0x32, 0x28, 0x00, 0xe2, screenConf, 0x80};
+	uint8_t infoCmd[] = {0xab, 0x00, 0x11, 0xff, 0x92, 0xc0, LIB_VER_MAJOR, (LIB_VER_MINOR * 10 + LIB_VER_PATCH), 0x00, 0xfb, 0x1e, 0x40, 0xc0, 0x0e, 0x32, 0x28, 0x00, 0xe2, screenConf, 0x80};
 	sendCommand(infoCmd, 20);
 }
 
@@ -590,6 +622,7 @@ void ChronosESP32::onDisconnect(BLEServer *pServer)
 	connected = false;
 	cameraReady = false;
 	BLEDevice::startAdvertising();
+	touch.state = false; // release touch
 	if (connectionChangeCallback != nullptr)
 	{
 		connectionChangeCallback(false);
@@ -927,6 +960,40 @@ void ChronosESP32::dataReceived()
 				configurationReceivedCallback(CF_FONT, color, select);
 			}
 			break;
+		case 0xA8:
+			if (incomingData.data[3] == 0xFE)
+			{
+				// end of qr data
+				int size = incomingData.data[5]; // number of links received
+				if (configurationReceivedCallback != nullptr)
+				{
+					configurationReceivedCallback(CF_QR, 1, size);
+				}
+			}
+			if (incomingData.data[3] == 0xFF)
+			{
+				// receiving qr data
+				int index = incomingData.data[5]; // index of the curent link
+				qrLinks[index] = ""; // clear existing
+				for (int i = 6; i < len; i++)
+				{
+					qrLinks[index] += (char)incomingData.data[i];
+				}
+				if (configurationReceivedCallback != nullptr)
+				{
+					configurationReceivedCallback(CF_QR, 0, index);
+				}
+				
+			}
+			break;
+		case 0xBF:
+			if (incomingData.data[3] == 0xFE)
+			{
+				touch.state = incomingData.data[5] == 1;
+				touch.x = uint32_t(incomingData.data[6] << 8) | uint32_t(incomingData.data[7]);
+				touch.y = uint32_t(incomingData.data[8] << 8) | uint32_t(incomingData.data[9]);
+			}
+			break;
 		case 0xCA:
 			if (incomingData.data[3] == 0xFE)
 			{
@@ -942,22 +1009,66 @@ void ChronosESP32::dataReceived()
 				}
 			}
 			break;
+		case 0xEE:
+			if (incomingData.data[3] == 0xFE)
+			{
+				//nvIc
+			}
+			break;
+		case 0xEF:
+			if (incomingData.data[3] == 0xFE)
+			{
+				//nvData
+			}
+			break;
 		}
 	}
 	else if (incomingData.data[0] == 0xEA)
 	{
-		if (incomingData.data[4] == 0x7E && incomingData.data[5] == 0x01)
+		if (incomingData.data[4] == 0x7E)
 		{
-			String city = "";
-			for (int c = 7; c < len; c++)
+			switch (incomingData.data[5])
 			{
-				city += (char)incomingData.data[c];
+			case 0x01:
+			{
+				String city = "";
+				for (int c = 7; c < len; c++)
+				{
+					city += (char)incomingData.data[c];
+				}
+				weatherCity = city;
+				if (configurationReceivedCallback != nullptr)
+				{
+					configurationReceivedCallback(CF_WEATHER, 0, 1);
+				}
 			}
-			weatherCity = city;
-			if (configurationReceivedCallback != nullptr)
+			break;
+			case 0x02:
 			{
-				configurationReceivedCallback(CF_WEATHER, 0, 1);
+				int size = incomingData.data[6];
+				int hour = incomingData.data[7];
+				for (int z = 0; z < size; z++)
+				{
+					if (hour + z >= FORECAST_SIZE)
+					{
+						break;
+					}
+					int icon = incomingData.data[8 + (6 * z)] >> 4;
+					int sign = (incomingData.data[8 + (6 * z)] & 1) ? -1 : 1;
+					int temp = ((int)incomingData.data[9 + (6 * z)]) * sign;
+
+					hourlyForecast[hour + z].day = this->getDayofYear();
+					hourlyForecast[hour + z].hour = hour + z;
+					hourlyForecast[hour + z].wind = (incomingData.data[10 + (6 * z)] * 256) + incomingData.data[11 + (6 * z)];
+					hourlyForecast[hour + z].humidity = incomingData.data[12 + (6 * z)];
+					hourlyForecast[hour + z].uv = incomingData.data[13 + (6 * z)];
+					hourlyForecast[hour + z].icon = icon;
+					hourlyForecast[hour + z].temp = temp;
+				}
+			}
+			break;
 			}
 		}
 	}
-}
+}
+