(→YSF Direct Protocol) |
(→Clients known to be working) |
||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
= YSF Direct Protocol = | = YSF Direct Protocol = | ||
| − | The target | + | The target of this protocol is to allow users to connect their SystemFusion YSF-enabled hotspots and repeaters directly to BrandMeister. |
YSF Direct is an extension to existing YSF reflector protocol. | YSF Direct is an extension to existing YSF reflector protocol. | ||
| Line 11: | Line 11: | ||
** Status messages (YSFACK / YSFNACK) | ** Status messages (YSFACK / YSFNACK) | ||
| − | Unused characters in callsign field should be filled with NULL characters. | + | Unused characters in callsign field should be filled with NULL or space characters. |
== Login procedure == | == Login procedure == | ||
| Line 17: | Line 17: | ||
# User -> Server: "YSFL" <10 characters of hotspot/repeater callsign> | # User -> Server: "YSFL" <10 characters of hotspot/repeater callsign> | ||
# Server -> User: "YSFACK" <10 characters of server callsign> <4 bytes of salt> | # Server -> User: "YSFACK" <10 characters of server callsign> <4 bytes of salt> | ||
| − | # User -> Server: "YSFK" <10 characters of hotspot/repeater | + | # User -> Server: "YSFK" <10 characters of hotspot/repeater callsign> <32 bytes of SHA256(salt + password)> |
# Server -> User: "YSFACK" <10 characters of server callsign> | # Server -> User: "YSFACK" <10 characters of server callsign> | ||
| Line 23: | Line 23: | ||
== Change assigned talk group == | == Change assigned talk group == | ||
| + | |||
| + | The message can be sent anytime when hotspot/repeater connected and authenticated. So main purpose for it is to change talk group. We suggest a YSF developers to add it into configuration settings as well to Wires-X menu. | ||
# User -> Server: "YSFO" <10 characters of hotspot/repeater callsign> "group=" <ASCII string contains a talk group number (NULL-termination is optional)> | # User -> Server: "YSFO" <10 characters of hotspot/repeater callsign> "group=" <ASCII string contains a talk group number (NULL-termination is optional)> | ||
| Line 36: | Line 38: | ||
Response: | Response: | ||
<pre>YSFACKSERVERCALL</pre> | <pre>YSFACKSERVERCALL</pre> | ||
| + | <br> | ||
| + | <b>=== Clients known to be working ===</b> | ||
| + | |||
| + | https://github.com/iu5jae/YSFBMGateway | ||
| + | |||
| + | It allows C4FM hotspots and repeaters to connect directly to the Brandmeister Master Server that has the YSF Direct protocol active, logging in with the Callsign and Password set in BM self-care. Allows changing TGs using DTMF, TGs > 5 digits via DG-ID radio, classic connection to YSF rooms via DG-ID. | ||
| + | |||
| + | https://github.com/stefanolande/YSFBMDirect | ||
| + | |||
| + | YSFBMDirect is a software that allows you to access Brandmeister as if it were a YSF reflector. The goal of this software is to build a YSF repeater that can connect to Brandmeister Talk Groups, without losing the possibility to connect to other YSF rooms. | ||
The target of this protocol is to allow users to connect their SystemFusion YSF-enabled hotspots and repeaters directly to BrandMeister.
YSF Direct is an extension to existing YSF reflector protocol.
Unused characters in callsign field should be filled with NULL or space characters.
In case of failure: "YSFNAK" <10 characters of server callsign> <4 bytes of salt>
The message can be sent anytime when hotspot/repeater connected and authenticated. So main purpose for it is to change talk group. We suggest a YSF developers to add it into configuration settings as well to Wires-X menu.
In case of failure: "YSFNAK" <10 characters of server callsign>
Request:
YSFOMYCALLSIGNgroup=91
Response:
YSFACKSERVERCALL
=== Clients known to be working ===
https://github.com/iu5jae/YSFBMGateway
It allows C4FM hotspots and repeaters to connect directly to the Brandmeister Master Server that has the YSF Direct protocol active, logging in with the Callsign and Password set in BM self-care. Allows changing TGs using DTMF, TGs > 5 digits via DG-ID radio, classic connection to YSF rooms via DG-ID.
https://github.com/stefanolande/YSFBMDirect
YSFBMDirect is a software that allows you to access Brandmeister as if it were a YSF reflector. The goal of this software is to build a YSF repeater that can connect to Brandmeister Talk Groups, without losing the possibility to connect to other YSF rooms.
The target if this protocol is to allow users to connect their SystemFusion YSF-enabled hotspots and repeaters directly to BrandMeister.
YSF Direct is an extension to existing YSF reflector protocol.
Unused characters in callsign field should be filled with NULL characters.
In case of failure: "YSFNAK" <10 characters of server callsign> <4 bytes of salt>
In case of failure: "YSFNAK" <10 characters of server callsign>
Request:
YSFOMYCALLSIGNgroup=91
Response:
YSFACKSERVERCALL
BrandMeister