2020-11-28 02:40:47 +00:00
|
|
|
syntax = "proto3";
|
|
|
|
|
2020-12-07 11:49:43 +00:00
|
|
|
option java_package = "com.geeksville.mesh";
|
|
|
|
option java_outer_classname = "Portnums";
|
|
|
|
option optimize_for = LITE_RUNTIME;
|
|
|
|
|
2020-11-28 02:40:47 +00:00
|
|
|
/**
|
|
|
|
For any new 'apps' that run on the device or via sister apps on phones/PCs they should pick and use a
|
|
|
|
unique 'portnum' for their application.
|
|
|
|
|
|
|
|
If you are making a new app using meshtastic, please send in a pull request to add your 'portnum' to this
|
|
|
|
master table. PortNums should be assigned in the following range:
|
|
|
|
|
|
|
|
0-63 Core Meshtastic use, do not use for third party apps
|
|
|
|
64-127 Registered 3rd party apps, send in a pull request that adds a new entry to portnums.proto to
|
|
|
|
register your application
|
2020-11-28 05:24:21 +00:00
|
|
|
256-511 Use one of these portnums for your private applications that you don't want to register publically
|
2020-11-28 02:40:47 +00:00
|
|
|
|
|
|
|
All other values are reserved.
|
|
|
|
|
|
|
|
Note: This was formerly a Type enum named 'typ' with the same id #
|
|
|
|
|
|
|
|
We have change to this 'portnum' based scheme for specifying app handlers for particular payloads.
|
|
|
|
This change is backwards compatible by treating the legacy OPAQUE/CLEAR_TEXT values identically.
|
|
|
|
|
|
|
|
*/
|
|
|
|
enum PortNum {
|
2020-12-04 10:32:18 +00:00
|
|
|
/** Deprecated: do not use in new code (formerly called OPAQUE)
|
|
|
|
A message sent from a device outside of the mesh, in a form the mesh
|
|
|
|
does not understand
|
|
|
|
NOTE: This must be 0, because it is documented in IMeshService.aidl to be so
|
|
|
|
*/
|
|
|
|
UNKNOWN_APP = 0;
|
2020-11-28 02:40:47 +00:00
|
|
|
|
2020-12-04 10:32:18 +00:00
|
|
|
/** a simple UTF-8 text message, which even the little micros in the mesh
|
|
|
|
can understand and show on their screen eventually in some circumstances
|
|
|
|
even signal might send messages in this form (see below)
|
|
|
|
Formerly called CLEAR_TEXT */
|
2020-11-28 02:40:47 +00:00
|
|
|
TEXT_MESSAGE_APP = 1;
|
|
|
|
|
2020-12-04 10:32:18 +00:00
|
|
|
/** a message receive acknowledgement, sent in cleartext - allows radio to
|
|
|
|
show user that a message has been read by the recipient, optional
|
|
|
|
|
|
|
|
Note: this concept has been removed for now. Once READACK is implemented, use the
|
|
|
|
new packet type/port number stuff?
|
2020-11-28 04:09:11 +00:00
|
|
|
|
2020-12-04 10:32:18 +00:00
|
|
|
@exclude
|
|
|
|
|
|
|
|
CLEAR_READACK = 2;
|
|
|
|
*/
|
|
|
|
|
2020-12-06 10:32:39 +00:00
|
|
|
/** Reserved for built-in GPIO/example app.
|
|
|
|
See remote_hardware.proto/HardwareMessage for details on the message sent/received to this port number
|
|
|
|
*/
|
|
|
|
REMOTE_HARDWARE_APP = 2;
|
2020-12-05 00:47:06 +00:00
|
|
|
|
2020-12-06 10:32:39 +00:00
|
|
|
/** The built-in position messaging app.
|
|
|
|
See Position for details on the message sent to this port number.
|
|
|
|
*/
|
2020-11-28 10:10:11 +00:00
|
|
|
POSITION_APP = 3;
|
2020-12-04 10:32:18 +00:00
|
|
|
|
2020-12-06 10:32:39 +00:00
|
|
|
/** The built-in user info app.
|
|
|
|
See User for details on the message sent to this port number.
|
|
|
|
*/
|
2020-12-05 01:23:57 +00:00
|
|
|
NODEINFO_APP = 4;
|
2020-11-28 04:09:11 +00:00
|
|
|
|
2020-12-11 00:32:16 +00:00
|
|
|
/** Provides a 'ping' service that replies to any packet it receives. Also this serves as a
|
|
|
|
small example plugin.
|
|
|
|
*/
|
|
|
|
REPLY_APP = 32;
|
|
|
|
|
2020-12-23 09:45:28 +00:00
|
|
|
/** Used for the python IP tunnel feature */
|
|
|
|
IP_TUNNEL_APP = 33;
|
|
|
|
|
2021-01-13 05:53:16 +00:00
|
|
|
/** Provides a hardware serial interface to send and receive from the Meshtastic network.
|
|
|
|
Connect to the RX/TX pins of a device with 38400 8N1. Packets received from the Meshtastic
|
|
|
|
network is forwarded to the RX pin while sending a packet to TX will go out to the Mesh
|
|
|
|
network. Maximum packet size of 240 bytes.
|
|
|
|
|
|
|
|
Plugin is disabled by default can be turned on by setting SERIALPLUGIN_ENABLED = 1 in
|
|
|
|
SerialPlugh.cpp.
|
|
|
|
*/
|
|
|
|
SERIAL_APP = 64;
|
|
|
|
|
2020-12-04 10:32:18 +00:00
|
|
|
/** Private applications should use portnums >= 256. To simplify initial development and testing you can use "PRIVATE_APP"
|
|
|
|
in your code without needing to rebuild protobuf files (via bin/regin_protos.sh) */
|
2020-11-28 04:09:11 +00:00
|
|
|
PRIVATE_APP = 256;
|
2021-01-13 05:53:16 +00:00
|
|
|
}
|