为 mavlink 做贡献

We follow the Github flow development model.

Contributions are divided into several categories:

  • Complicated changes that require significant review should be initiated using an RFC pull request in mavlink/rfcs. This is primarily intended for new microservice interface definitions, as these require discussion of both messages and message sequences (state machines) (examples: parameter or mission protocol). Depending on the scope of the change, it may also be required when modifying a microservice.
  • Less complex changes should be submitted as a PRs to the mavlink/mavlink repository. This includes message additions/changes that do not affect a state machine.
  • Changes to mavgen generator code should be submitted as PRs to the ArduPilot/Pymavlink repository.

The sections below explain how to contribute to each category and how to raise a pull request.

How to Contribute Simple Changes

How to Contribute Complex Changes

  • Open a pull request against the RFC repository containing a new RFC number https://github.com/mavlink/rfcs and use the template in the 0000 RFC.
  • Reach out to the community on Slack and the mailing list to raise awareness
  • Address concerns by pushing more commits to the pull request

How to Contribute New Programming Language Support

MAVLink generators create MAVLink libraries from the XML definitions for different programming languages (supported language list here).

Support for new programming languages can be added either to the mavgen generator (source code in ArduPilot/pymavlink) or as a stand alone generator.

The broad requirements for inclusion in the project are:

  • Project team should be able to commit to supporting the generator.
  • common.xml and all official dialect XML files should parse, validate, and be able to encode/decode for all the messages.
  • Failures should be handled gracefully (not result in exceptions/segfaults).
  • Enum values that are not explicitly defined in XML should be automatically and sequentially allocated.
  • Test code to validate the above.

Ideally:

  • Libraries should support both MAVLink 2 and MAVLink 1
  • Any message with arbitrary field values can be successfully encoded and decoded.
  • Errors/warnings should be reported for invalid payloads - e.g. oversize, duplicate command or message ids, etc.
  • Deep dialect inclusion/nesting should be supported (minimum is 3 levels).

How to Open a Pull Request

  1. 第一个fork and clone 项目项目。
  2. 在主服务器上创建要素分支

     git 结帐 -b mydescriptivrancanchname
    
> **Note***Always* 分支从主分支的新功能。
  1. 用描述性承诺消息提交您的更改。

  2. Include context information, what was fixed, and an issue number (Github will link these then conveniently)

  3. Example:

    ``` Change the attitude output spec documentation

    • Fixes a typo
    • Clarifies that units are radians

      Fixes issue #123 ```

  4. 测试您的更改 \ (我们可能会要求您在您的 pr 中提供测试结果 )。

  5. 将更改推送到您的存储库:

     git 推送来源 mydescriptisbranchname
    
  1. 发送 pull request 以合并分支中的更改。

Dev Call

We have a regular dev call that is open to anyone who is interested in contributing to the project!

results matching ""

    No results matching ""