下载代码

  2. $ git clone https://github.com/jetlinks/jetlinks-community.git && cd jetlinks-community

方式1:使用docker快速启动全部环境

  2. $ cd docker/run-all
  3. $ docker-compose up

方式2:使用docker启动开发环境,使用IDE中启动JetLinks服务.

步骤1: 启动环境

  1. $ cd docker/dev-env
  2. $ docker-compose up

步骤2: 启动JetLinks服务
项目导入IDE后执行jetlinks-standalone模块下的org.jetlinks.community.standalone.JetLinksApplication
::: tip 注意
项目需要使用最新的java8(小版本号大于200),如1.8.0_232
:::
步骤3: 启动UI
可以通过UI源码自行构建.
或者使用docker启动UI:

  1. $ docker run -it --rm -p 9000:80 -e "API_BASE_PATH=http://host.docker.internal:8848/" registry.cn-shenzhen.aliyuncs.com/jetlinks/jetlinks-ui-antd

::: tip 注意
环境变量API_BASE_PATH为后台API根地址. 由docker容器内进行自动代理. 请根据自己的系统环境配置环境变量: API_BASE_PATH
:::

方式3:非docker环境启动

请先安装以下服务: postgresql 11,redis 5.x,elasticsearch 6.7.2.
::: tip 提示
postgresql可更换为mysql 5.7+或者sqlserver,只需要修改配置中的spring.r2dbc和easyorm相关配置项即可.
:::
步骤1: 根据情况修改jetlinks-standalone模块下的配置文件:application.yml中相关配置.

  1. spring:
  2.   redis:
  3.     host: 127.0.0.1 # redis配置
  4.     port: 6379
  5.   r2dbc:
  6.     url: r2dbc:postgresql://127.0.0.1:5432/jetlinks  # 数据库postgresql数据库配置
  7.     username: postgres
  8.     password: jetlinks
  9. easyorm:
  10.   default-schema: public # 数据库默认的schema
  11.   dialect: postgres #数据库方言
  12. elasticsearch:
  13.   client:
  14.     host: 127.0.0.1   # elasticsearch
  15.     port: 9200
  16. hsweb:
  17.   file:
  18.     upload:
  19.       static-file-path: ./static/upload   # 上传的文件存储路径
  20.       static-location: http://127.0.0.1:8848/upload # 上传的文件访问根地址

步骤2: 从方式2-步骤2开始.

启动成功后访问系统

地址: http://localhost:9000, 用户名:admin,密码:admin.

添加协议

进入设备管理-协议管理,点击新建.

  • 协议名称: 演示协议.
  • 类型: jar.
  • 类名: org.jetlinks.demo.protocol.DemoProtocolSupportProvider
  • 上传jar包: 选择项目内文件: simulator/demo-protocol-1.0.jar

添加协议

添加设备型号

进入设备管理-型号管理,点击导入配置. 选择项目内文件: simulator/设备型号-演示设备.json.
导入型号配置
导入成功后,点击操作列-发布,如果状态为已发布,则点击停用后重新发布.

添加设备实例

进入设备管理-设备实例,点击新建.

  • 设备id: demo-0
  • 设备名称: 演示设备0
  • 设备型号: 演示设备

添加设备实例
点击确定,保存成功后, 点击操作列-激活. 点击查看可查看设备的基本信息以及运行状态
设备基本信息
设备基本信息
运行状态
运行状态

启动MQTT服务

进入网络组件-组件管理,点击新增组件.

  • 组件名称: MQTT服务
  • 组件类型: MQTT服务
  • 线程数: 4 可根据实际情况调整,一般不大于主机CPU核心数*2
  • HOST: 0.0.0.0
  • PORT: 1883
  • TLS: 否

创建mqtt服务组件
点击保存,保存成功后,点击启动状态切换启动状态为启动.
启动mqtt服务

启动设备网关

进入网络组件-设备网关,点击新建.

  • 名称: MQTT网关
  • 类型: MQTT服务设备网关
  • 网络组件: MQTT服务 选择上一步创建的网络组件

启动mqtt服务
点击确定,保存成功后,点击操作列中的启动.

启动模拟器

进入项目目录:simulator.

  1.    $ cd simulator
  2.    $ ./start.sh

启动成功后控制台应该会输出:

  1. ...
  2. create mqtt client: 1 ok
  3. ...
  4. 开始上报设备事件
  5. 成功推送设备事件:1

查看设备数据

进入设备实例,点击查看demo-0设备,点击运行状态,可看到设备上报的数据.
设备运行状态信息
启动mqtt服务
设备上报的事件数据
启动mqtt服务