ArduinomySQMSkyQualityMeter:由ArduinoNano支持的mySQM-开源资源-CSDN文库

开源软件

154 浏览量 2021-04-29 10:24:17 上传评论收藏 4.14MB PDF 举报

资源推荐

资源详情

资源评论

1 | P a g e

mySQMPRO

A DIY Project

SQM, NELM, IR Sensor (cloud), Rain Sensor, Lux, Barometric Sensor, GPS

Version 022, 13 September 2020

Firmware release 037

Author Robert Brown

Date 27 February 2017

Email brown_rb@yahoo.com

CONTRIBUTIONS

If you wish to make a small contribution in thanks for this project, please use PayPal and send the amount

to user rbb1brown@gmail.com (Robert Brown). All contributions are gratefully accepted.

2 | P a g e

DISCLAIMER

This project is released into the public domain as is where is, with no obligation or responsibility accepted

on the part of the author, for any mishaps or failures caused by this product or use of this product. Users

intending to use this project or code do so at their own risk and usage of product and code is deemed to be

acceptance of those risks. The author(s) accept no responsibility to damage caused to any equipment or

goods or self by using the ideas, schematics and code associated with this project, or loss of income or all

other losses that may be incurred. No warranty is offered or implied.

The schematic, firmware and other code and ideas are released into the public domain. Users are free to

implement these for their personal use, but may NOT sell projects based on (or derived from) this project

for commercial gain without express written permission granted from the author(s).

FIRMWARE LICENSE RESTRICTIONS

This code is released under license. If you copy or write new code based on the code in these files you must

include to link to these files AND you must include references to the author(s) of this code.

Firmware is released subject to the following restrictions

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated

documentation files (the "Software"), the rights to use, copy, modify, merge, publish, distribute, sublicense

copies of the Software (from the authors), subject to the following conditions:

1. The above copyright notice shall be included in all copies or substantial portions of this Software.

2. The software may NOT be sold or charged for in any way, either as part of a package, license fee, annual

charges or premiums and shall include the copyright notice above.

3. The source-code to any software MUST be made available in full source-code form (including modified

source files) and free to download without payment and include the copyright notice above

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,

INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR

PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE

FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR

OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

DEALINGS IN THE SOFTWARE.

NOTE: If you intend to run this with every option, you should consider using a MEGA 2560 R3 board as

the Arduino Nano may run out of memory (if all options are enabled). If you intend to add Bluetooth

support, or support for APT and SQM readings (via the Rx command) then a MEGA 2560 is mandatory.

3 | P a g e  
 
 
Table of Contents 
mySQMPRO ....................................................................................................................................................... 1 
DISCLAIMER ....................................................................................................................................................... 2 
COPYRIGHT RESTRICTIONS ................................................................................................................................ 2 
FIRMWARE LICENSE RESTRICTIONS ................................................................................................................... 2 
DISCLAIMER ....................................................................................................................................................... 6 
RELEASE ............................................................................................................................................................. 6 
OVERVIEW ......................................................................................................................................................... 6 
mySQMPRO SPECIFICATIONS ............................................................................................................................ 6 
mySQMPRO PURCHASE LIST ............................................................................................................................. 6 
mySQMPRO PCB PURCHASE .............................................................................................................................. 7 
EXAMPLE PROTOTYPE PCB, POPULATED, AND ATTACHED TO SENSORS ...................................................... 7 
SPECIAL NOTE .................................................................................................. Error! Bookmark not defined. 
POWERING THE NANO ...................................................................................................................................... 9 
mySQMPRO OPERATION ................................................................................................................................... 9 
UPLOADING THE mySQMPRO ARDUINO CODE TO THE NANO ....................................................................... 10 
ON-OFF SWITCH .............................................................................................................................................. 10 
LCD2004 I2C DISPLAY [RECOMMENDED] ........................................................................................................ 10 
A NOTE ABOUT THE PROGRAM CODE AND FREQUENCY MEASUREMENT ..................................................... 10 
mySQMPRO READINGS.................................................................................................................................... 11 
BUILD OPTIONS................................................................................................................................................ 11 
RECOMMENDED BUILD ............................................................................................................................... 11 
mySQMPRO PROTOTYPE BUILD PICTURES ...................................................................................................... 12 
mySQMPRO SENSORS ..................................................................................................................................... 14 
TSL237 ......................................................................................................................................................... 14 
ENABLING THE TSL237 SENSOR IN FIRMWARE ....................................................................................... 14 
MLX90614 IR SENSOR .................................................................................................................................. 14 
ENABLING THE MLX90614 SENSOR IN FIRMWARE ................................................................................. 14 
BME280 SENSOR .......................................................................................................................................... 15 
ENABLING THE BME280 SENSOR IN FIRMWARE ..................................................................................... 15 
RAIN SENSOR ............................................................................................................................................... 15 
ENABLING THE RAIN SENSOR IN FIRMWARE .......................................................................................... 15 
NEO-6M GPS SENSOR .................................................................................................................................. 16 
ENABLING THE GPS SENSOR IN FIRMWARE ............................................................................................ 16 
TSL2561 or TSL2591 LUX SENSOR ................................................................................................................ 16 
ENABLING THE LUX SENSOR IN FIRMWARE ............................................................................................ 16 
BUILD OPTION FRITZING PCB - RECOMMENDED ............................................................................................ 17 
FRITZING PCB SCHEMATIC ........................................................................................................................... 17 

4 | P a g e  
 
Fritzing PCB LCD1602/LCD1604/LCD2004/OLED ......................................................................................... 17 
FRITZING PCB FIRMWARE TO USE ............................................................................................................... 17 
BUILD OPTION LCD2004/LCD1604/LCD1602 .................................................................................................. 18 
STRIPBOARD SCHEMATIC ............................................................................................................................ 18 
STRIPBOARD LAYOUT .................................................................................................................................. 18 
STRIPBOARD FIRMWARE FILE ...................................................................................................................... 18 
FIRMWARE ....................................................................................................................................................... 19 
INSTALL THE ARDUINO IDE .......................................................................................................................... 19 
COPY THE LIBRARIES FIRST .......................................................................................................................... 19 
ARDUINO IDE CONFIGURATION .................................................................................................................. 19 
CONFIGURING THE FIRMWARE ................................................................................................................... 19 
CHANGES YOU MUST MAKE TO THE FIRMWARE CODE .............................................................................. 19 
A NOTE ABOUT CONFIG OPTIONS ............................................................................................................... 20 
CONFIG EXAMPLE 1 ..................................................................................................................................... 21 
CONFIG EXAMPLE 2 ..................................................................................................................................... 22 
UPLOADING ARDUINO FIRMWARE CODE TO THE UNO/NANO .................................................................. 23 
INSTANTANEOUS OR RUNNING AVERAGE SAMPLING ................................................................................ 23 
METHODS USED TO CALCULATE SQM VALUES ........................................................................................... 23 
OLDSQMETHOD ....................................................................................................................................... 23 
NEWSQMMETHOD AND NEWSQMMETHODCORRECTED ....................................................................... 24 
IRRADIANCEMETHOD .............................................................................................................................. 24 
SQM READINGS ............................................................................................................................................... 24 
CALIBRATION ............................................................................................................................................... 24 
mySQMPRO WINDOWS APPLICATION ............................................................................................................ 26 
MAIN TAB .................................................................................................................................................... 27 
GET ALL .................................................................................................................................................... 27 
CLEAR ALL ................................................................................................................................................ 27 
STATUS MESSAGES .................................................................................................................................. 27 
EXIT .......................................................................................................................................................... 27 
LUX ........................................................................................................................................................... 27 
BME280 SENSOR TAB .................................................................................................................................. 28 
GPS SENSOR TAB ......................................................................................................................................... 30 
GPS PRESENT ........................................................................................................................................... 30 
GPS FIX ..................................................................................................................................................... 30 
AUTOMATE .............................................................................................................................................. 32 
LOG ERRORS ............................................................................................................................................ 32 
LOG VALUES ............................................................................................................................................. 32 
SETPOINT TAB .............................................................................................................................................. 33 
SET SETPOINT1/2 ..................................................................................................................................... 33 

5 | P a g e  
 
GET SETPOINT1/2 .................................................................................................................................... 33 
CONNECTION TAB ........................................................................................................................................ 34 
COM PORT SPEED .................................................................................................................................... 34 
CONNECT ................................................................................................................................................. 34 
DISCONNECT ............................................................................................................................................ 34 
REFRESH ................................................................................................................................................... 34 
The Settings Menu ....................................................................................................................................... 35 
ALERT POPUP WHEN RAINING ................................................................................................................ 35 
SET CLOUDSENSORII LOGFILENAME........................................................................................................ 36 
GRAPH OPTIONS .......................................................................................................................................... 36 
DATA LOGGING ................................................................................................................................................ 38 
APT/EKOS/INDI SUPPORT ................................................................................................................................ 39 
WHERE TO BUY ................................................................................................................................................ 40 
ARDUINO NANO CH340G (1pc) ............................................................................................................... 40 
PC STRIPBOARD ....................................................................................................................................... 40 
HARDWARE CABLES TO I2C SENSORS ............................................................................................................. 40 
HOW TO CHANGE THE DISPLAY PAGE REFRESH RATE .................................................................................... 41 
ASCOM OBSERVING CONDITIONS DRIVER ...................................................................................................... 42 
ASCOM OBSERVING CONDITIONS TEST APP ................................................................................................... 42 
CLOUD SENSOR LOG FILE FORMAT ................................................................................................................. 43 
mySQMPRO Output for CSII ........................................................................................................................ 44 
APPENDIX A   TESTING THE mySQMPRO CONTROLLER ................................................................................ 45 
Using a different LDR ................................................................................................................................... 45 
What happens if the SQM reading is inf or never changes ......................................................................... 46 
What happens if the SQM reading never falls lower than say 10 or 11 ...................................................... 46 
Fitting the LDR and TSL237 and Lens Assembly and UV/IR filter ................................................................ 46 
Testing the IR Sensor ................................................................................................................................... 48 
Sky-State ...................................................................................................................................................... 48 
APPENDIX B   ORDERED PARTS ..................................................................................................................... 49 
APPENDIX C  LUX ........................................................................................................................................... 51 
APPENDIX D  SETPOINT1 AND SETPOINT2 .................................................................................................... 52 
USER BUILDS .................................................................................................................................................... 55 
OTHER SQM PRODUCTS .................................................................................................................................. 57 
 
   