文件列表:

blynk-server (0, 2018-01-27)
... ...

# What is Blynk? Blynk is a platform with iOS and Android apps to control Arduino, ESP8266, Raspberry Pi and the likes over the Internet. You can easily build graphic interfaces for all your projects by simply dragging and dropping widgets. If you need more information, please follow these links: * [Blynk site](https://www.blynk.cc) * [Blynk docs](http://docs.blynk.cc) * [Blynk community](https://community.blynk.cc) * [Blynk Examples generator](https://examples.blynk.cc) * [Facebook](http://www.fb.com/blynkapp) * [Twitter](http://twitter.com/blynk_app) * [App Store](https://itunes.apple.com/us/app/blynk-control-arduino-raspberry/id808760481?ls=1&mt=8) * [Google Play](https://play.google.com/store/apps/details?id=cc.blynk) * [Blynk library](https://github.com/blynkkk/blynk-library) * [Kickstarter](https://www.kickstarter.com/projects/167134865/blynk-build-an-app-for-your-arduino-project-in-5-m/description)     # Content - [Download](#blynk-server) - [Requirements](#requirements) - [Quick Local Server setup](#quick-local-server-setup) - [Quick local server setup on Raspberry PI](#quick-local-server-setup-on-raspberry-pi) - [Enabling server auto restart on unix-like systems](#enabling-server-auto-restart-on-unix-like-systems) - [Enabling server auto restart on Windows](#enabling-server-auto-restart-on-windows) - [Update instruction for unix-like systems](#update-instruction-for-unix-like-systems) - [Update instruction for Windows](#update-instruction-for-windows) - [App and sketch changes for Local Server](#app-and-sketch-changes) - [Advanced local server setup](#advanced-local-server-setup) - [Administration UI](#administration-ui) - [HTTP/S RESTful API](#https-restful) - [Enabling mail on Local server](#enabling-mail-on-local-server) - [Enabling sms on local server](#enabling-sms-on-local-server) - [Enabling raw data storage](#enabling-raw-data-storage) - [Automatic Let's Encrypt Certificates](#automatic-lets-encrypt-certificates-generation) - [Manual Let's Encrypt SSL/TLS Certificates](#manual-lets-encrypt-ssltls-certificates) - [Generate own SSL certificates](#generate-own-ssl-certificates) - [Install java for Ubuntu](#install-java-for-ubuntu) - [How Blynk Works?](#how-blynk-works) - [Blynk Protocol](#blynk-protocol) # GETTING STARTED ## Blynk server Blynk Server is an Open-Source [Netty](https://github.com/netty/netty) based Java server, responsible for forwarding messages between Blynk mobile application and various microcontroller boards and SBCs (i.e. Arduino, Raspberry Pi. etc). **Download latest server build [here](https://github.com/blynkkk/blynk-server/releases).** [](https://github.com/blynkkk/blynk-server/releases/latest) [](https://github.com/blynkkk/blynk-server/releases/latest) [ ](https://travis-ci.org/blynkkk/blynk-server) ## Requirements - Java 8/9 required (OpenJDK, Oracle) - Any OS that can run java - At least 30 MB of RAM (could be less with tuning) - Open ports 8443 (for app), 8442 (for hardware without ssl), 8441 (for hardware with ssl) [Ubuntu java installation instruction](#install-java-for-ubuntu). For Windows download Java [here](http://download.oracle.com/otn-pub/java/jdk/9+181/jre-9_windows-x***_bin.exe) and install. ## Quick local server setup + Make sure you are using Java 9 java -version Output: java version "9" + Run the server on default 'hardware port 8442' and default 'application port 8443' (SSL port) java -jar server-0.30.2.jar -dataFolder /path That's it! **NOTE: ```/path``` should be real existing path to folder where you want to store all your data.** + As an output you should see something like that: Blynk Server successfully started. All server output is stored in current folder in 'logs/blynk.log' file. ### Enabling mail on Local server To enable mail notifications on Local server you need to provide your own mail credentials. Create file ```mail.properties``` within same folder where ```server.jar``` is. Mail properties: mail.smtp.auth=true mail.smtp.starttls.enable=true mail.smtp.host=smtp.gmail.com mail.smtp.port=587 mail.smtp.username=YOUR_EMAIL_HERE mail.smtp.password=YOUR_EMAIL_PASS_HERE Find example [here](https://github.com/blynkkk/blynk-server/blob/master/server/notifications/email/src/main/resources/mail.properties). WARNING : only gmail accounts are allowed. NOTE : you'll need to setup Gmail to allow less secured applications. Go [here](https://www.google.com/settings/security/lesssecureapps) and then click "Allow less secure apps". ## Quick local server setup on Raspberry PI + Login to Raspberry Pi via ssh; + Install java 8: sudo apt-get install oracle-java8-jdk + Make sure you are using Java 8 java -version Output: java version "1.8" + Download Blynk server jar file (or manually copy it to Raspberry Pi via ssh and scp command): wget "https://github.com/blynkkk/blynk-server/releases/download/v0.30.2/server-0.30.2-java8.jar" + Run the server on default 'hardware port 8442' and default 'application port 8443' (SSL port) java -jar server-0.30.2-java8.jar -dataFolder /home/pi/Blynk That's it! + As output you will see something like that: Blynk Server successfully started. All server output is stored in current folder in 'logs/blynk.log' file. ## Enabling server auto restart on unix-like systems + To enable server auto restart find /etc/rc.local file and add: java -jar /home/pi/server-0.30.2.jar -dataFolder /home/pi/Blynk & + Or if the approach above doesn't work, execute crontab -e add the following line @reboot java -jar /home/pi/server-0.30.2.jar -dataFolder /home/pi/Blynk & save and exit. ## Enabling server auto restart on Windows + Create bat file: start-blynk.bat + Put in it one line: java -jar server-0.30.2.jar -dataFolder /home/pi/Blynk + Put bat file to windows startup folder You can also use [this](https://github.com/blynkkk/blynk-server/tree/master/scripts/win) script to run server. ## Update instruction for unix-like systems **IMPORTANT** Server should be always updated before you update Blynk App. To update your server to a newer version you would need to kill old process and start a new one. + Find process id of Blynk server ps -aux | grep java + You should see something like that username 10539 1.0 12.1 3325808 428948 pts/76 Sl Jan22 9:11 java -jar server-0.30.2.jar + Kill the old process kill 10539 10539 - blynk server process id from command output above. + Start new server [as usual](#quick-local-server-setup) After this steps you can update Blynk app. Server version downgrade is not supported. **WARNING!** Please **do not** revert your server to lower versions. You may loose all of your data. ## Update instruction for Windows + Open Task Manager; + Find Java process; + Stop process; + Start new server [as usual](#quick-local-server-setup) ## App and sketch changes + Specify custom server path in your application   + Change your ethernet sketch from ``` Blynk.begin(auth); ``` to ``` Blynk.begin(auth, "your_host"); ``` or to ``` Blynk.begin(auth, IPAddress(xxx,xxx,xxx,xxx)); ``` + Change your WIFI sketch from ``` Blynk.begin(auth, SSID, pass)); ``` to ``` Blynk.begin(auth, SSID, pass, "your_host"); ``` or to ``` Blynk.begin(auth, SSID, pass, IPAddress(XXX,XXX,XXX,XXX)); ``` + Change your rasp PI javascript from ``` var blynk = new Blynk.Blynk(AUTH, options = {connector : new Blynk.TcpClient()}); ``` to ``` var blynk = new Blynk.Blynk(AUTH, options= {addr:"xxx.xxx.xxx.xxx"}); ``` + or in case of USB when running blynk-ser.sh provide '-s' option with address of your local server ./blynk-ser.sh -s you_host_or_IP **IMPORTANT** Blynk is being constantly developed. Mobile apps and server are updated often. To avoid problems during updates either turn off auto-update for Blynk app, or update both local server and blynk app at same time to avoid possible migration issues. **IMPORTANT** Blynk local server is different from Blynk Cloud server. They are not related at all. You have to create new account when using Blynk local server. ## Advanced local server setup For more flexibility you can extend server with more options by creating ```server.properties``` file in same folder as ```server.jar```. Example could be found [here](https://github.com/blynkkk/blynk-server/blob/master/server/core/src/main/resources/server.properties). You could also specify any path to ```server.properties``` file via command line argument ```-serverConfig```. You can do the same with ```mail.properties``` via ```-mailConfig``` and ```sms.properties``` via ```-smsConfig```. For example: java -jar server-0.30.2.jar -dataFolder /home/pi/Blynk -serverConfig /home/pi/someFolder/server.properties Available server options: + Blynk app, https, web sockets, admin port https.port=9443 + Hardware plain tcp/ip port hardware.default.port=8442 + Hardware ssl/tls port (for hardware that supports SSL/TLS sockets) hardware.ssl.port=8441 + For simplicity Blynk already provides server jar with built in SSL certificates, so you have working server out of the box via SSL/TLS sockets. But as certificate and it's private key are in public this is totally not secure. So in order to fix that you need to provide your own certificates. And change below properties with path to your cert. and private key and it's password. See how to generate self-signed certificates [here](#generate-ssl-certificates) #points to cert and key that placed in same folder as running jar. server.ssl.cert=./server_embedded.crt server.ssl.key=./server_embedded.pem server.ssl.key.pass=pupkin123 + Http and web sockets port http.port=8080 + User profiles folder. Folder in which all users profiles will be stored. By default System.getProperty("java.io.tmpdir")/blynk used. Will be created if not exists data.folder=/tmp/blynk + Folder for all application logs. Will be created if it doesn't exist. "." is dir from which you are running script. logs.folder=./logs + Log debug level. Possible values: trace|debug|info|error. Defines how precise logging will be. From left to right -> maximum logging to minimum log.level=trace + Maximum allowed number of user dashboards. user.dashboard.max.limit=100 + 100 Req/sec rate limit per user. You also may want to extend this limit on [hardware side](https://github.com/blynkkk/blynk-library/blob/f4e132652906d63d683abeed89f5d6ebe369e37a/Blynk/BlynkConfig.h#L42). user.message.quota.limit=100 + this setting defines how often you can send mail/tweet/push or any other notification. Specified in seconds notifications.frequency.user.quota.limit=60 + Maximum allowed user profile size. In Kb's. user.profile.max.size=128 + Number of strings to store in terminal widget (terminal history data) terminal.strings.pool.size=25 + Maximum allowed number of notification queue. Queue responsible for processing email, pushes, twits sending. Because of performance issue - those queue is processed in separate thread, this is required due to blocking nature of all above operations. Usually limit shouldn't be reached notifications.queue.limit=5000 + Number of threads for performing blocking operations - push, twits, emails, db queries. Recommended to hold this value low unless you have to perform a lot of blocking operations. blocking.processor.thread.pool.limit=6 + Period for flushing all user DB to disk. In millis profile.save.worker.period=60000 + Specifies maximum period of time when hardware socket could be idle. After which socket will be closed due to non activity. In seconds. Leave it empty for infinity timeout hard.socket.idle.timeout=15 + Mostly required for local servers setup in case user want to log raw data in CSV format. See [raw data] (#raw-data-storage) section for more info. enable.raw.data.store=true + Url for opening admin page. Must start from "/". For "/admin" url path will look like that "https://127.0.0.1:9443/admin". admin.rootPath=/admin + Comma separated list of administrator IPs. Allow access to admin UI only for those IPs. You may set it for 0.0.0.0/0 to allow access for all. You may use CIDR notation. For instance, 192.168.0.53/24. allowed.administrator.ips=0.0.0.0/0 + Default admin name and password. Will be created on initial server start admin.email=admin@blynk.cc admin.pass=admin + Host for reset password redirect and certificate generation. By default current server IP is taken from "eth" network interface. Could be replaced with more friendly hostname. It is recommended to override this property with your server IP to avoid possible problems of host resolving. server.host=blynk-cloud.com + Email used for certificate registration, could be omitted in case you already specified it in mail.properties. contact.email=pupkin@gmail.com + Comma separated list of users allowed to create accounts. Leave it empty if no restriction required. allowed.users.list=allowed1@gmail.com,allowed2@gmail.com ## Administration UI Blynk server provides administration panel where you can monitor your server. It is accessible at this URL: https://your_ip:9443/admin  **WARNING** Please change default admin password and name right after login to admin page. **THIS IS SECURITY MEASURE**. **WARNING** Default ```allowed.administrator.ips``` setting allows access for everyone. In other words, administration page available from any other computer. Please restrict access to it via property ```allowed.administrator.ips```. ### Turn off chrome https warning on localhost - Paste in chrome chrome://flags/#allow-insecure-localhost - You should see highlighted text saying: "Allow invalid certificates for resources loaded from localhost". Click enable. ## HTTP/S RESTful Blynk HTTP/S RESTful API allows to easily read and write values to/from Pins in Blynk apps and Hardware. Http API description could be found [here](http://docs.blynkapi.apiary.io). ### Enabling sms on local server To enable SMS notifications on Local Server you need to provide credentials for SMS gateway (currently Blynk server supports only 1 provider - [Nexmo](https://www.nexmo.com/). You need to create file ```sms.properties``` within same folder where server.jar is. nexmo.api.key= nexmo.api.secret= And fill in the above properties with the credentials you'll get from Nexmo. (Account -> Settings -> API settings). You can also send SMS over email if your cell provider supports that. See [discussion](http://community.blynk.cc/t/sms-notification-for-important-alert/2542) for more details. ## Enabling raw data storage By default raw data storage is disabled (as it consumes disk space a lot). When you enable it, every ```Blynk.virtualWrite``` command will be saved to DB. You will need to install PostgreSQL Database (**minimum required version is 9.5**) to enable this functionality: #### 1. Enabling raw data on server Enable raw data in ```server.properties``` : enable.db=true enable.raw.db.data.store=true #### 2. Install PostgreSQL. Option A sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" >> /etc/apt/sources.list.d/pgdg.list' wget -q https://www.postgresql.org/media/keys/ACCC4CF8.asc -O - | sudo apt-key add - sudo apt-get update sudo apt-get install postgresql postgresql-contrib #### 2. Install PostgreSQL. Option B sudo apt-get update apt-get --no-install-recommends install postgresql-9.6 postgresql-contrib-9.6 #### 3. Download Blynk DB script wget https://raw.githubusercontent.com/blynkkk/blynk-server/master/server/core/src/main/resources/create_schema.sql #### 4. Move create_schema.sql to temp folder (to avoid permission problems) mv create_schema.sql /tmp Result: /tmp/create_schema.sql Copy it to clipboard from your console. #### 5. Connect to PostgreSQL sudo su - postgres psql #### 6. Create Blynk DB, test user and tables \i /tmp/create_schema.sql ```/tmp/create_schema.sql``` - is path from step 4. You should see next output: postgres=# \i /tmp/create_schema.sql CREATE DATABASE You are now connected to database "blynk" as user "postgres". CREATE TABLE CREATE TABLE CREATE TABLE CREATE TABLE CREATE TABLE CREATE TABLE CREATE TABLE CREATE TABLE CREATE TABLE CREATE TABLE CREATE TABLE CREATE ROLE GRANT GRANT #### Quit \q Now start your server and you should see next text in ```postgres.log``` file : 2017-03-02 16:17:18.367 - DB url : jdbc:postgresql://localhost:5432/blynk?tcpKeepAlive=true&socketTimeout=150 2017-03-02 16:17:18.367 - DB user : test 2017-03-02 16:17:18.367 - Connecting to DB... 2017-03-02 16:17:18.455 - Connected to database successfully. WARNING: Raw data may consume your disk space very quickly! ### CSV data format Data format is: value,timestamp,deviceId For example: 10,1438022081332,0 Where ```10``` - value of pin. ```1438022081332``` - the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC. To display the date/time in excel you may use formula: =((COL ... ...

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：