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:
6:4cbf7303b496
Parent:
5:76fb6b783487
Child:
7:54984d031243
--- a/MotionFX_Manager.h	Wed Feb 03 11:22:17 2016 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,140 +0,0 @@
-/**
-  ******************************************************************************
-  * @file    MotionFX_Manager.h
-  * @author  Central Lab
-  * @version V1.1.0
-  * @date    20-Jannuary-2015
-  * @brief   This file includes sensor fusion interface functions
-  ******************************************************************************
-  * @attention
-  *
-  * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
-  *
-  * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
-  * You may not use this file except in compliance with the License.
-  * You may obtain a copy of the License at:
-  *
-  *        http://www.st.com/software_license_agreement_liberty_v2
-  *
-  * Redistribution and use in source and binary forms, with or without modification,
-  * are permitted provided that the following conditions are met:
-  *   1. Redistributions of source code must retain the above copyright notice,
-  *      this list of conditions and the following disclaimer.
-  *   2. Redistributions in binary form must reproduce the above copyright notice,
-  *      this list of conditions and the following disclaimer in the documentation
-  *      and/or other materials provided with the distribution.
-  *   3. Neither the name of STMicroelectronics nor the names of its contributors
-  *      may be used to endorse or promote products derived from this software
-  *      without specific prior written permission.
-  *
-  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-  *
-  ******************************************************************************
-  */
-  
-#ifndef _MOTIONFX_MANAGER_H_
-#define _MOTIONFX_MANAGER_H_
-
-#ifdef __cplusplus
- extern "C" {
-#endif
-
-//#define USE_SENSOR_FUSION_LIB    /** uncomment only if STM32_OSX_MotionFX_Library is linked and licensed **/
-
-#include <cstdio>
-#include <stdint.h> 
-#include <stdio.h>   
-     
-#ifdef USE_SENSOR_FUSION_LIB     
-#include "osx_motion_fx.h"
-#else
-
-#define NUM_AXES    3
-#define QNUM_AXES   4
-     
-typedef struct
-{
-  float mag[NUM_AXES];  /* calibrated mag [uT]/50 */
-  float acc[NUM_AXES];  /* acc [g] */
-  float gyro[NUM_AXES]; /* gyro [dps] */
-} osxMFX_input;
-
-typedef struct
-{
-  float rotation_9X[NUM_AXES];            /* 9 axes yaw, pitch and roll */
-  float quaternion_9X[QNUM_AXES];         /* 9 axes quaternion */
-  float gravity_9X[NUM_AXES];             /* 9 axes device frame gravity */
-  float linear_acceleration_9X[NUM_AXES]; /* 9 axes device frame linear acceleration */
-  float heading_9X;                       /* 9 axes heading */
-  float rotation_6X[NUM_AXES];            /* 6 axes yaw, pitch and roll */
-  float quaternion_6X[QNUM_AXES];         /* 6 axes quaternion */
-  float gravity_6X[NUM_AXES];             /* 6 axes device frame gravity */
-  float linear_acceleration_6X[NUM_AXES]; /* 6 axes device frame linear acceleration */
-  float heading_6X;                       /* 6 axes heading */
-} osxMFX_output;
-
-typedef struct
-{
-  signed short magOffX; /* X axis Offset */
-  signed short magOffY; /* Y axis Offset */
-  signed short magOffZ; /* Z axis Offset */
-  float magGainX;       /* X axis Gain  */
-  float magGainY;       /* Y axis Gain  */
-  float magGainZ;       /* Z axis Gain  */
-  float expMagVect;     /* expected magnetic field */
-} osxMFX_calibFactor;    
-     
-unsigned char osx_MotionFX_compass_isCalibrated(void);
-void osx_MotionFX_compass_forceReCalibration(void);
-void osx_MotionFX_compass_saveAcc(int acc_x, int acc_y, int acc_z);
-void osx_MotionFX_compass_saveMag(int mag_x, int mag_y, int mag_z);
-int  osx_MotionFX_compass_run(void);
-void osx_MotionFX_setCalibrationData(osxMFX_calibFactor* CalibrationData);
-void osx_MotionFX_getCalibrationData(osxMFX_calibFactor* CalibrationData);
-
-#endif
-     
-     
-typedef struct {
-    int32_t AXIS_X;
-    int32_t AXIS_Y;
-    int32_t AXIS_Z;
-} AxesRaw_t;
-     
-/* Exported functions ------------------------------------------------------- */
-
-bool MotionFX_manager_init(bool DS3_OnBoard, osxMFX_calibFactor & magOffset);
-void MotionFX_manager_run(AxesRaw_t *ACC_Value, AxesRaw_t *GYR_Value, AxesRaw_t *MAG_Value, osxMFX_calibFactor & magOffset);
-void MotionFX_manager_start_6X(void);
-void MotionFX_manager_stop_6X(void);
-void MotionFX_manager_start_9X(void);
-void MotionFX_manager_stop_9X(void);
-
-void MotionFX_manager_setDependencies(uint8_t sf, int32_t sensorMask);
-void MotionFX_manager_resetDependencies(uint8_t sf, int32_t sensorMask);
-uint32_t MotionFX_manager_getDependencies(uint8_t sf);
-
-osxMFX_output* MotionFX_manager_getDataOUT(void);
-osxMFX_input* MotionFX_manager_getDataIN(void);
-
-/* Exported constants --------------------------------------------------------*/
-
-/* Delta time mSec for Deltafusion */
-#define DELTATIMESENSORFUSION 0.01
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif //_MOTIONFX_MANAGER_H_
-
-/******************* (C) COPYRIGHT 2015 STMicroelectronics *****END OF FILE****/