added example, moved the useful sketches to the examples folder

Author: samuelvdv

useful/pozyx_UWB_configurator/pozyx_UWB_configurator.ino renamed to examples/useful/pozyx_UWB_configurator/pozyx_UWB_configurator.ino

@@ -0,0 +1,80 @@
+/**
+ * This sketch assumes that the tag is doing positioning through a master tag (or through the cloud app)
+ * This sketch will check on the pozyx device if a new position is available.
+ * The sketch itself does not initiate the positioning, it is assumed that this is iniated by another tag through remote positioning. 
+ * When a tag is being remotely positioned, it is only possible to perform read operations, any other operations
+ * may result in problems positioning.
+ *
+ * Note that in order to use this sketch, it is necessary to enable the CR (carriage return) in the Serial Monitor
+ *
+ * Author, Laurent Van Acker, Pozyx Labs
+ *
+ */
+
+#include <Pozyx.h>
+#include <Pozyx_definitions.h>
+#include <Wire.h>
+
+void setup(){
+  Serial.begin(115200);
+  if(Pozyx.begin() == POZYX_FAILURE){
+    Serial.println(F("ERROR: Unable to connect to POZYX shield"));
+    Serial.println(F("Reset required"));
+    delay(100);
+    abort();
+  }
+}
+
+void loop(){
+  coordinates_t position;
+  int status = checkLocalNewPosition(&position);
+  if (status == POZYX_SUCCESS){
+    // prints out the result
+    printCoordinates(position);
+  }else{
+    // prints out the error code
+    printErrorCode("positioning");
+  }
+}
+
+int checkLocalNewPosition(coordinates_t *position)
+{
+  assert(position != NULL);
+  int status;
+  uint8_t int_status = 0;
+  // now wait for the positioning to finish or generate an error
+  if (Pozyx.waitForFlag_safe(POZYX_INT_STATUS_POS | POZYX_INT_STATUS_ERR, 2*POZYX_DELAY_INTERRUPT, &int_status)){
+    if((int_status & POZYX_INT_STATUS_ERR) == POZYX_INT_STATUS_ERR)
+    {
+      // An error occured during positioning.
+      // Please read out the register POZYX_ERRORCODE to obtain more information about the error
+      return POZYX_FAILURE;
+    }else{
+      status = Pozyx.getCoordinates(position);
+      return status;
+    }
+  }else{
+    return POZYX_TIMEOUT;
+  }
+}
+
+// prints the coordinates for either humans or for processing
+void printCoordinates(coordinates_t coor){
+  Serial.print("POS");
+  Serial.print(", x(mm): ");
+  Serial.print(coor.x);
+  Serial.print(", y(mm): ");
+  Serial.print(coor.y);
+  Serial.print(", z(mm): ");
+  Serial.println(coor.z);
+}
+
+// error printing function for debugging
+void printErrorCode(String operation){
+  uint8_t error_code;
+  Pozyx.getErrorCode(&error_code);
+  Serial.print("ERROR ");
+  Serial.print(operation);
+  Serial.print(", local error code: 0x");
+  Serial.println(error_code, HEX);
+}

useful/pozyx_anchor_configurator/pozyx_anchor_configurator.ino renamed to examples/useful/pozyx_anchor_configurator/pozyx_anchor_configurator.ino

@@ -160,4 +160,4 @@ bool listHasDevice(uint16_t* deviceList, int list_size, uint16_t device) {
     i++;
   }
   return hasDevice;
-}
+}