SunTracker_BLE

Dependencies:   BLE_API X_NUCLEO_6180XA1 X_NUCLEO_IDB0XA1 X_NUCLEO_IHM01A1 X_NUCLEO_IKS01A1 mbed

Fork of SunTracker_BLE by ST Expansion SW Team

Overview

The SunTracker is a demo application running on ST Nucleo-F401RE stacking a set of ST X-NUCLEO expansion boards.
Main features provided are:

  • A solar panel follows the light source, orienting the panel in order to achieve the best panel efficiency.
  • Orientation is controlled thanks to a couple of VL6180X FlightSense light sensors mounted on a X-NUCLEO-6180XA1 expansion board and driven by X-NUCLEO-IHM01A1 controlled stepper motor acting as actuator to orientate the panel.
  • The system features a progressive control on the stepper motor in order to modulate the panel rotation speed according to the light angle.
  • The application is also able to control the panel productivity reading the panel voltage through an ADC and proving feedback on the local display.
  • A manual orientation is possible by using the accelerometer on a X-NUCLEO-IKS01A1 expansion board that, according on board tilt, controls the speed and the rotate direction.
  • A remote control is available using a X-NUCLEO-IDB04A1 or a X-NUCLEO-IDB05A1 Bluetooth Low Energy expansion board. Remote control software is here.

/media/uploads/fabiombed/suntracker_server-client.png

Working Status

  • SunTracker has 3 working status visible on FlightSense display and switchable by pressing the User Button:

Status 0 (Idle)

  • Motor: Free Turning
  • Display: Waiting for User Button

Status 1

  • Motor: Driven by Light
  • Display: Direction and Light Intensity = Direction and Motor Speed

Status 2

  • Motor: Driven by Light
  • Display: Solar Panel Efficiency

Status 3

  • Motor: Driven by Accelerometer
  • Display: Direction and Accelerometer Intensity

Server Startup

  • When you plug the power supply, the word ‘PUSH’ is shown on display.
  • You can manually rotate the structure to assign the ‘Zero Point’. Then press the User Button to launch the application.
  • The display will show this status, which means that the structure is oriented to maximize the efficiency of the solar panel.
  • If there is a light displacement, the structure will rotate, left or right, to follow the light source and on display is shown the direction and the speed.
  • You can press the User Button to show the panel efficiency with 4 digits that represent the range from 0v (0000) to 3,3v (3300).
  • Further pressing the User Button you will manual rotate the panel by tilt the Server or Client accelerometer depending by BLE connection.

Client Startup

  • The Client application can remotely control the User Button and the Accelerometer functions.
  • Power on the Client AFTER the Server, it will automatically search for the SunTracker and will establish a BLE connection.
  • The Green Led on Nucleo Client board will be powered on.

Rotation Features

  • It has been implemented a block of rotation to avoid cables twist.
  • The blocking point can be set in the firmware by changing a constant.
  • You can manually rotate the structure to assign the ‘Zero Point’ before press the User Button to launch the application.
  • The system features a progressive control on the stepper motor in order to modulate the rotation speed according to the light or accelerometer angle.

List of Components

SERVER SunTracker_BLE

  • Stepper Motor 400’’ (Part Number 5350401) - To orientate the Mechanical Structure.
  • Solar Panel 0.446w (Part Number 0194127) - To capture sunlight and generate electrical current.
  • Power Supply 12v (Part Number 7262993) - To provide power supply at the Stepper Motor.
  • Flat Cable 6 ways (Part Number 1807010) - To plug VL6180X-SATEL with X-NUCLEO-6180XA1 (60cm length each x2).
  • Cable Connector (Part Number 6737694) - To plug the Flat Cable (x4).
  • Power Connector (Part Number 0487842) - To provide Power Supply to X-NUCLEO-IHM01A1.

CLIENT SunTracker_BLE_Remote

MECHANICAL STRUCTURE

Find here the STL files to print with a 3D printer.

/media/uploads/fabiombed/assembly.png

/media/uploads/fabiombed/mechanical_structure_and_motor_legs.png

FLAT CABLE ASSEMBLY

/media/uploads/fabiombed/flat_cable.png

HARDWARE SETUP

Nucleo ADC + Solar Panel

Connect Solar Panel cables to Nucleo Morpho PC_3 (white) and Nucleo Morpho GND (black). Connect a capacitor 10uF between PC_3 and GND to stabilize its voltage value shown on display.

EasySpin (L6474) + BLE

Hardware conflict between EasySpin DIR1 and BLE Reset, both on same Arduino Pin PA_8. Disconnect PA_8 between EasySpin and Nucleo by fold EasySpin Pin. PB_2 has been configured as EasySpin DIR1 in the firmware . Connect Nucleo Morpho PB_2 to FlightSense Arduino PA_8 by a wire.

FlightSense Satellites

In case of instability with I2C due to long flat cables, solder 4 SMD capacitors 47pF on FlightSense board in parallel between R15, R16, R17, R18 and plug 2 capacitors 15pF between FlightSense Arduino PB_8 and PB_9 to GND pin to cut-off noises over 720 KHz.

Arduino & Morpho Pinout

/media/uploads/fabiombed/arduino_pinout.png /media/uploads/fabiombed/morpho_pinout.png

Revision:
4:1d3d071a4c2c
Parent:
2:013921c26f43
Child:
5:76fb6b783487
--- a/main.cpp	Fri Jan 22 14:28:13 2016 +0000
+++ b/main.cpp	Tue Jan 26 13:29:53 2016 +0000
@@ -2,14 +2,14 @@
  ******************************************************************************
  * @file    main.cpp
  * @author  Fabio Brembilla
- * @version V1.0.0
- * @date    December 1st, 2015
+ * @version V2.0.0
+ * @date    January 22th, 2016
  * @brief   SunTracker + RemoteControl Vertical Application
  *          This application use IHM01A1, 6180XA1, IKS01A1, IDB0XA1 expansion boards
  ******************************************************************************
  * @attention
- *  
- * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
+ *
+ * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
  *
  * Redistribution and use in source and binary forms, with or without modification,
  * are permitted provided that the following conditions are met:
@@ -35,12 +35,12 @@
  *
  ******************************************************************************
  */
- 
+
 /* Includes ------------------------------------------------------------------*/
- 
+
 /* mbed specific header files. */
 #include "mbed.h"
- 
+
 /* Helper header files. */
 #include "DevSPI.h"
 #include "DevI2C.h"
@@ -56,6 +56,12 @@
 #include <stdio.h>
 #include <assert.h>
 
+/* Calibration files. */
+#include "MotionFX_Manager.h" // Need for osxMFX_calibFactor
+
+/* BlueTooth Custom Service files. */
+#include "CustomSunTrackerService.h"
+
 /* Definitions ---------------------------------------------------------------*/
 
 #define SET_ACC 400     // Set Motor Acceleration
@@ -100,29 +106,35 @@
 /* Instance mems IKS01A1. */
 static X_NUCLEO_IKS01A1 *mems=X_NUCLEO_IKS01A1::Instance(&dev_i2c);
 MotionSensor *accelerometer = mems->GetAccelerometer();
-   
-void DISP_ExecLoopBody(void){};
+
+void DISP_ExecLoopBody(void) {};
 
 AnalogIn analog_read_A1(A1);
 
-InterruptIn mybutton(USER_BUTTON); 
+InterruptIn mybutton(USER_BUTTON);
 
 /* User_Button_Pressed -------------------------------------------------------*/
 
 void User_Button_Pressed()
 {
-  
-    if (start>0) { Display++; }
-    if (Display>2) { Display=0; } 
-    if (start==0) { start=1; }
-    
+
+    if (start>0) {
+        Display++;
+    }
+    if (Display>2) {
+        Display=0;
+    }
+    if (start==0) {
+        start=1;
+    }
+
 }
 
 /* Initialization ------------------------------------------------------------*/
 
 bool Initialization(void)
 {
-  
+
     /* Initializing Babybear Component. */
     status=board->InitBoard();
     if(status)
@@ -131,24 +143,24 @@
     // Put GPIO not used as Interrupt in Hi-Z
     status_t=board->sensor_top->SetGPIOxFunctionality(1, GPIOx_SELECT_OFF);
     //status_b=board->sensor_botton->SetGPIOxFunctionality(1, GPIOx_SELECT_OFF); No Present
-    status_l=board->sensor_left->SetGPIOxFunctionality(1, GPIOx_SELECT_OFF);    
+    status_l=board->sensor_left->SetGPIOxFunctionality(1, GPIOx_SELECT_OFF);
     status_r=board->sensor_right->SetGPIOxFunctionality(1, GPIOx_SELECT_OFF);
-      
+
     /* Initializing Motor Control Component. */
     motor = new L6474(D2, D8, D7, D9, D10, dev_spi);
     if (motor->Init(NULL) != COMPONENT_OK)
         return false;
- 
+
     motor->SetStepMode(STEP_MODE_1_8);  // Default is STEP_MODE_1_16
- 
+
     /* Set defaults Motor Speed. */
     motor->SetAcceleration(SET_ACC);
     motor->SetDeceleration(SET_DEC);
     motor->SetMaxSpeed(SET_MAX);        // Variable by Light/Mems Sensors
     motor->SetMinSpeed(SET_MIN);
-  
+
     return true;
-    
+
 }
 
 /* Measure_Babybear ----------------------------------------------------------*/
@@ -163,9 +175,15 @@
 
     diff = abs(babybear);
 
-    if (babybear>0) { left=0; right=1; }
-    if (babybear<0) { left=1; right=0; }
- 
+    if (babybear>0) {
+        left=0;
+        right=1;
+    }
+    if (babybear<0) {
+        left=1;
+        right=0;
+    }
+
 }
 
 /* Measure_Accelerometer -----------------------------------------------------*/
@@ -177,62 +195,97 @@
 
     diff = abs(acc_data[0]);
 
-    if (acc_data[0]>0) { left=0; right=1; }
-    if (acc_data[0]<0) { left=1; right=0; }
-    
+    if (acc_data[0]>0) {
+        left=0;
+        right=1;
+    }
+    if (acc_data[0]<0) {
+        left=1;
+        right=0;
+    }
+
 }
 
 
 /* Control_Motor -------------------------------------------------------------*/
 
 void Control_Motor(void)
-{  
-        
-    //printf("Diff: %d lux/mems\n\r", diff);   
-    motor->SetMaxSpeed(diff);        
+{
 
-    if (diff>TOLLERANCE)
-    {
+    //printf("Diff: %d lux/mems\n\r", diff);
+    motor->SetMaxSpeed(diff);
+
+    if (diff>TOLLERANCE) {
         if (diff <=RANGE_1) {
-            if (left)  { strcpy(DisplayStr,"E___"); }
-            if (right) { strcpy(DisplayStr,"___3"); }
-        }    
-        else if (diff >RANGE_1 & diff <=RANGE_2) {
-            if (left)  { strcpy(DisplayStr,"E==="); }
-            if (right) { strcpy(DisplayStr,"===3"); }
-        } 
-        else if (diff >RANGE_2) {
-            if (left)  { strcpy(DisplayStr,"E~~~"); }
-            if (right) { strcpy(DisplayStr,"~~~3"); }
-        }   
-      
+            if (left)  {
+                strcpy(DisplayStr,"E___");
+            }
+            if (right) {
+                strcpy(DisplayStr,"___3");
+            }
+        } else if (diff >RANGE_1 & diff <=RANGE_2) {
+            if (left)  {
+                strcpy(DisplayStr,"E===");
+            }
+            if (right) {
+                strcpy(DisplayStr,"===3");
+            }
+        } else if (diff >RANGE_2) {
+            if (left)  {
+                strcpy(DisplayStr,"E~~~");
+            }
+            if (right) {
+                strcpy(DisplayStr,"~~~3");
+            }
+        }
+
         // In Case of Change Direction
-        if (left & dir==2) { changedir=1; }
-        if (right & dir==1) { changedir=1; }
-        
+        if (left & dir==2) {
+            changedir=1;
+        }
+        if (right & dir==1) {
+            changedir=1;
+        }
+
         // Run only if Stop or Change Direction
         if (diff>TOLLERANCE & (dir==0 | changedir==1)) {
-            if (left) {  motor->Run(StepperMotor::FWD); dir=1; changedir=0; }
-            if (right) {  motor->Run(StepperMotor::BWD); dir=2; changedir=0; }
-        } 
+            if (left) {
+                motor->Run(StepperMotor::FWD);
+                dir=1;
+                changedir=0;
+            }
+            if (right) {
+                motor->Run(StepperMotor::BWD);
+                dir=2;
+                changedir=0;
+            }
+        }
     }
-    
+
     // Get Motor Position and Control Rotation Block
     pos = motor->GetPosition();
     if (pos>STOP | pos<-STOP) {
-        if (pos>0) { motor->GoTo(STOP); }
-        if (pos<0) { motor->GoTo(-STOP); }
+        if (pos>0) {
+            motor->GoTo(STOP);
+        }
+        if (pos<0) {
+            motor->GoTo(-STOP);
+        }
     }
-    
+
     // Stop Motor
-    if (diff<=TOLLERANCE) {  
+    if (diff<=TOLLERANCE) {
         motor->HardStop();
-        if (Display==0) { strcpy(DisplayStr,"----"); }
-        if (Display==2) { strcpy(DisplayStr,"E  3"); }  
+        if (Display==0) {
+            strcpy(DisplayStr,"----");
+        }
+        if (Display==2) {
+            strcpy(DisplayStr,"E  3");
+        }
         dir=0;
         changedir=0;
     }
-  
+
 }
 
 /* Measure_SolarPanel --------------------------------------------------------*/
@@ -245,48 +298,52 @@
     //printf("Measure = %.0f mV\r\n", measure);
     //board->display->DisplayDigit("A", 0);
 
-    if (Display==1) { sprintf(DisplayStr, "%.0f", measure); }  
-    
-    board->display->DisplayString(DisplayStr, 4); 
+    if (Display==1) {
+        sprintf(DisplayStr, "%.0f", measure);
+    }
+
+    board->display->DisplayString(DisplayStr, 4);
 
 }
 
 /* Main ----------------------------------------------------------------------*/
 
 int main()
-{ 
-  
-    Initialization();    
-    
+{
+
+    Initialization();
+
     mybutton.fall(&User_Button_Pressed);
-    
+
     /* Printing to the console. */
     printf("SunTracker by Fabio Brembilla\r\n\n");
- 
+
     /* Set Babybears. */
     status_l=board->sensor_left->AlsSetAnalogueGain(3);
     status_r=board->sensor_right->AlsSetAnalogueGain(3);
     status_l=board->sensor_left->StartMeasurement(als_continuous_polling, NULL, NULL, NULL);
     status_r=board->sensor_right->StartMeasurement(als_continuous_polling, NULL, NULL, NULL);
-    
+
     /* Loop until push User Button to Set 0 Point. */
     strcpy(DisplayStr,"pusH");
-    while(start<1)
-    {
+    while(start<1) {
         board->display->DisplayString(DisplayStr, 4);
     }
-    
+
     /* Main Loop. */
-    while(true)
-    {
-        if (Display==0 | Display==1)    { Measure_Babybear(); }   
-        if (Display==2)                 { Measure_Accelerometer(); }   
-       
+    while(true) {
+        if (Display==0 | Display==1)    {
+            Measure_Babybear();
+        }
+        if (Display==2)                 {
+            Measure_Accelerometer();
+        }
+
         Control_Motor();
         Measure_SolarPanel();
     }
-    
+
     status_l=board->sensor_left->StopMeasurement(als_continuous_polling);
     status_r=board->sensor_right->StopMeasurement(als_continuous_polling);
-    
+
 }