Merge branch 'release/1.2.2'

Author: laurentva

.gitignore

@@ -1,4 +1,6 @@
-Doxyfile
-xml/
-html/
+# Doxyfile
+docs/doxygen_output/*
 *.gch
+docs/_build
+
+!docs/doxygen_output/xml

CONTRIBUTING.md

@@ -0,0 +1,13 @@
+# Contributing guide
+
+For now, this'll only be about documentation:
+
+## Generating documentation
+
+To generate the documentation, you'll need to install both Doxygen and Sphinx. 
+
+When these are installed, you can run the following in your favorite shell to build the documentation.
+
+* doxygen Doxyfile
+* cd docs
+* make html

Doxyfile

@@ -229,8 +229,8 @@ typedef struct __attribute__((packed))_device_range {
 }device_range_t;
 
 /**
-* Pozyx CLASS
-* -----------
+* Provides an interface to an attached Pozyx shield.
+* 
 */
 class PozyxClass
 {

Pozyx.h

@@ -1,4 +1,4 @@
-/**
+/*
   Pozyx_definitions.h - Library for Arduino Pozyx shield.
   Copyright (c) Pozyx Laboratories.  All right reserved.
 
@@ -28,7 +28,7 @@
 #define _POZYX_FORMAT_FOOT
 #define _POZYX_FORMAT_INCH
 
-// maximum number of anchors to be stored in the interal anchor list on the pozyx device
+/* Maximum number of anchors to be stored in the interal anchor list on the pozyx device */
 #define MAX_ANCHORS_IN_LIST          20
 
 #define POZYX_I2C_ADDRESS        0x4B
@@ -216,6 +216,8 @@
 #define POZYX_DELAY_REMOTE_WRITE    5
 #define POZYX_DELAY_REMOTE_FUNCTION 10
 #define POZYX_DELAY_INTERRUPT       100
+#define POZYX_DELAY_POSITIONING     1000
+#define POZYX_DELAY_REMOTE_POSITIONING     1000
 #define POZYX_DELAY_CALIBRATION     1000
 #define POZYX_FAILURE               0x0
 #define POZYX_SUCCESS               0x1
@@ -259,6 +261,8 @@
 
 // Division factors for converting the raw register values to meaningful physical quantities
 #define POZYX_POS_DIV_MM               1.0f
+#define POZYX_PRESS_DIVPOSITIONING     1000
+#define POZYX_PRESS_DIVREMOTE_POSITIONING     1000
 #define POZYX_PRESS_DIV_PA             1000.0f
 #define POZYX_ACCEL_DIV_MG             1.0f
 #define POZYX_GYRO_DIV_DPS             16.0f

Pozyx_definitions.h

@@ -805,7 +805,7 @@ int PozyxClass::doPositioning(coordinates_t *position, uint8_t dimension, int32_
     return POZYX_FAILURE;
 
   // now wait for the positioning to finish or generate an error
-  if (waitForFlag_safe(POZYX_INT_STATUS_POS | POZYX_INT_STATUS_ERR, 2*POZYX_DELAY_INTERRUPT, &int_status)){
+  if (waitForFlag_safe(POZYX_INT_STATUS_POS | POZYX_INT_STATUS_ERR, POZYX_DELAY_POSITIONING, &int_status)){
     if((int_status & POZYX_INT_STATUS_ERR) == POZYX_INT_STATUS_ERR)
     {
       // An error occured during positioning.
@@ -919,11 +919,11 @@ int PozyxClass::doRemotePositioning(uint16_t remote_id, coordinates_t *coordinat
   uint8_t firmware;
   getFirmwareVersion(&firmware);
 
-  if (firmware == 0x13) {
+  if (firmware >= 0x13) {
     uint8_t params_positioning[2] = {1, 0};
     status = remoteRegFunctionWithoutCheck(remote_id, POZYX_DO_POSITIONING, params_positioning, 2, NULL, 0);
 
-    if (waitForFlag_safe(POZYX_INT_STATUS_RX_DATA , 200) == POZYX_SUCCESS){
+    if (waitForFlag_safe(POZYX_INT_STATUS_RX_DATA , POZYX_DELAY_REMOTE_POSITIONING) == POZYX_SUCCESS){
       uint8_t rx_info[3]= {0,0,0};
       regRead(POZYX_RX_NETWORK_ID, rx_info, 3);
       uint16_t remote_network_id = rx_info[0] + ((uint16_t)rx_info[1]<<8);
@@ -950,7 +950,7 @@ int PozyxClass::doRemotePositioning(uint16_t remote_id, coordinates_t *coordinat
   }
 
   // change timeout flag if crashes
-  if (waitForFlag_safe(POZYX_INT_STATUS_RX_DATA , 200)){
+  if (waitForFlag_safe(POZYX_INT_STATUS_RX_DATA , POZYX_DELAY_REMOTE_POSITIONING)){
 
     // we received a response, now get some information about the response
     uint8_t rx_info[3]= {0,0,0};

Pozyx_lib.cpp

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = PozyxArduinoLibrary
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/Makefile

@@ -0,0 +1,10 @@
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   pozyx_functions
+   pozyx_class
+   structs
+
+
+

docs/api/index.rst

@@ -0,0 +1,29 @@
+Pozyx Class Full
+================
+
+Members
+-------
+
+.. doxygenclass:: PozyxClass
+    :members:
+
+
+Protected
+---------
+
+.. doxygenclass:: PozyxClass
+    :protected-members:
+
+
+Private
+-------
+
+.. doxygenclass:: PozyxClass
+    :private-members:
+
+
+Undocumented...
+---------------
+
+.. doxygenclass:: PozyxClass
+    :undoc-members:

docs/api/pozyx_class.rst

@@ -0,0 +1,45 @@
+Pozyx Class Full
+================
+
+
+Core
+----
+
+.. doxygengroup:: core
+    :members:
+
+
+System functions
+----------------
+
+.. doxygengroup:: System_functions
+    :members:
+
+
+Communication
+-------------
+
+.. doxygengroup:: Communication_functions
+    :members:
+
+
+Device list
+-------------
+
+.. doxygengroup:: device_list
+    :members:
+
+
+Positioning
+-------------
+
+.. doxygengroup:: Positioning_functions
+    :members:
+
+
+Sensor Data
+-------------
+
+.. doxygengroup:: sensor_data
+    :members:
+