diff --git a/Project/applications/smartcities/doc/doxygen/Doxyfile b/Project/applications/smartcities/doc/doxygen/Doxyfile index 996797c..7197b91 100644 --- a/Project/applications/smartcities/doc/doxygen/Doxyfile +++ b/Project/applications/smartcities/doc/doxygen/Doxyfile @@ -47,7 +47,7 @@ PROJECT_BRIEF = "Remote sensing made easy" # exceed 55 pixels and the maximum width should not exceed 200 pixels. # Doxygen will copy the logo to the output directory. -PROJECT_LOGO = +PROJECT_LOGO = ../modularsense.png # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) # base path where the generated documentation will be put. diff --git a/Project/applications/smartcities/doc/modularsense.png b/Project/applications/smartcities/doc/modularsense.png new file mode 100644 index 0000000..43963f5 --- /dev/null +++ b/Project/applications/smartcities/doc/modularsense.png diff --git a/Project/applications/smartcities/mainpage.dox b/Project/applications/smartcities/mainpage.dox new file mode 100644 index 0000000..fa028ff --- /dev/null +++ b/Project/applications/smartcities/mainpage.dox @@ -0,0 +1,27 @@ +/*! +* \mainpage Main Page +* +* This is the documentation for the Wi-Sense Wi-Sense software. +* +* This software is based on the WiSmart library (libwismart) and STM32 Periph library. +* +*
+* \section outline Product Outline + +* The software consists in a first \ref boot and a \ref loop. + +* \subsection boot Boot Stage +* At the boot stage, it tries to connect to the default or previously configured (if applicable) Wi-Fi network. If this succeeds, it starts the \ref loop, but should it not work, then it will set up an AP called "modularsense" in which a web server is configured, allowing the user to set up the new parameters. + +* \subsection loop Main Loop +* At the main loop, it initially scans for sensors and registers them in the SENTILO-compatible platform already configured on the device. Then, it collects data every 5 minutes, allocating memory for each iteration in which data is retrieved. After 30 minutes have passed, it sends the data to the platform if an Internet connection is available, if not, it will store it up until connectivity is reestablished. +* This loop repeats until power runs out or until it runs out of memory, if that happens, it stops collecting data and tries to send the stored data until it is successful, then it frees the memory and resumes the cycle. + +* \subsection data Data Collection +* Data collection is achieved using the internal I2C bus. Scanning is performed first to enumerate all the sensors available in the bus, then, data is fetched from them in a timely fashion. +* The sound sensor uses one of the internal ADC to sample the sound pressure level. The internal battery level sensor also uses another ADC. + +* \author Imanol Barba Sabariego +* \date 07/06/2013 +*/ +