meshtastic/docs/developers/contributing.mdx

62 lines
3.7 KiB
Plaintext
Raw Normal View History

2021-04-11 18:29:30 -07:00
---
2022-04-08 07:29:34 -07:00
id: contributing
title: Contributing
slug: /developers/contributing
2021-04-11 18:29:30 -07:00
---
2021-11-05 19:20:16 -07:00
# How to Help
2022-01-02 22:53:45 -08:00
Meshtastic is a team of volunteers, and as such there is always plenty of ways to help. This project gets great contributions from people in their off hours. Those contributors work on the features they are interested in. It is a very open and welcoming developer community, and we are always looking for help to improve Meshtastic.
2021-11-05 19:20:16 -07:00
- If you're a developer, there's plenty stuff to do. Dig in!
- If you're interacting with Meshtastic radios, we could use help with testing, documenting, and providing feedback.
- If you're into Web Development, check out the different web repos.
- If you're into Kotlin and Android, check out the link to the repo below.
- If you're into Python, check out the link to the repo below
- If you're into Ham Radio and LoRa, then this is a great project for you!
- ... basically... we would love to have your help and feedback
2021-11-05 19:20:16 -07:00
2022-04-08 08:03:47 -07:00
There are several developers, testers, and active users on [Discord](https://discord.gg/ktMAKGBnBs).
2021-12-26 12:06:27 -08:00
There are many technologies (and repositories) used in creating the Meshtastic ecosystem. Below is a breakdown:
## Protocol buffers
2022-10-31 01:31:16 -07:00
Most communication and interactions happen with protocol buffers. The [Meshtastic Protobuf Definitions](https://github.com/meshtastic/protobufs) repo is where all of the protocol buffer changes happen. See the [Protobuf API Reference](/docs/developers/protobufs/api) for more details.
2021-11-05 19:20:16 -07:00
## Firmware
2022-10-31 00:45:47 -07:00
The [firmware](https://github.com/meshtastic/firmware) is where all of the firmware development happens. This is where the code for the ESP32 and nRF52 based devices is developed. It is mainly C and C++ code.Think Arduino. It is where the first level of hardware interaction begins and ends.
2021-12-26 12:06:27 -08:00
2022-04-01 13:28:14 -07:00
## Modules
2022-10-31 00:45:47 -07:00
[Modules](/docs/settings/moduleconfig) are also implemented mainly in the firmware repo above. Typically, you would add functionality in the protobufs repo and the device repo to implement module functionality. You probably also want to have some client/device use/interact with the module and that is where the Device support comes into play.
2021-11-05 19:20:16 -07:00
## Device Support
2022-10-31 01:45:14 -07:00
The [meshtastic/Meshtastic-python](https://github.com/meshtastic/Meshtastic-python) repository is typically where the first device interaction takes place, but that is not a requirement. This repo has a command line utility that allows you to interact with most functionality with the devices. This python library can also be consumed for other applications.
2021-11-05 19:20:16 -07:00
## Web Application
2022-10-31 01:45:14 -07:00
The [meshtastic/web](https://github.com/meshtastic/web) repository is where the hosted web server on the ESP32 devices in Typescript is developed. See the [Web interface overview](/docs/software/web) for more details.
2021-12-26 12:06:27 -08:00
2022-10-31 01:45:14 -07:00
The [meshtastic/meshtastic.js](https://github.com/meshtastic/meshtastic.js) repository is a JavaScript library that provides an interface for Meshtastic devices.
2021-11-05 19:20:16 -07:00
2021-12-26 12:06:27 -08:00
@sachaw has been making tons of progress on the web app and would love help with:
2021-11-07 12:21:05 -08:00
* Saving of preferences
* Better loading state indicators
* Chat scroll lock
* Various module support
2021-11-07 12:21:05 -08:00
2021-11-05 19:20:16 -07:00
## Phone Apps
2021-12-26 12:06:27 -08:00
There are two phone apps that interact with the Meshtastic devices:
2022-10-31 01:45:14 -07:00
- The [meshtastic/Meshtastic-Android](https://github.com/meshtastic/Meshtastic-Android) repository repo contains the Kotlin code for Android based interactions with Meshtastic devices. See [here](/docs/developers/android/build-app) for how to build/create a development environment for the Meshtastic Android App.
- The iOS app is in the process of a complete re-write in Swift and will have the new repo published soon. Note: There are a couple of earlier implementations.
2021-11-05 19:20:16 -07:00
## Documentation
2022-10-31 01:53:15 -07:00
This website is in the [Meshtastic](https://github.com/meshtastic/meshtastic) repository.