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

Committer:
fabiombed
Date:
Fri Mar 11 09:48:15 2016 +0000
Revision:
12:1e6a1d3a66b5
Fixed NC used as InterruptIn

Who changed what in which revision?

UserRevisionLine numberNew contents of line
fabiombed 12:1e6a1d3a66b5 1 /******************************************************************************
fabiombed 12:1e6a1d3a66b5 2 * @file CustomControlService.h
fabiombed 12:1e6a1d3a66b5 3 * @author Fabio Brembilla
fabiombed 12:1e6a1d3a66b5 4 * @version V1.0.0
fabiombed 12:1e6a1d3a66b5 5 * @date January, 2016
fabiombed 12:1e6a1d3a66b5 6 * @brief SunTracker Custom Service for BlueTooth (IDB0XA1 expansion board)
fabiombed 12:1e6a1d3a66b5 7 *****************************************************************************
fabiombed 12:1e6a1d3a66b5 8 * @attention
fabiombed 12:1e6a1d3a66b5 9 *
fabiombed 12:1e6a1d3a66b5 10 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
fabiombed 12:1e6a1d3a66b5 11 *
fabiombed 12:1e6a1d3a66b5 12 * Redistribution and use in source and binary forms, with or without modification,
fabiombed 12:1e6a1d3a66b5 13 * are permitted provided that the following conditions are met:
fabiombed 12:1e6a1d3a66b5 14 * 1. Redistributions of source code must retain the above copyright notice,
fabiombed 12:1e6a1d3a66b5 15 * this list of conditions and the following disclaimer.
fabiombed 12:1e6a1d3a66b5 16 * 2. Redistributions in binary form must reproduce the above copyright notice,
fabiombed 12:1e6a1d3a66b5 17 * this list of conditions and the following disclaimer in the documentation
fabiombed 12:1e6a1d3a66b5 18 * and/or other materials provided with the distribution.
fabiombed 12:1e6a1d3a66b5 19 * 3. Neither the name of STMicroelectronics nor the names of its contributors
fabiombed 12:1e6a1d3a66b5 20 * may be used to endorse or promote products derived from this software
fabiombed 12:1e6a1d3a66b5 21 * without specific prior written permission.
fabiombed 12:1e6a1d3a66b5 22 *
fabiombed 12:1e6a1d3a66b5 23 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
fabiombed 12:1e6a1d3a66b5 24 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
fabiombed 12:1e6a1d3a66b5 25 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
fabiombed 12:1e6a1d3a66b5 26 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
fabiombed 12:1e6a1d3a66b5 27 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
fabiombed 12:1e6a1d3a66b5 28 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
fabiombed 12:1e6a1d3a66b5 29 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
fabiombed 12:1e6a1d3a66b5 30 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
fabiombed 12:1e6a1d3a66b5 31 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
fabiombed 12:1e6a1d3a66b5 32 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
fabiombed 12:1e6a1d3a66b5 33 *
fabiombed 12:1e6a1d3a66b5 34 ******************************************************************************
fabiombed 12:1e6a1d3a66b5 35 */
fabiombed 12:1e6a1d3a66b5 36
fabiombed 12:1e6a1d3a66b5 37 #ifndef __CUSTOM_BLE_CONTROL_SERVICE_H__
fabiombed 12:1e6a1d3a66b5 38 #define __CUSTOM_BLE_CONTROL_SERVICE_H__
fabiombed 12:1e6a1d3a66b5 39 #include "BLE.h"
fabiombed 12:1e6a1d3a66b5 40 #include "UUID.h"
fabiombed 12:1e6a1d3a66b5 41
fabiombed 12:1e6a1d3a66b5 42 #define STORE_BE_32(buf, val) ( ((buf)[3] = (uint8_t) (val) ) , \
fabiombed 12:1e6a1d3a66b5 43 ((buf)[2] = (uint8_t) (val>>8) ) , \
fabiombed 12:1e6a1d3a66b5 44 ((buf)[1] = (uint8_t) (val>>16) ) , \
fabiombed 12:1e6a1d3a66b5 45 ((buf)[0] = (uint8_t) (val>>24) ) )
fabiombed 12:1e6a1d3a66b5 46
fabiombed 12:1e6a1d3a66b5 47 #define SIZEOF_CONTROL_DATA_LEN 2+4+1+1
fabiombed 12:1e6a1d3a66b5 48
fabiombed 12:1e6a1d3a66b5 49 /* BLE Services: Primary + 1 Secondary (Char Desk) */
fabiombed 12:1e6a1d3a66b5 50 const LongUUIDBytes_t CONTROL_SERVICE_UUID_128 = {0x00,0x00,0x00,0x00,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A}; //Primary
fabiombed 12:1e6a1d3a66b5 51 const LongUUIDBytes_t USER_BUTTON_CHAR_UUID = {0x00,0x00,0x00,0x01,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A,0x0A}; //User Button Control
fabiombed 12:1e6a1d3a66b5 52
fabiombed 12:1e6a1d3a66b5 53 /* Custom Control Service */
fabiombed 12:1e6a1d3a66b5 54 class CustomControlService {
fabiombed 12:1e6a1d3a66b5 55 public:
fabiombed 12:1e6a1d3a66b5 56 CustomControlService(BLE &_ble) :
fabiombed 12:1e6a1d3a66b5 57 ble(_ble),
fabiombed 12:1e6a1d3a66b5 58 userbuttonCharacteristic(USER_BUTTON_CHAR_UUID, controlData, SIZEOF_CONTROL_DATA_LEN, SIZEOF_CONTROL_DATA_LEN,
fabiombed 12:1e6a1d3a66b5 59 GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_READ | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_WRITE | GattCharacteristic::BLE_GATT_CHAR_PROPERTIES_NOTIFY)
fabiombed 12:1e6a1d3a66b5 60 {
fabiombed 12:1e6a1d3a66b5 61 static bool serviceAdded = false; // To be sure to define just one time
fabiombed 12:1e6a1d3a66b5 62 if (serviceAdded) {
fabiombed 12:1e6a1d3a66b5 63 return;
fabiombed 12:1e6a1d3a66b5 64 }
fabiombed 12:1e6a1d3a66b5 65
fabiombed 12:1e6a1d3a66b5 66 GattCharacteristic *charTable[] = {&userbuttonCharacteristic};
fabiombed 12:1e6a1d3a66b5 67
fabiombed 12:1e6a1d3a66b5 68 GattService controlService(CONTROL_SERVICE_UUID_128, charTable, sizeof(charTable) / sizeof(GattCharacteristic *));
fabiombed 12:1e6a1d3a66b5 69
fabiombed 12:1e6a1d3a66b5 70 ble.gattServer().addService(controlService);
fabiombed 12:1e6a1d3a66b5 71
fabiombed 12:1e6a1d3a66b5 72 isEnabledControlNotify = false;
fabiombed 12:1e6a1d3a66b5 73 memset (controlData, 0, SIZEOF_CONTROL_DATA_LEN);
fabiombed 12:1e6a1d3a66b5 74 serviceAdded = true;
fabiombed 12:1e6a1d3a66b5 75 }
fabiombed 12:1e6a1d3a66b5 76
fabiombed 12:1e6a1d3a66b5 77 // Tests Method
fabiombed 12:1e6a1d3a66b5 78
fabiombed 12:1e6a1d3a66b5 79 void enNotify (Gap::Handle_t handle) {
fabiombed 12:1e6a1d3a66b5 80 if (isContHandle(handle)) {
fabiombed 12:1e6a1d3a66b5 81 PRINTF("enNotify! %d\n\r", handle); isEnabledControlNotify = true; return; }
fabiombed 12:1e6a1d3a66b5 82 }
fabiombed 12:1e6a1d3a66b5 83
fabiombed 12:1e6a1d3a66b5 84 void disNotify (Gap::Handle_t handle) {
fabiombed 12:1e6a1d3a66b5 85 if (isContHandle(handle)) {
fabiombed 12:1e6a1d3a66b5 86 isEnabledControlNotify = false; return; }
fabiombed 12:1e6a1d3a66b5 87 }
fabiombed 12:1e6a1d3a66b5 88
fabiombed 12:1e6a1d3a66b5 89 bool isContHandle (Gap::Handle_t handle) {
fabiombed 12:1e6a1d3a66b5 90 if (handle == userbuttonCharacteristic.getValueAttribute().getHandle()) return true;
fabiombed 12:1e6a1d3a66b5 91 return false;
fabiombed 12:1e6a1d3a66b5 92 }
fabiombed 12:1e6a1d3a66b5 93
fabiombed 12:1e6a1d3a66b5 94 void updateConnectionStatus(ConnectionStatus_t status) {
fabiombed 12:1e6a1d3a66b5 95 isEnabledControlNotify = false;
fabiombed 12:1e6a1d3a66b5 96 memset (controlData, 0, SIZEOF_CONTROL_DATA_LEN);
fabiombed 12:1e6a1d3a66b5 97 }
fabiombed 12:1e6a1d3a66b5 98
fabiombed 12:1e6a1d3a66b5 99 /*
fabiombed 12:1e6a1d3a66b5 100
fabiombed 12:1e6a1d3a66b5 101 uint32_t sendcontrolState(uint32_t Feature, uint8_t Command, uint8_t val, uint16_t TimeStamp) {
fabiombed 12:1e6a1d3a66b5 102 STORE_LE_16(controlData ,TimeStamp);
fabiombed 12:1e6a1d3a66b5 103 STORE_BE_32(controlData+2,Feature);
fabiombed 12:1e6a1d3a66b5 104 controlData[6] = Command;
fabiombed 12:1e6a1d3a66b5 105 controlData[7] = (val==0x01) ? 100: val;
fabiombed 12:1e6a1d3a66b5 106 return ble.gattServer().write(userbuttonCharacteristic.getValueAttribute().getHandle(), controlData, SIZEOF_CONTROL_DATA_LEN, 0);
fabiombed 12:1e6a1d3a66b5 107 }
fabiombed 12:1e6a1d3a66b5 108
fabiombed 12:1e6a1d3a66b5 109 uint32_t updatecontrolState(uint32_t Feature, uint8_t Command, uint8_t val, uint16_t TimeStamp) {
fabiombed 12:1e6a1d3a66b5 110 if (ble.getGapState().connected && isEnabledControlNotify ) {
fabiombed 12:1e6a1d3a66b5 111 return sendcontrolState(Feature, Command, val, TimeStamp);
fabiombed 12:1e6a1d3a66b5 112 }
fabiombed 12:1e6a1d3a66b5 113 return 0;
fabiombed 12:1e6a1d3a66b5 114 }
fabiombed 12:1e6a1d3a66b5 115
fabiombed 12:1e6a1d3a66b5 116 */
fabiombed 12:1e6a1d3a66b5 117
fabiombed 12:1e6a1d3a66b5 118 // Variables Initialization
fabiombed 12:1e6a1d3a66b5 119 private:
fabiombed 12:1e6a1d3a66b5 120 BLE &ble;
fabiombed 12:1e6a1d3a66b5 121 uint8_t controlData[SIZEOF_CONTROL_DATA_LEN];
fabiombed 12:1e6a1d3a66b5 122 uint8_t controlState;
fabiombed 12:1e6a1d3a66b5 123 GattCharacteristic userbuttonCharacteristic;
fabiombed 12:1e6a1d3a66b5 124 bool isEnabledControlNotify;
fabiombed 12:1e6a1d3a66b5 125
fabiombed 12:1e6a1d3a66b5 126 };
fabiombed 12:1e6a1d3a66b5 127
fabiombed 12:1e6a1d3a66b5 128 #endif /* #ifndef __CUSTOM_BLE_CONTROL_SERVICE_H__*/
fabiombed 12:1e6a1d3a66b5 129