Skip to content

Commit 6446e9e

Browse files
davidbuzzdavidbuzz
committed
readme fixes
1 parent 64a54d6 commit 6446e9e

File tree

3 files changed

+54
-47
lines changed

3 files changed

+54
-47
lines changed

‎BUGS.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
BUGS.md
2+
3+
## ARDUPILOT Configurator start minimized, what should I do?
4+
5+
You have to remove `C:\Users%Your_UserNname%\AppData\Local\ARDUPILOT-configurator` folder and all its content.
6+
7+
[https://www.youtube.com/watch?v=XMoULyiFDp4](https://www.youtube.com/watch?v=XMoULyiFDp4)
8+
9+
Alternatively, on Windows with PowerShell you can use `post_install_cleanup.ps1` script that will do the cleaning. (thank you James Cherrill)
10+

‎MAPS.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
MAPS.md
2+
3+
## Different map providers
4+
5+
ARDUPILOT Configurator 2.1 allows to choose between OpenStreetMap, Bing Maps, and MapProxy map providers.
6+
ARDUPILOT Configurator is shipped **WITHOUT** API key for Bing Maps. That means: every user who wants to use Bing Maps has to create own account, agree to all _Terms and Conditions_ required by Bing Maps and configure ARDUPILOT Configuerator by himself.
7+
8+
### How to choose Map provider
9+
10+
1. Click **Settings** icon in the top-right corner of ARDUPILOT Configurator
11+
1. Choose provider: OpenStreetMap, Bing, or MapProxy
12+
1. In the case of Bing Maps, you have to provide your own, personal, generated by you, Bing Maps API key
13+
1. For MapProxy, you need to provide a server URL and layer name to be used
14+
15+
### How to get Bing Maps API key
16+
17+
1. Go to the Bing Maps Dev Center at [https://www.bingmapsportal.com/](https://www.bingmapsportal.com/).
18+
* If you have a Bing Maps account, sign in with the Microsoft account that you used to create the account or create a new one. For new accounts, follow the instructions in [Creating a Bing Maps Account](https://msdn.microsoft.com/library/gg650598.aspx).
19+
1. Select **My keys** under **My Account**.
20+
1. Select the option to create a new key.
21+
1. Provide the following information to create a key:
22+
1. Application name: Required. The name of the application.
23+
1. Application URL: The URL of the application. This is an optional field which is useful in helping you remember the purpose of that key in the future.
24+
1. Key type: Required. Select the key type that you want to create. You can find descriptions of key and application types here.
25+
1. Application type: Required. Select the application type that best represents the application that will use this key. You can find descriptions of key and application types [here](https://www.microsoft.com/maps/create-a-bing-maps-key.aspx).
26+
1. Click the **Create** button. The new key displays in the list of available keys. Use this key to authenticate your Bing Maps application as described in the documentation for the Bing Maps API you are using.
27+
28+
### How to setup a MapProxy server for offline caching and mission planning
29+
1. Follow process described in [MAPPROXY.md](MAPPROXY.md)
30+
1. Test your MapProxy server in web browser, eg: http://192.168.145.20/ARDUPILOTmapproxy/
31+
1. Once you have a working MapProxy server choose MapProxy as your map provider
32+
1. Enter MapProxy service URL, eg: http://192.168.145.20/ARDUPILOTmapproxy/service?
33+
1. Enter MapProxy service layer (ARDUPILOT_layer if configured from MAPPROXY.md)
34+
1. Once completed, you can zoom in on area you will be flying in while connected to the internet in either GPS or Mission Control tab to save the cache for offline use

‎README.md‎

Lines changed: 10 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -14,14 +14,6 @@ Various types of aircraft are supported by the tool and by ARDUPILOT, e.g. quadc
1414
![pic6](https://github.com/davidbuzz/ardu-configurator/blob/master/configurator6.png?raw=true)
1515

1616

17-
## ARDUPILOT Configurator start minimized, what should I do?
18-
19-
You have to remove `C:\Users%Your_UserNname%\AppData\Local\ARDUPILOT-configurator` folder and all its content.
20-
21-
[https://www.youtube.com/watch?v=XMoULyiFDp4](https://www.youtube.com/watch?v=XMoULyiFDp4)
22-
23-
Alternatively, on Windows with PowerShell you can use `post_install_cleanup.ps1` script that will do the cleaning. (thank you James Cherrill)
24-
2517
## Installation
2618

2719
Depending on target operating system, _ARDUPILOT Configurator_ is distributed as _standalone_ application or Chrome App.
@@ -76,47 +68,16 @@ in the `./dist/` directory.
7668
directory. Running this task on macOS or Linux requires Wine, since it's needed to set the icon
7769
for the Windows app. If you don't have Wine installed you can create a release by running the **release-only-linux** task.
7870

79-
## Different map providers
80-
81-
ARDUPILOT Configurator 2.1 allows to choose between OpenStreetMap, Bing Maps, and MapProxy map providers.
82-
ARDUPILOT Configurator is shipped **WITHOUT** API key for Bing Maps. That means: every user who wants to use Bing Maps has to create own account, agree to all _Terms and Conditions_ required by Bing Maps and configure ARDUPILOT Configuerator by himself.
83-
84-
### How to choose Map provider
85-
86-
1. Click **Settings** icon in the top-right corner of ARDUPILOT Configurator
87-
1. Choose provider: OpenStreetMap, Bing, or MapProxy
88-
1. In the case of Bing Maps, you have to provide your own, personal, generated by you, Bing Maps API key
89-
1. For MapProxy, you need to provide a server URL and layer name to be used
90-
91-
### How to get Bing Maps API key
9271

93-
1. Go to the Bing Maps Dev Center at [https://www.bingmapsportal.com/](https://www.bingmapsportal.com/).
94-
* If you have a Bing Maps account, sign in with the Microsoft account that you used to create the account or create a new one. For new accounts, follow the instructions in [Creating a Bing Maps Account](https://msdn.microsoft.com/library/gg650598.aspx).
95-
1. Select **My keys** under **My Account**.
96-
1. Select the option to create a new key.
97-
1. Provide the following information to create a key:
98-
1. Application name: Required. The name of the application.
99-
1. Application URL: The URL of the application. This is an optional field which is useful in helping you remember the purpose of that key in the future.
100-
1. Key type: Required. Select the key type that you want to create. You can find descriptions of key and application types here.
101-
1. Application type: Required. Select the application type that best represents the application that will use this key. You can find descriptions of key and application types [here](https://www.microsoft.com/maps/create-a-bing-maps-key.aspx).
102-
1. Click the **Create** button. The new key displays in the list of available keys. Use this key to authenticate your Bing Maps application as described in the documentation for the Bing Maps API you are using.
72+
## BUGs? absolutely.
10373

104-
### How to setup a MapProxy server for offline caching and mission planning
105-
1. Follow process described in [MAPPROXY.md](MAPPROXY.md)
106-
1. Test your MapProxy server in web browser, eg: http://192.168.145.20/ARDUPILOTmapproxy/
107-
1. Once you have a working MapProxy server choose MapProxy as your map provider
108-
1. Enter MapProxy service URL, eg: http://192.168.145.20/ARDUPILOTmapproxy/service?
109-
1. Enter MapProxy service layer (ARDUPILOT_layer if configured from MAPPROXY.md)
110-
1. Once completed, you can zoom in on area you will be flying in while connected to the internet in either GPS or Mission Control tab to save the cache for offline use
74+
See [BUGS page](https://github.com/davidbuzz/ardu-configurator/blob/master/BUGS.md)
11175

112-
## Authors
11376

114-
Konstantin Sharlaimov/DigitalEntity - maintainer of the ARDUPILOT firmware and configurator.
77+
## Different MAP providers?
11578

116-
ARDUPILOT Configurator was originally a [fork](#credits) of Cleanflight Configurator with support for ARDUPILOT instead of Cleanflight.
79+
See [MAPS page](https://github.com/davidbuzz/ardu-configurator/blob/master/MAPS.md)
11780

118-
This configurator is the only configurator with support for ARDUPILOT specific features. It will likely require that you run the latest firmware on the flight controller.
119-
If you are experiencing any problems please make sure you are running the [latest firmware version](https://github.com/ArduPilot/ardupilot). or from [the firmware server](https://firmware.ardupilot.org/).
12081

12182
## Notes
12283

@@ -150,9 +111,11 @@ https://github.com/ArduPilot/ardupilot/issues
150111

151112
## Developers
152113

153-
We accept clean and reasonable patches, submit them!
114+
We accept clean and reasonable patches or PRs, submit them!
154115

155-
## Credits
116+
## Credits - happy to correct these credits if they are wrong or incomplete.
156117

157-
ctn - primary author and maintainer of Baseflight Configurator.
158-
Hydra - author and maintainer of Cleanflight Configurator from which this project was forked.
118+
ctn - author and maintainer ofof stuff from which this project was forked.
119+
Hydra - author and maintainer of stuff from which this project was forked.
120+
Konstantin Sharlaimov/DigitalEntity - author and maintainer of stuff from which this project was forked.
121+
Paweł Spychalski - author and maintainer of stuff from which this project was forked.

0 commit comments

Comments
 (0)