aotrautils 0.0.1056 → 0.0.1058

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (12/10/2024-21:06:16)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (12/10/2024-22:19:16)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -5259,7 +5259,7 @@ AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (12/10/2024-21:06:16)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (12/10/2024-22:19:16)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -12624,6 +12624,154 @@ window.createOritaMainClient=function(
 
 
 
+
+
+// SEE http://codefoster.com/pi-basicgpio/
+
+const GPIO_BASE_PATH = "/sys/class/gpio";
+window.gpioUtils = {
+	open: (gpioNumber, mode, doOnSuccess = null) => {
+
+		if (!isNumber(gpioNumber) || !contains(["in", "out"], mode)) {
+			// TRACE
+			lognow("ERROR : Invalid parameters : " + gpioNumber + " ; " + mode + ". Aborting.");
+			return;
+		}
+
+		const gpioFilePath = GPIO_BASE_PATH + "/gpio" + gpioNumber;
+		const setDirection = () => {
+			fs.writeFile(gpioFilePath + "/direction", mode + "", (error) => {
+				if (error) {
+					// TRACE
+					lognow("ERROR : Could not set mode «" + mode + "» on pin «" + gpioNumber + "». Abording setup.", error);
+					return;
+				}
+				if (doOnSuccess) doOnSuccess();
+			});
+		};
+		fs.access(gpioFilePath, fs.constants.F_OK, (error) => {
+			if (error) {
+				// Case export file does not exists 
+				// In this case we export the gpio pin :
+				fs.writeFile(GPIO_BASE_PATH + "/export", gpioNumber + "", (error) => {
+					if (error) {
+						// TRACE
+						lognow("ERROR : Could not export pin «" + gpioNumber + "». Abording setup.", error);
+						return;
+					}
+					setDirection(gpioNumber, mode, doOnSuccess);
+				});
+				return;
+			}
+			// Case export file already exists 
+			setDirection(gpioNumber, mode, doOnSuccess);
+		});
+	},
+
+	close: (gpioNumber, doOnSuccess = null) => {
+		if (!isNumber(gpioNumber)) {
+			// TRACE
+			lognow("ERROR : Invalid parameter : " + gpioNumber + ". Aborting.");
+			return;
+		}
+
+		const gpioFilePath = GPIO_BASE_PATH + "/gpio" + gpioNumber;
+		fs.access(gpioFilePath, fs.constants.F_OK, (error) => {
+			if (error) {
+				// Case export file does not exists
+				// TRACE
+				lognow("ERROR : Export file does not exist, could not unexport pin «" + gpioNumber + "».", error);
+				return;
+			}
+			// Case export file already exists 
+			// In this case we export the gpio pin :
+			fs.writeFile(GPIO_BASE_PATH + "/unexport", gpioNumber + "", (error) => {
+				if (error) {
+					// TRACE
+					lognow("ERROR : Could not unexport pin «" + gpioNumber + "».", error);
+					return;
+				}
+				if (doOnSuccess) doOnSuccess();
+			});
+		});
+	},
+
+	write: (gpioNumber, stateNumber, doOnSuccess = null) => {
+
+		if (!isNumber(gpioNumber) || !contains([0, 1], stateNumber)) {
+			// TRACE
+			lognow("ERROR : Invalid parameter : " + gpioNumber + " ; " + stateNumber + ". Aborting.");
+			return;
+		}
+
+
+		const gpioFilePath = GPIO_BASE_PATH + "/gpio" + gpioNumber;
+		fs.access(gpioFilePath, fs.constants.F_OK, (error) => {
+			if (error) {
+				// Case export file does not exists
+				// TRACE
+				lognow("ERROR : Export file does not exist, cannot write «" + stateNumber + "» on pin «" + gpioNumber + "».", error);
+				return;
+			}
+
+			// DBG
+			lognow("Attempting to write " + stateNumber + " on pin BCM " + gpioNumber);
+
+			// Case export file already exists 
+			// In this case we export the gpio pin :
+			fs.writeFile(gpioFilePath + "/value", stateNumber + "", (error) => {
+				if (error) {
+					// TRACE
+					lognow("ERROR : Could not write «" + stateNumber + "» on pin «" + gpioNumber + "».", error);
+					return;
+				}
+				if (doOnSuccess) doOnSuccess();
+			});
+		});
+	},
+
+	read: (gpioNumber, doOnSuccess) => {
+
+		if (!isNumber(gpioNumber)) {
+			// TRACE
+			lognow("ERROR : Invalid parameter : " + gpioNumber + ". Aborting.");
+			return;
+		}
+
+		const gpioFilePath = GPIO_BASE_PATH + "/gpio" + gpioNumber;
+		fs.access(gpioFilePath, fs.constants.F_OK, (error) => {
+			if (error) {
+				// Case export file does not exists
+				// TRACE
+				lognow("ERROR : Export file does not exist, cannot read value of pin «" + gpioNumber + "».", error);
+				return;
+			}
+
+			// Case export file already exists 
+			// In this case we export the gpio pin :
+			fs.readFile(gpioFilePath + "/value", "utf-8", (error, data) => {
+
+				//				// DBG
+				//				lognow("DEBUG : read value:"+data);
+
+				if (error) {
+					// TRACE
+					lognow("ERROR : Could not write «" + stateNumber + "» on pin «" + gpioNumber + "».", error);
+					return;
+				}
+				const value = (data + "").trim() || "0";
+				doOnSuccess((value == "1"));
+			});
+		});
+	},
+
+};
+
+
+
+
+
+
 	// const REFRESHING_RATE_MILLIS_AUDIO:100,
 
 
@@ -13478,7 +13626,7 @@ createOritaMicroClient=function(url, port, isNode=false, staticMicroClientIdPara
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (12/10/2024-21:06:16)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (12/10/2024-22:19:16)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14717,7 +14865,7 @@ function rayVsUnitSphereClosestPoint(p, r) {
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
 
 AOTRAUTILS_GEOMETRY_LIB_IS_LOADED=true;
-/*utils AI library associated with aotra version : «1_29072022-2359 (12/10/2024-21:06:16)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (12/10/2024-22:19:16)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14861,7 +15009,7 @@ getOpenAIAPIClient=(modelName, apiURL, agentRole, defaultPrompt)=>{
 
 
 
-/*utils SERVER library associated with aotra version : «1_29072022-2359 (12/10/2024-21:06:16)»*/
+/*utils SERVER library associated with aotra version : «1_29072022-2359 (12/10/2024-22:19:16)»*/
 /*-----------------------------------------------------------------------------*/
 
 

aotrautils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.1056",
+	"version": "0.0.1058",
 	"main": "aotrautils.build.js",
 	"description": "A library for vanilla javascript utils (client-side) used in aotra javascript CMS",
 	"author": "Jeremie Ratomposon <info@alqemia.com> (https://alqemia.com)",