Difference between revisions of "KeyComm Prefix Registry"

From OrbiterWiki
Jump to navigation Jump to search
 
Line 5: Line 5:
 
== How Prefixes Work ==
 
== How Prefixes Work ==
 
From http://orbit.m6.net/Forum/default.aspx?g=posts&t=17569#173759
 
From http://orbit.m6.net/Forum/default.aspx?g=posts&t=17569#173759
<pre>Similar to how IP addresses have masks and subnets, our 2^32 - 2^8 (4,294,967,040, or 0xFFFF FF00) values could be split. Suppose we assume each vessel or add-on would never need more than 2^16 (0xFFFF) values. That leaves 0xFFFF values for the prefix.
+
<pre>Similar to how IP addresses have masks and subnets, our 2^32 - 2^8 (4,294,967,040, or 0xFFFF FF00)  
 +
values could be split. Suppose we assume each vessel or add-on would never need more  
 +
than 2^16 (0xFFFF) values. That leaves 0xFFFF values for the prefix.
  
A particular vessel add-on might have a prefix of 0x39A0. It could accept messages anywhere between 0x39A0 0000 and 0x39A0 FFFF (966,787,072 to 966,852,607). Of course the messages would have to be defined and published for others to use.
+
A particular vessel add-on might have a prefix of 0x39A0. It could accept messages anywhere  
 +
between 0x39A0 0000 and 0x39A0 FFFF (966,787,072 to 966,852,607). Of course the messages would  
 +
have to be defined and published for others to use.
  
Of course the lower prefix of 0x0000 might be reserved for the keyboard commands and some generic vessel requests, such as "What is your prefix?" and "Do you support <Name> feature?"</pre>
+
Of course the lower prefix of 0x0000 might be reserved for the keyboard commands and some generic  
 +
vessel requests, such as "What is your prefix?" and "Do you support <Name> feature?"</pre>
  
 
== Prefix List ==
 
== Prefix List ==

Revision as of 13:27, 5 December 2007

This page holds the self-assigned prefixes for use in a KeyComm based add-ons.

Add-on makers are encouraged to take as few prefixes as required, typically one per add-on.

How Prefixes Work

From http://orbit.m6.net/Forum/default.aspx?g=posts&t=17569#173759

Similar to how IP addresses have masks and subnets, our 2^32 - 2^8 (4,294,967,040, or 0xFFFF FF00) 
values could be split. Suppose we assume each vessel or add-on would never need more 
than 2^16 (0xFFFF) values. That leaves 0xFFFF values for the prefix.

A particular vessel add-on might have a prefix of 0x39A0. It could accept messages anywhere 
between 0x39A0 0000 and 0x39A0 FFFF (966,787,072 to 966,852,607). Of course the messages would 
have to be defined and published for others to use.

Of course the lower prefix of 0x0000 might be reserved for the keyboard commands and some generic 
vessel requests, such as "What is your prefix?" and "Do you support <Name> feature?"

Prefix List

Please help keep this list ordered by prefix. Also please use hex notation for the prefixes.

Please only reserve a prefix in this table when you have started a legitimate add-on requiring KeyComm. As of December 5, 2007, KeyComm is only an idea, so generally no one should need to reserve a prefix until at least an alpha release of KeyComm. (An exception is made for Hielor, who came up with the technique.)

Prefix Add-on
0x0000 Reserved for generic messages
0x0001 Hielor Reservation
0xFFFF Reserved for generic messages