# inav-configurator

**Repository Path**: dimianzhan/inav-configurator

## Basic Information

- **Project Name**: inav-configurator
- **Description**: 开源飞控INAV调参地面站
- **Primary Language**: JavaScript
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2020-05-08
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# INAV Configurator

INAV Configurator是用于[INAV]（https://github.com/iNavFlight/inav）飞行控制系统的跨平台配置工具。

它在Google Chrome中作为应用程序运行，并允许您配置在任何受支持的INAV目标上运行的INAV软件。

该工具和INAV可以支持各种类型的飞机，例如 四轴飞行器，六轴飞行器，八轴飞行器和固定翼飞机。

## INAV Configurator启动最小化，我该怎么办？

您必须删除`C：\ Users％Your_UserNname％\ AppData \ Local \ inav-configurator`文件夹及其所有内容。

[https://www.youtube.com/watch?v=XMoULyiFDp4](https://www.youtube.com/watch?v=XMoULyiFDp4)

另外，在带有PowerShell的Windows上，您可以使用`post_install_cleanup.ps1`脚本进行清理。 （谢谢James Cherrill）

## 安装

取决于目标操作系统，_INAV Configurator_是作为_standalone_应用程序或Chrome应用程序分发的。

### Windows

1.访问[发布页面]（https://github.com/iNavFlight/inav-configurator/releases）
1.下载适用于Windows平台的Configurator（存在Win32或Win64）
1.解压缩ZIP档案
1.从解压后的文件夹中运行INAV Configurator应用
1.配置器未签名，因此您必须允许Windows运行不受信任的应用程序。 第一次运行时可能会有监控

### Linux

1.访问[发布页面]（https://github.com/iNavFlight/inav-configurator/releases）
1.下载适用于Linux平台的配置器（存在linux32和linux64）
1.提取tar.gz存档
1.使inav-configurator文件可执行（chmod + x inav-configurator）
1.从解压后的文件夹中运行INAV Configurator应用

### Mac

1.访问[发布页面]（https://github.com/iNavFlight/inav-configurator/releases）
1.下载适用于Mac平台的配置器
1.解压缩ZIP档案
1.运行INAV Configurator
1.配置器未签名，因此您必须允许Mac运行不受信任的应用程序。 第一次运行时可能会有监控

### ChromeOS

在[Chrome网上应用店]中可以使用** INAV Configurator **形式的ChromeOS（https://chrome.google.com/webstore/detail/inav-configurator/fmaidjmgkdkpafmbnmigkpdnpdhopgel）

### 在本地构建和运行INAV Configurator（适用于开发或Linux用户）

对于本地开发，使用** node.js **构建系统。

1.安装node.js
1.在项目文件夹中运行`npm install`
1.要构建JS和CSS文件并启动配置器：
     -使用NW.js：运行`npm start`。
     -使用Chrome：运行`npm run gulp`。 然后打开chrome：// extensions启用
     在“开发人员模式”下，单击“加载解压缩的扩展...”按钮，然后选择“ inav-configurator”目录。

其他任务也在`gulpfile.js`中定义。 要运行任务，请使用`./node_modules/gulp/bin/gulp.js任务名`。 可用的有：

-** build **：从配置器的源生成JS和CSS输出文件。 每当对任何.js或.css文件进行更改时，都必须运行它，以使这些更改出现
在配置器中。 如果添加了新文件，则必须将它们包含在`gulpfile.js`中。 请参阅“ gulpfile.js”顶部的注释以了解如何操作。 另请参阅“监视”任务。
-**观看**：观看JS和CSS源代码的更改，并在编辑后运行“ build”任务。
-** dist **：创建应用的发行版（适用于打包为Chrome应用或NW.js应用）
在`。/ dist /`目录中。
-**发布**：在./apps中为每个受支持的平台（win32，osx64和linux64）创建NW.js应用程序
目录。 在macOS或Linux上运行此任务需要Wine，因为需要设置图标
适用于Windows应用。 如果您没有安装Wine，则可以通过运行** release-only-linux **任务来创建一个发行版。

## 不同的地图提供者

INAV Configurator 2.1允许在OpenStreetMap，Bing地图和MapProxy地图提供者之间进行选择。
INAV Configurator随附Bing Maps的** WITHOUT ** API密钥。 这意味着：每个想要使用Bing Maps的用户都必须创建自己的帐户，同意Bing Maps要求的所有“条款和条件”，并亲自配置INAV Configuerator。

### 如何选择地图提供者

1.单击INAV Configurator右上角的“设置”图标。
1.选择提供者：OpenStreetMap，Bing或MapProxy
1.对于Bing Maps，您必须提供由您自己生成的Bing Maps API密钥
1.对于MapProxy，您需要提供要使用的服务器URL和图层名称

### 如何获取Bing Maps API密钥

1.前往[https://www.bingmapsportal.com/](https://www.bingmapsportal.com/）的Bing Maps开发中心。
    *如果您拥有Bing Maps帐户，请使用用于创建该帐户的Microsoft帐户登录或创建一个新帐户。对于新帐户，请按照[创建Bing Maps帐户]（https://msdn.microsoft.com/library/gg650598.aspx）中的说明进行操作。
1.在“我的帐户”下选择“我的密钥”。
1.选择选项以创建新密钥。
1.提供以下信息以创建密钥：
    1.应用程序名称：必填。应用程序的名称。
    1.应用程序URL：应用程序的URL。这是一个可选字段，可帮助您将来记住该密钥的用途。
    1.密钥类型：必需。选择您要创建的密钥类型。您可以在此处找到键和应用程序类型的描述。
    1.应用程序类型：必需。选择最能代表将使用此键的应用程序的应用程序类型。您可以在[此处]（https://www.microsoft.com/maps/create-a-bing-maps-key.aspx）中找到键和应用程序类型的说明。
1.单击**创建**按钮。新密钥将显示在可用密钥列表中。按照所用Bing Maps API的文档中的说明，使用此密钥对Bing Maps应用程序进行身份验证。

### 如何设置MapProxy服务器进行离线缓存和任务计划
1.遵循[MAPPROXY.md]（MAPPROXY.md）中所述的过程
1.在Web浏览器中测试您的MapProxy服务器，例如：http://192.168.145.20/inavmapproxy/
1.拥有可用的MapProxy服务器后，选择MapProxy作为地图提供者
1.输入MapProxy服务URL，例如：http://192.168.145.20/inavmapproxy/service？
1.输入MapProxy服务层（如果从MAPPROXY.md配置，则为inav_layer）
1.完成后，您可以在GPS或“任务控制”选项卡中放大连接互联网时将要飞行的区域，以保存缓存以供离线使用
## 作者

Konstantin Sharlaimov / DigitalEntity-INAV固件和配置器的维护者。

INAV Configurator最初是Cleanflight Configurator的[fork]（＃credits），它支持INAV而不是Cleanflight。

该配置器是唯一支持INAV特定功能的配置器。 可能需要您在飞行控制器上运行最新的固件。
如果遇到任何问题，请确保您正在运行[最新固件版本]（https://github.com/iNavFlight/inav/releases）。

## Notes

### WebGL

确保选中设置->系统->“可用时用户硬件加速”，以实现最佳性能

### Linux用户

1.不要忘记将用户添加到拨出组“ sudo usermod -aG拨出YOUR_USERNAME”中以进行串行访问
2.如果您有3D模型动画问题，请在Chrome标志chrome：// flags /＃ignore-gpu-blacklist中启用“覆盖软件渲染列表”

## Support

GitHub问题跟踪器保留用于错误和其他技术问题。 如果您不知道如何设定
一切，硬件无法正常运行或有任何其他_support_问题，请咨询：

* [rcgroups main thread](https://www.rcgroups.com/forums/showthread.php?2495732-Cleanflight-iNav-(navigation-rewrite)-project)
* [Telegram Group](https://t.me/INAVFlight)

## Issue trackers

对于INAV配置器问题，请在此处提出

https://github.com/iNavFlight/inav-configurator/issues

对于INAV固件问题，请在此处提出

https://github.com/iNavFlight/inav/issues

## Developers

我们接受干净合理的补丁，并将其提交！

## Credits

ctn-Baseflight Configurator的主要作者和维护者。
Hydra-此项目源自Cleanflight Configurator的作者和维护者。