软件配置

详细的软件配置和系统设置指南。

软件架构

1
┌─────────────────────────────────────────┐
2
│      应用层 (Application Layer)         │
3
│  ┌──────────┐  ┌──────────┐            │
4
│  │ Web控制台 │  │ 移动应用  │            │
5
│  └─────┬────┘  └────┬─────┘            │
6
├────────┼─────────────┼──────────────────┤
7
│      服务层 (Service Layer)             │
8
│  ┌─────▼──────────────▼─────┐          │
9
│  │    API Gateway             │          │
10
│  └──────┬───────────┬─────────┘         │
11
│  ┌──────▼───┐  ┌────▼────┐             │
12
│  │任务管理   │  │数据服务  │             │
13
│  └──────────┘  └─────────┘             │
14
├─────────────────────────────────────────┤
15
│      核心层 (Core Layer)                │
16
│  ┌──────────┐  ┌──────────┐            │
17
│  │导航控制   │  │传感器融合 │            │
18
│  └──────────┘  └──────────┘            │
19
├─────────────────────────────────────────┤
20
│      驱动层 (Driver Layer)              │
21
│  ┌──────────┐  ┌──────────┐            │
22
│  │硬件驱动   │  │通信驱动   │            │
23
│  └──────────┘  └──────────┘            │
24
└─────────────────────────────────────────┘

系统配置

主配置文件

位置: ~/.jhusv/config.yaml

1
# 系统基础配置
2
system:
3
  name: "my-usv"
4
  version: "1.0.0"
5
  log_level: "INFO"        # DEBUG, INFO, WARNING, ERROR
6
  data_path: "~/jhusv/data"
7

8
# 网络配置
9
network:
10
  api:
11
    host: "0.0.0.0"
12
    port: 8080
13
    ssl: false
14

15
  websocket:
16
    port: 8081
17
    max_connections: 10
18

19
  mqtt:
20
    broker: "mqtt.jhusv.com"
21
    port: 1883
22
    use_tls: true
23

24
# 数据库配置
25
database:
26
  type: "sqlite"           # sqlite, postgresql, mysql
27
  path: "~/jhusv/data/db.sqlite"
28
  # host: "localhost"      # for postgresql/mysql
29
  # port: 5432
30
  # username: "jhusv"
31
  # password: "password"
32

33
# 日志配置
34
logging:
35
  file: "~/jhusv/logs/system.log"
36
  max_size: "100MB"
37
  backup_count: 10
38
  format: "%(asctime)s - %(name)s - %(levelname)s - %(message)s"

USV 设备配置

位置: ~/.jhusv/devices/[device_id].yaml

1
device:
2
  id: "USV-2024-001"
3
  model: "JH-USV-300"
4
  name: "海洋勘探者1号"
5

6
  # 硬件规格
7
  specs:
8
    length: 3.0              # 米
9
    width: 1.2
10
    max_speed: 10            # 节
11
    max_payload: 50          # kg
12
    battery_capacity: 20000  # mAh
13

14
# 导航配置
15
navigation:
16
  mode: "auto"               # auto, manual, waypoint
17

18
  gps:
19
    type: "RTK"              # Standard, RTK
20
    update_rate: 10          # Hz
21
    min_satellites: 6
22

23
  imu:
24
    update_rate: 200         # Hz
25
    calibration_interval: 86400  # 秒
26

27
  control:
28
    pid_p: 1.0
29
    pid_i: 0.1
30
    pid_d: 0.05
31
    max_turn_rate: 30        # 度/秒
32

33
# 传感器配置
34
sensors:
35
  water_quality:
36
    enabled: true
37
    sample_rate: 1           # Hz
38
    parameters: ["ph", "do", "temp", "conductivity"]
39

40
  camera:
41
    enabled: true
42
    resolution: [1920, 1080]
43
    fps: 30
44
    encoding: "h264"
45

46
  sonar:
47
    enabled: false
48
    range: 100               # 米
49
    resolution: 0.1          # 米
50

51
# 安全配置
52
safety:
53
  geofence:
54
    enabled: true
55
    type: "polygon"          # polygon, circle
56
    coordinates:
57
      - [31.2304, 121.4737]
58
      - [31.2354, 121.4787]
59
      - [31.2404, 121.4837]
60
      - [31.2354, 121.4887]
61

62
  limits:
63
    max_distance: 5000       # 米
64
    max_depth: 50            # 米 (如适用)
65
    min_battery: 20          # %
66

67
  emergency:
68
    low_battery_action: "return_home"
69
    lost_connection_timeout: 60     # 秒
70
    lost_connection_action: "hold_position"

Web 控制台配置

启动控制台

1
jhusv web start

访问: http://localhost:8080

功能模块

实时监控
- 地图显示
- 实时数据
- 视频流
任务管理
- 创建任务
- 任务调度
- 历史记录
数据分析
- 数据可视化
- 报表生成
- 数据导出
系统设置
- 设备管理
- 用户管理
- 系统配置

自定义界面

配置文件: ~/.jhusv/web/config.json

1
{
2
  "theme": {
3
    "primaryColor": "#00D9FF",
4
    "darkMode": true,
5
    "language": "zh"
6
  },
7
  "map": {
8
    "provider": "google",
9
    "defaultZoom": 15,
10
    "defaultCenter": [31.2304, 121.4737]
11
  },
12
  "dashboard": {
13
    "refreshInterval": 1000,
14
    "widgets": [
15
      "map",
16
      "status",
17
      "sensors",
18
      "battery"
19
    ]
20
  }
21
}

API 配置

REST API

端点: http://localhost:8080/api/v1

认证配置:

1
api:
2
  authentication:
3
    type: "jwt"              # jwt, basic, apikey
4
    secret: "your-secret-key"
5
    expiration: 86400        # 秒
6

7
  rate_limit:
8
    enabled: true
9
    requests_per_minute: 60

WebSocket API

端点: ws://localhost:8081

1
websocket:
2
  authentication: true
3
  heartbeat_interval: 30    # 秒
4
  max_message_size: 1048576 # 字节

数据存储配置

本地存储

1
storage:
2
  local:
3
    path: "~/jhusv/data"
4

5
    # 数据保留策略
6
    retention:
7
      logs: 30               # 天
8
      telemetry: 90
9
      sensor_data: 180
10
      videos: 30
11

12
    # 自动清理
13
    auto_cleanup: true
14
    cleanup_schedule: "0 2 * * *"  # 每天凌晨2点

云存储

1
storage:
2
  cloud:
3
    enabled: true
4
    provider: "aws"          # aws, aliyun, tencent
5

6
    aws:
7
      region: "us-west-2"
8
      bucket: "jhusv-data"
9
      access_key: "YOUR_ACCESS_KEY"
10
      secret_key: "YOUR_SECRET_KEY"
11

12
    sync:
13
      auto: true
14
      interval: 3600         # 秒
15
      compress: true

插件配置

安装插件

1
jhusv plugin install <plugin-name>

插件配置

位置: ~/.jhusv/plugins/[plugin-name]/config.yaml

示例 - 自动避障插件:

1
plugin:
2
  name: "auto-avoidance"
3
  version: "1.0.0"
4
  enabled: true
5

6
settings:
7
  detection_range: 30        # 米
8
  reaction_time: 2           # 秒
9
  avoidance_distance: 15     # 米
10
  algorithm: "potential_field"

固件更新

检查更新

1
jhusv firmware check

更新固件

1
jhusv firmware update

:::warning 注意固件更新期间请勿断开连接或关闭电源。 :::

回滚固件

1
jhusv firmware rollback

备份与恢复

备份配置

1
# 备份所有配置
2
jhusv backup create --output ~/backup.tar.gz
3

4
# 仅备份特定配置
5
jhusv backup create --config --output ~/config-backup.tar.gz

恢复配置

1
jhusv backup restore ~/backup.tar.gz

自动备份

1
backup:
2
  auto:
3
    enabled: true
4
    schedule: "0 3 * * *"    # 每天凌晨3点
5
    destination: "~/jhusv/backups"
6
    retention: 7             # 保留天数

性能优化

系统优化

1
performance:
2
  # CPU 使用
3
  max_cpu_percent: 80
4

5
  # 内存使用
6
  max_memory_mb: 2048
7

8
  # 网络优化
9
  network:
10
    tcp_nodelay: true
11
    send_buffer: 524288
12
    recv_buffer: 524288
13

14
  # 日志优化
15
  logging:
16
    async: true
17
    buffer_size: 10000

数据库优化

1
database:
2
  connection_pool:
3
    min_size: 2
4
    max_size: 10
5
    timeout: 30
6

7
  query:
8
    cache_enabled: true
9
    cache_size: 1000

安全配置

用户认证

1
security:
2
  users:
3
    admin:
4
      password_hash: "..."
5
      role: "admin"
6

7
    operator:
8
      password_hash: "..."
9
      role: "operator"
10

11
  password_policy:
12
    min_length: 8
13
    require_special_char: true
14
    require_number: true
15
    expiration_days: 90

SSL/TLS

1
ssl:
2
  enabled: true
3
  cert_file: "/path/to/cert.pem"
4
  key_file: "/path/to/key.pem"
5
  ca_file: "/path/to/ca.pem"

下一步

🎯 学习任务规划
📊 了解数据管理
🔌 探索 API 接口

软件配置

软件架构

系统配置

主配置文件

USV 设备配置

Web 控制台配置

启动控制台

功能模块

自定义界面

API 配置

REST API

WebSocket API

数据存储配置

本地存储

云存储

插件配置

安装插件

插件配置

固件更新

检查更新

更新固件

回滚固件

备份与恢复

备份配置

恢复配置

自动备份

性能优化

系统优化

数据库优化

安全配置

用户认证

SSL/TLS

下一步

功能设置

目录

页面

本页面内容

软件配置

软件架构

系统配置

主配置文件

USV 设备配置

Web 控制台配置

启动控制台

功能模块

自定义界面

API 配置

REST API

WebSocket API

数据存储配置

本地存储

云存储

插件配置

安装插件

插件配置

固件更新

检查更新

更新固件

回滚固件

备份与恢复

备份配置

恢复配置

自动备份

性能优化

系统优化

数据库优化

安全配置

用户认证

SSL/TLS

下一步

功能设置

目录

页面

本页面内容

联系我们