motorcortex-python 1.0.3__tar.gz → 1.2.0__tar.gz

{motorcortex_python-1.0.3/motorcortex_python.egg-info → motorcortex_python-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: motorcortex-python
-Version: 1.0.3
+Version: 1.2.0
 Summary: Python bindings for Motorcortex Engine
 Home-page: https://www.motorcortex.io
 Author: Alexey Zakharov
@@ -90,6 +90,24 @@ finally:
 
 The URL grammar accepts IPv4, hostnames, and IPv6 literals both with and without explicit ports — e.g. `wss://host`, `wss://host:5568:5567`, `wss://[::1]`, `wss://[fe80::1]:5568:5567`.
 
+### Unsubscribing and closing
+
+- **`sub.unsubscribe(subscription)`** is the precise control: it removes
+  one group from the server and stops its updates. Use it whenever your
+  application is done with a specific group but keeps running.
+- **`sub.close()`** ends the subscribe connection for good and
+  best-effort-removes any groups you didn't unsubscribe (so a churned
+  `Subscribe` doesn't leave stale groups loading the server). `close()`
+  is terminal — a closed `Subscribe` cannot be reconnected; create a new
+  one (or a new `Session`) instead. Calling `connect()` on a closed
+  `Subscribe` resolves to `False`, it never raises.
+
+If the subscribe connection drops, the library silently redials in the
+background and fires your `state_update` callback with
+`CONNECTION_LOST` / `CONNECTION_OK`. After a reconnect, call
+`sub.resubscribe()` to restore your groups — `motorcortex.connect()`'s
+default reconnect handler already does this for you.
+
 ## Documentation
 
 - **[API reference — `docs/_index.md`](docs/_index.md)** — flat, method-by-method reference for every public class and function. Regenerated from the docstrings via `pydoc-markdown`.

{motorcortex_python-1.0.3 → motorcortex_python-1.2.0}/README.md

@@ -65,6 +65,24 @@ finally:
 
 The URL grammar accepts IPv4, hostnames, and IPv6 literals both with and without explicit ports — e.g. `wss://host`, `wss://host:5568:5567`, `wss://[::1]`, `wss://[fe80::1]:5568:5567`.
 
+### Unsubscribing and closing
+
+- **`sub.unsubscribe(subscription)`** is the precise control: it removes
+  one group from the server and stops its updates. Use it whenever your
+  application is done with a specific group but keeps running.
+- **`sub.close()`** ends the subscribe connection for good and
+  best-effort-removes any groups you didn't unsubscribe (so a churned
+  `Subscribe` doesn't leave stale groups loading the server). `close()`
+  is terminal — a closed `Subscribe` cannot be reconnected; create a new
+  one (or a new `Session`) instead. Calling `connect()` on a closed
+  `Subscribe` resolves to `False`, it never raises.
+
+If the subscribe connection drops, the library silently redials in the
+background and fires your `state_update` callback with
+`CONNECTION_LOST` / `CONNECTION_OK`. After a reconnect, call
+`sub.resubscribe()` to restore your groups — `motorcortex.connect()`'s
+default reconnect handler already does this for you.
+
 ## Documentation
 
 - **[API reference — `docs/_index.md`](docs/_index.md)** — flat, method-by-method reference for every public class and function. Regenerated from the docstrings via `pydoc-markdown`.

{motorcortex_python-1.0.3 → motorcortex_python-1.2.0}/motorcortex/__init__.py

@@ -286,7 +286,7 @@ def connect(
             state_update (Callable, optional): Custom callback for connection state changes.
                 If provided, disables the built-in reconnect logic.
             req_number_of_threads (int, optional): Thread pool size for request connection. Defaults to 2.
-            sub_number_of_threads (int, optional): Thread pool size for subscribe connection. Defaults to 2.
+            sub_number_of_threads (int, optional): Thread pool size for subscribe connection. Defaults to 2, clamped up to the minimum of 4 that ``Subscribe`` requires (connect worker, recv loop, reconnect loop, subscription updaters).
 
     Returns:
         tuple: (req, sub)

{motorcortex_python-1.0.3 → motorcortex_python-1.2.0}/motorcortex/_request_utils.py

@@ -19,6 +19,7 @@ import hashlib
 import json
 import os
 import tempfile
+import zlib
 from threading import Event
 from typing import Any, Callable, Optional, Tuple
 
@@ -135,6 +136,26 @@ def fetch_parameter_tree(
     Returns:
         A ``ParameterTreeMsg`` — either the cached one or the freshly
         fetched one (also persisted to the cache).
+
+    On a cache miss, a compressed tree is tried first
+    (``motorcortex-core >= 2.36.0``): a single zlib/deflate blob,
+    typically 7-13x smaller than the plain reply. The server deflates
+    the *full wire reply* — a 4-byte little-endian type-hash prefix
+    followed by the ``ParameterTreeMsg`` body, same as any other RPC
+    reply — so the inflated blob goes through the canonical
+    ``MessageTypes.decode()``, which strips the prefix and resolves the
+    type by hash. Any failure — timeout on an old server that silently
+    drops the unrecognised request hash, a non-OK status from a
+    2.36.1-2.38 core, an unknown or unexpected type hash, or an
+    inflate/parse error — falls through to the plain
+    ``GetParameterTreeMsg`` request. Both paths decode to the same
+    ``ParameterTreeMsg`` type, so callers (and the cache write below)
+    can't tell the difference. Tried for every URL scheme (ipc, tcp,
+    ws, tls+tcp, wss) — the request is just bytes over
+    :func:`send_and_recv`. ``send_and_recv`` in this repo has no
+    per-call timeout knob, so on an old server the compressed attempt
+    costs at most one ``recv_timeout`` (the socket's own) before
+    falling back.
     """
     path = parameter_tree_cache_path(url, tree_hash)
     cached = load_parameter_tree_file(path, protobuf_types)
@@ -143,6 +164,42 @@ def fetch_parameter_tree(
         return cached
     logger.debug("[REQUEST] Failed to find parameter tree in the cache")
 
+    try:
+        compressed_request = protobuf_types.createType(
+            "motorcortex.GetParameterTreeCompressedMsg")
+        compressed_reply = send_and_recv(
+            socket, protobuf_types.encode(compressed_request), protobuf_types)
+        if compressed_reply is not None \
+                and getattr(compressed_reply, "status", 1) == 0 \
+                and getattr(compressed_reply, "compressed", b""):
+            # The server deflates the *full wire reply* here, not a bare
+            # ParameterTreeMsg: inflating yields the same hash-prefixed
+            # framing every other RPC reply uses (matches the message's
+            # own docstring: "the exact bytes a GetParameterTreeMsg reply
+            # carries"). Run it through the canonical decode() — which
+            # strips the type-hash prefix and resolves the type by hash —
+            # instead of ParseFromString on the raw blob; parsing the blob
+            # directly is exactly the bug this branch used to have: the
+            # prefix corrupted every parse and silently forced the plain
+            # fallback. An unknown hash (KeyError in decode) or a decode
+            # to some other type falls through to the plain request rather
+            # than caching garbage as a ParameterTreeMsg.
+            tree_msg = protobuf_types.decode(
+                zlib.decompress(compressed_reply.compressed))
+            decoded_name = getattr(
+                getattr(tree_msg, "DESCRIPTOR", None), "full_name", None)
+            if decoded_name != "motorcortex.ParameterTreeMsg":
+                raise ValueError(
+                    "compressed tree decoded to unexpected type "
+                    f"{decoded_name or type(tree_msg).__name__}")
+            logger.debug("[REQUEST] parameter tree fetched compressed")
+            return save_parameter_tree_file(path, tree_msg)
+    except Exception as e:
+        logger.debug(
+            "[REQUEST] compressed tree unavailable (%s: %s) — falling back to plain",
+            type(e).__name__, e,
+        )
+
     request_msg = protobuf_types.createType("motorcortex.GetParameterTreeMsg")
     handle = send_and_recv(socket, protobuf_types.encode(request_msg), protobuf_types)
     return save_parameter_tree_file(path, handle)

motorcortex_python-1.2.0/motorcortex/_sp_stream.py

@@ -0,0 +1,331 @@
+#!/usr/bin/python3
+#
+#   Developer: Alexey Zakharov (alexey.zakharov@vectioneer.com)
+#   All rights reserved. Copyright (c) 2016-2026 VECTIONEER.
+#
+"""Stream-based SP (nanomsg) pub/sub client transport.
+
+Replaces the pynng ``Sub0`` socket for the subscribe data channel so the
+client can send the routing hello as the first upstream message — a raw
+``nng_stream`` has no protocol layer, so we speak the SP wire format
+ourselves. Uses only pynng's bundled cffi bindings (``pynng._nng``): the
+full public ``nng_stream_* / nng_aio_*`` API ships in every pynng wheel.
+
+Wire format per scheme (mirrors motorcortex-cpp src/sp_stream.cpp, which
+is the proven reference — see its comments for the full rationale):
+
+- ws/wss:    subprotocol ``pub.sp.nanomsg.org`` on the HTTP upgrade;
+             message mode — one send/recv is one SP message, no length
+             prefix, no byte handshake.
+- tcp/tls:   8-byte handshake ``\\x00SP\\x00`` + u16-BE proto + u16-BE 0
+             (we announce 33/sub, require peer 32/pub), then each message
+             is a u64-BE length prefix + body.
+- ipc:       same handshake, but a 9-byte per-message header: type byte
+             ``0x01`` + u64-BE length. The type byte is load-bearing.
+
+nng 1.11.0 caveat (learned in cpp): never ``nng_aio_cancel`` an aio on a
+raw TLS stream — it crashes ``nng_stream_close`` intermittently. This
+implementation never cancels: every aio is owned by exactly one blocking
+call which waits for it to finish (success, error, or timeout) before
+freeing it. Closing the stream from another thread makes a pending recv
+finish with an error, which is the supported wakeup path.
+
+Stream lifetime vs. concurrent close(): a bare local capture of
+``self._stream`` before an nng call is not enough — close() both nulls
+the attribute *and* frees the underlying stream, so a racing capture can
+still end up handing a freed pointer to nng between close()'s two steps.
+Every blocking nng call therefore goes through ``_issue()``, which
+captures the stream, increments ``_io_inflight``, AND actually calls
+``nng_stream_send``/``nng_stream_recv`` — all under ``_io_cond`` in one
+atomic step (not just the capture: an earlier version issued the nng
+call *after* releasing the lock, which left a window where
+``nng_stream_close`` could run first and the op would then be issued
+against an already-closed stream — nng accepts that silently and never
+completes it, hanging ``nng_aio_wait`` forever when the aio has no
+timeout of its own, i.e. exactly ``recv_msg()``'s default). close() sets
+``_closing``/nulls ``self._stream`` under the same lock, calls
+``nng_stream_close`` (which wakes any pending aio — pending meaning
+already issued, which ``_issue()`` now guarantees), and only frees the
+stream once ``_io_inflight`` drops back to zero. That ordering — close,
+then wait for in-flight callers to finish with the local pointer they
+already captured, then free — is what makes the free race-free without
+ever touching ``nng_aio_cancel``.
+"""
+
+import struct
+import threading
+from typing import Optional
+
+from pynng._nng import ffi, lib  # type: ignore[import-untyped]
+from pynng.exceptions import check_err  # type: ignore[import-untyped]
+
+from motorcortex.setup_logger import logger
+
+_SP_PROTO_SUB = 33
+_SP_PROTO_PUB = 32
+_HANDSHAKE_LEN = 8
+
+#: One recv buffer per stream in ws message mode. nng's ws transport caps
+#: read-ahead at one frame and the server pipe buffer is 1 MiB, so a
+#: larger message cannot arrive whole (it would be truncated server-side
+#: first). Mirrors WS_MAX_MSG in cpp sp_stream.h.
+WS_MAX_MSG = 1 << 20
+
+#: Refuse absurd length prefixes on byte-stream schemes (64 MiB).
+_MAX_BODY = 1 << 26
+
+
+class SpStreamError(Exception):
+    """Transport-level failure on the SP stream."""
+
+
+class SpProtocolError(SpStreamError):
+    """Peer completed the byte handshake but is not an SP pub (32)."""
+
+
+def _tls_pointer(tls_config):
+    """Raw ``nng_tls_config *`` out of a pynng TLSConfig.
+
+    ``TLSConfig._tls_config`` is private but stable across pynng 0.9.x;
+    isolate the access here so a pynng bump touches one line.
+    """
+    return tls_config._tls_config
+
+
+def _alloc_aio(timeout_ms: int):
+    ap = ffi.new("nng_aio **")
+    check_err(lib.nng_aio_alloc(ap, ffi.NULL, ffi.NULL))
+    aio = ap[0]
+    lib.nng_aio_set_timeout(aio, timeout_ms if timeout_ms > 0 else -1)
+    return aio
+
+
+class SpStream:
+    def __init__(self) -> None:
+        self._dialer = None
+        self._stream = None
+        self._ws_mode = False
+        self._ipc_mode = False
+        self._recv_buf = None  # allocated lazily in Task 2
+        # Guards the stream-lifetime TOCTOU between a live nng call and a
+        # concurrent close(); see the module docstring.
+        self._io_cond = threading.Condition()
+        self._io_inflight = 0
+        self._closing = False
+
+    @property
+    def connected(self) -> bool:
+        return self._stream is not None
+
+    def connect(self, url: str, tls_config=None, timeout_ms: int = 5000) -> None:
+        """Dial + (non-ws) SP handshake. Raises on any failure; the
+        stream is fully closed again before an exception propagates."""
+        self.close()
+        # Re-arm under _io_cond, only after close() fully completed, so
+        # the flag flip is atomic against a concurrent close()'s own
+        # locked ``_closing = True`` transition (a close() racing the
+        # reopen after this point is caught by Subscribe's ``_closed``
+        # re-checks, which close any stream dialed past it).
+        with self._io_cond:
+            self._closing = False
+        self._ws_mode = url.startswith("ws://") or url.startswith("wss://")
+        self._ipc_mode = url.startswith("ipc://")
+
+        dp = ffi.new("nng_stream_dialer **")
+        check_err(lib.nng_stream_dialer_alloc(dp, url.encode()))
+        self._dialer = dp[0]
+        try:
+            if self._ws_mode:
+                # mcxpub0 keeps stock pub0's SP wire name, so every
+                # existing client's subprotocol offer is accepted.
+                check_err(lib.nng_stream_dialer_set_string(
+                    self._dialer, b"ws:protocol", b"pub.sp.nanomsg.org"))
+            if tls_config is not None:
+                check_err(lib.nng_stream_dialer_set_ptr(
+                    self._dialer, b"tls-config", _tls_pointer(tls_config)))
+
+            aio = _alloc_aio(timeout_ms)
+            lib.nng_stream_dialer_dial(self._dialer, aio)
+            lib.nng_aio_wait(aio)
+            rv = lib.nng_aio_result(aio)
+            if rv == 0:
+                self._stream = ffi.cast(
+                    "nng_stream *", lib.nng_aio_get_output(aio, 0))
+            lib.nng_aio_free(aio)
+            check_err(rv)
+
+            if not self._ws_mode:
+                self._handshake(timeout_ms)
+        except Exception:
+            self.close()
+            raise
+
+    def _handshake(self, timeout_ms: int) -> None:
+        ours = b"\x00SP\x00" + struct.pack(">H", _SP_PROTO_SUB) + b"\x00\x00"
+        self._io(True, ours, timeout_ms)
+        peer = self._io(False, _HANDSHAKE_LEN, timeout_ms)
+        expected = b"\x00SP\x00" + struct.pack(">H", _SP_PROTO_PUB) + b"\x00\x00"
+        if peer[:6] != expected[:6]:
+            raise SpProtocolError(
+                f"peer is not an SP pub socket (got {peer!r})")
+
+    def send_msg(self, data: bytes, timeout_ms: int = 2000) -> None:
+        if self._stream is None:
+            raise SpStreamError("send on a closed SpStream")
+        if self._ws_mode:
+            self._io(True, data, timeout_ms)  # message mode: 1 send = 1 msg
+            return
+        prefix = struct.pack(">Q", len(data))
+        if self._ipc_mode:
+            prefix = b"\x01" + prefix  # load-bearing type byte
+        self._io(True, prefix, timeout_ms)
+        self._io(True, data, timeout_ms)
+
+    def _issue(self, op, buf, offset: int, length: int, timeout_ms: int):
+        """Allocate an aio, set its iov, and hand it to ``op`` (a raw
+        ``nng_stream_send``/``nng_stream_recv`` — the *call*, not just
+        the registration) — all atomically under ``_io_cond``.
+
+        This has to be one critical section, not "capture the stream,
+        release the lock, then call ``op``" (the original shape): a
+        concurrent ``close()`` also serializes on ``_io_cond`` for its
+        own ``_closing = True`` transition, so whichever of the two
+        critical sections runs first fully determines a safe outcome —
+        either the op is issued while the stream is still known-open
+        (and ``close()``'s later ``nng_stream_close()`` correctly wakes
+        it, per nng's contract for *already-registered* ops), or
+        ``close()`` has already flipped ``_closing`` and this call bails
+        out before ever touching nng. The two-step version left a gap
+        between "session granted" / "op actually issued" that
+        ``close()`` could land in: ``nng_stream_close()`` running before
+        ``nng_stream_recv()``/``nng_stream_send()`` for that same aio
+        leaves it waiting forever — with a finite ``timeout_ms`` the
+        aio's own timer eventually rescues it, but ``recv_msg()``'s
+        default infinite timeout (the receive loop's steady state) has
+        no such backstop, so this used to hang the process instead of
+        surfacing the intended "stream closed" `None`.
+
+        Raises ``SpStreamError`` (stream already closing/closed) or lets
+        an ``nng_aio_set_iov`` failure propagate — in both cases nothing
+        was issued and ``_io_inflight`` was never incremented, so the
+        caller has nothing to undo. On success returns the aio with
+        ``_io_inflight`` already bumped; the caller owns freeing it and
+        decrementing the counter once the op settles.
+        """
+        with self._io_cond:
+            if self._closing or self._stream is None:
+                raise SpStreamError("stream closed mid-transfer")
+            stream = self._stream
+            aio = _alloc_aio(timeout_ms)
+            try:
+                iov = ffi.new("nng_iov *")
+                iov.iov_buf = buf + offset
+                iov.iov_len = length
+                check_err(lib.nng_aio_set_iov(aio, 1, iov))
+            except Exception:
+                lib.nng_aio_free(aio)
+                raise
+            self._io_inflight += 1
+            op(stream, aio)
+        return aio
+
+    def _settle(self, aio):
+        """Wait for an ``_issue()``-returned aio outside the lock (the
+        blocking part must never hold ``_io_cond`` — that would stall
+        ``close()``'s own attempt to grab it), then release the
+        in-flight slot. Returns ``(rv, got)``."""
+        try:
+            lib.nng_aio_wait(aio)
+            rv = lib.nng_aio_result(aio)
+            got = lib.nng_aio_count(aio) if rv == 0 else 0
+        finally:
+            lib.nng_aio_free(aio)
+            with self._io_cond:
+                self._io_inflight -= 1
+                self._io_cond.notify_all()
+        return rv, got
+
+    def _io(self, is_send: bool, data_or_len, timeout_ms: int):
+        """Blocking send of ``bytes`` / recv of exactly N bytes.
+        One aio per call; always waited on, never cancelled. Every nng
+        call is issued via ``_issue()`` so it can't race a concurrent
+        close() into hanging (see its docstring)."""
+        if is_send:
+            buf = ffi.new("uint8_t[]", bytes(data_or_len))
+            need = len(data_or_len)
+        else:
+            need = int(data_or_len)
+            buf = ffi.new("uint8_t[]", need)
+        op = lib.nng_stream_send if is_send else lib.nng_stream_recv
+        done = 0
+        while done < need:
+            aio = self._issue(op, buf, done, need - done, timeout_ms)
+            rv, got = self._settle(aio)
+            if rv != 0:
+                check_err(rv)
+            if got == 0:
+                raise SpStreamError("stream closed mid-transfer")
+            done += got
+        return None if is_send else bytes(ffi.buffer(buf, need))
+
+    def recv_msg(self, timeout_ms: int = -1) -> Optional[bytes]:
+        """Block for one whole SP message.
+
+        Returns ``None`` when the stream is closed/dead (remote close,
+        local close() from another thread, desync) — the receive loop's
+        exit signal. The ws invariant (nng caps ws read-ahead at one
+        frame) means one recv into a WS_MAX_MSG buffer is exactly one
+        message; byte-stream schemes reassemble via the length prefix.
+        """
+        if self._stream is None:
+            return None
+        try:
+            if self._ws_mode:
+                return self._recv_ws(timeout_ms)
+            hdr_len = 9 if self._ipc_mode else 8
+            hdr = self._io(False, hdr_len, timeout_ms)
+            if self._ipc_mode:
+                if hdr[0] != 0x01:
+                    logger.error("[SPSTREAM] ipc type-byte desync (0x%02x)", hdr[0])
+                    return None
+                hdr = hdr[1:]
+            (length,) = struct.unpack(">Q", hdr)
+            if length == 0 or length > _MAX_BODY:
+                logger.error("[SPSTREAM] absurd frame length %d — desync", length)
+                return None
+            return self._io(False, length, timeout_ms)
+        except Exception as e:
+            logger.debug("[SPSTREAM] recv_msg terminating: %s", e)
+            return None
+
+    def _recv_ws(self, timeout_ms: int) -> Optional[bytes]:
+        if self._recv_buf is None:
+            self._recv_buf = ffi.new("uint8_t[]", WS_MAX_MSG)
+        try:
+            aio = self._issue(lib.nng_stream_recv, self._recv_buf, 0, WS_MAX_MSG, timeout_ms)
+        except Exception:
+            return None
+        rv, got = self._settle(aio)
+        if rv != 0 or got == 0:
+            return None
+        return bytes(ffi.buffer(self._recv_buf, got))
+
+    def close(self) -> None:
+        with self._io_cond:
+            self._closing = True
+            stream, self._stream = self._stream, None
+            dialer, self._dialer = self._dialer, None
+        if stream is not None:
+            lib.nng_stream_close(stream)  # wakes any pending recv/send
+            # Wait for every in-flight _issue()/_settle() caller to
+            # finish with the (now-closed, error-returning) stream
+            # pointer it already captured before we free it — this is
+            # what makes the free race-free; see module docstring and
+            # _issue()'s docstring for why issuing the op is folded into
+            # the same critical section as this ``_closing`` flip.
+            with self._io_cond:
+                while self._io_inflight > 0:
+                    self._io_cond.wait()
+            lib.nng_stream_free(stream)
+        if dialer is not None:
+            lib.nng_stream_dialer_free(dialer)

{motorcortex_python-1.0.3 → motorcortex_python-1.2.0}/motorcortex/motorcortex_hash.json

@@ -43,6 +43,14 @@
         "type": "motorcortex.SessionTokenMsg",
         "hash": "0x7c3e91ab"
     },
+    {
+        "type": "motorcortex.GetSubCookieMsg",
+        "hash": "0x5505c0b0"
+    },
+    {
+        "type": "motorcortex.SubCookieMsg",
+        "hash": "0x90ff084b"
+    },
     {
         "type": "motorcortex.RestoreSessionMsg",
         "hash": "0x8aef888a"
@@ -67,6 +75,14 @@
         "type": "motorcortex.ParameterTreeHashMsg",
         "hash": "0xc8cef26b"
     },
+    {
+        "type": "motorcortex.GetParameterTreeCompressedMsg",
+        "hash": "0x2347001b"
+    },
+    {
+        "type": "motorcortex.CompressedParameterTreeMsg",
+        "hash": "0x769fb6e8"
+    },
     {
         "type": "motorcortex.CreateGroupMsg",
         "hash": "0x9eab1b83"
@@ -149,7 +165,7 @@
     },
     {
         "type": "motorcortex.StatusCode",
-        "hash": "0xd785e9fa"
+        "hash": "0x6a1f3a02"
     },
     {
         "type": "motorcortex.ErrorLevel",

motorcortex_python-1.2.0/motorcortex/motorcortex_pb2.py

@@ -0,0 +1,113 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: motorcortex.proto
+"""Generated protocol buffer code."""
+from google.protobuf.internal import builder as _builder
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x11motorcortex.proto\x12\x0bmotorcortex\"i\n\x0fParameterOffset\x12\x36\n\x04type\x18\x01 \x02(\x0e\x32\x17.motorcortex.OffsetType:\x0fOFFSET_ELEMENTS\x12\x0e\n\x06offset\x18\x02 \x02(\r\x12\x0e\n\x06length\x18\x03 \x02(\r\"f\n\x05\x45rror\x12\x11\n\ttimestamp\x18\x01 \x02(\x06\x12\x14\n\x0c\x65rror_number\x18\x02 \x02(\x07\x12\x13\n\x0b\x65rror_level\x18\x03 \x02(\x07\x12\x11\n\tsubsystem\x18\x04 \x02(\x07\x12\x0c\n\x04info\x18\x05 \x02(\x07\"a\n\tErrorList\x12\"\n\x06\x65rrors\x18\x01 \x03(\x0b\x32\x12.motorcortex.Error\x12\x18\n\x10number_of_errors\x18\x02 \x02(\x07\x12\x16\n\x0eupdate_counter\x18\x03 \x02(\x07\"\x8a\x02\n\rParameterInfo\x12\n\n\x02id\x18\x01 \x02(\r\x12\x11\n\tdata_type\x18\x02 \x02(\r\x12\x11\n\tdata_size\x18\x03 \x02(\r\x12\x1a\n\x12number_of_elements\x18\x04 \x02(\r\x12\r\n\x05\x66lags\x18\x05 \x02(\r\x12\x13\n\x0bpermissions\x18\x06 \x02(\r\x12.\n\nparam_type\x18\x07 \x02(\x0e\x32\x1a.motorcortex.ParameterType\x12(\n\x08group_id\x18\x08 \x02(\x0e\x32\x16.motorcortex.UserGroup\x12\x1f\n\x04unit\x18\t \x02(\x0e\x32\x11.motorcortex.Unit\x12\x0c\n\x04path\x18\n \x02(\t\"\x94\x01\n\x12GroupParameterInfo\x12\r\n\x05index\x18\x01 \x02(\r\x12\x0e\n\x06offset\x18\x02 \x02(\r\x12\x0c\n\x04size\x18\x03 \x02(\r\x12(\n\x04info\x18\x04 \x02(\x0b\x32\x1a.motorcortex.ParameterInfo\x12\'\n\x06status\x18\x05 \x02(\x0e\x32\x17.motorcortex.StatusCode\"1\n\x06Header\x12\x14\n\x0c\x66rameCounter\x18\x01 \x02(\x07\x12\x11\n\ttimestamp\x18\x02 \x02(\x06\"Z\n\x08GroupMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12)\n\x06params\x18\x02 \x03(\x0b\x32\x19.motorcortex.ParameterMsg\"Y\n\tStatusMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\'\n\x06status\x18\x02 \x02(\x0e\x32\x17.motorcortex.StatusCode\"P\n\x08LoginMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05login\x18\x02 \x02(\t\x12\x10\n\x08password\x18\x03 \x02(\t\"9\n\x12GetSessionTokenMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"n\n\x0fSessionTokenMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05token\x18\x02 \x02(\t\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"6\n\x0fGetSubCookieMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"l\n\x0cSubCookieMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0e\n\x06\x63ookie\x18\x02 \x02(\t\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"G\n\x11RestoreSessionMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05token\x18\x02 \x02(\t\"0\n\tLogoutMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\":\n\x13GetParameterTreeMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"\x9a\x01\n\x10ParameterTreeMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12*\n\x06params\x18\x02 \x03(\x0b\x32\x1a.motorcortex.ParameterInfo\x12\x0c\n\x04hash\x18\x03 \x02(\r\x12\'\n\x06status\x18\x04 \x02(\x0e\x32\x17.motorcortex.StatusCode\">\n\x17GetParameterTreeHashMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"r\n\x14ParameterTreeHashMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04hash\x18\x02 \x02(\r\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"D\n\x1dGetParameterTreeCompressedMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\"\xa7\x01\n\x1a\x43ompressedParameterTreeMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x12\n\ncompressed\x18\x02 \x02(\x0c\x12\x19\n\x11uncompressed_size\x18\x03 \x02(\r\x12\x0c\n\x04hash\x18\x04 \x02(\r\x12\'\n\x06status\x18\x05 \x02(\x0e\x32\x17.motorcortex.StatusCode\"h\n\x0e\x43reateGroupMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x13\n\x0b\x66rq_divider\x18\x02 \x02(\r\x12\r\n\x05\x61lias\x18\x03 \x02(\t\x12\r\n\x05paths\x18\x04 \x03(\t\"\xaa\x01\n\x0eGroupStatusMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\n\n\x02id\x18\x02 \x02(\r\x12\r\n\x05\x61lias\x18\x03 \x02(\t\x12/\n\x06params\x18\x04 \x03(\x0b\x32\x1f.motorcortex.GroupParameterInfo\x12\'\n\x06status\x18\x05 \x02(\x0e\x32\x17.motorcortex.StatusCode\"D\n\x0eRemoveGroupMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05\x61lias\x18\x02 \x02(\t\"D\n\x0fGetParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\"\x95\x01\n\x0cParameterMsg\x12\r\n\x05value\x18\x01 \x02(\x0c\x12#\n\x06header\x18\x02 \x01(\x0b\x32\x13.motorcortex.Header\x12(\n\x04info\x18\x03 \x01(\x0b\x32\x1a.motorcortex.ParameterInfo\x12\'\n\x06status\x18\x04 \x02(\x0e\x32\x17.motorcortex.StatusCode\"h\n\x13GetParameterListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06params\x18\x02 \x03(\x0b\x32\x1c.motorcortex.GetParameterMsg\"\x8b\x01\n\x10ParameterListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12)\n\x06params\x18\x02 \x03(\x0b\x32\x19.motorcortex.ParameterMsg\x12\'\n\x06status\x18\x03 \x02(\x0e\x32\x17.motorcortex.StatusCode\"\x81\x01\n\x0fSetParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06offset\x18\x02 \x01(\x0b\x32\x1c.motorcortex.ParameterOffset\x12\x0c\n\x04path\x18\x03 \x02(\t\x12\r\n\x05value\x18\x04 \x02(\x0c\"h\n\x13SetParameterListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06params\x18\x02 \x03(\x0b\x32\x1c.motorcortex.SetParameterMsg\"\x99\x01\n\x15OverwriteParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12,\n\x06offset\x18\x02 \x01(\x0b\x32\x1c.motorcortex.ParameterOffset\x12\x10\n\x08\x61\x63tivate\x18\x03 \x02(\x08\x12\x0c\n\x04path\x18\x04 \x02(\t\x12\r\n\x05value\x18\x05 \x02(\x0c\"H\n\x13ReleaseParameterMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\"O\n\x07SaveMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\x12\x11\n\tfile_name\x18\x03 \x02(\t\"O\n\x07LoadMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\x0c\n\x04path\x18\x02 \x02(\t\x12\x11\n\tfile_name\x18\x03 \x02(\t\"C\n\rConsoleCmdMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12\r\n\x05value\x18\x02 \x02(\t\"b\n\x11\x43onsoleCmdListMsg\x12#\n\x06header\x18\x01 \x01(\x0b\x32\x13.motorcortex.Header\x12(\n\x04\x63mds\x18\x02 \x03(\x0b\x32\x1a.motorcortex.ConsoleCmdMsg*\xab\x02\n\x04Unit\x12\x12\n\x0eunit_undefined\x10\x00\x12\n\n\x06Length\x10\x0f\x12\x06\n\x02mm\x10\x01\x12\x05\n\x01m\x10\x02\x12\n\n\x05\x41ngle\x10\xf1\x01\x12\x07\n\x03rad\x10\x31\x12\x07\n\x03\x64\x65g\x10\x41\x12\t\n\x04Time\x10\xf2\x01\x12\x0b\n\x07nanosec\x10\x12\x12\x0c\n\x08microsec\x10\"\x12\x0c\n\x08millisec\x10\x32\x12\x07\n\x03sec\x10\x42\x12\x0b\n\x06Weight\x10\xf3\x01\x12\x08\n\x04gram\x10\x13\x12\x06\n\x02kg\x10#\x12\r\n\x08Velocity\x10\xf4\x01\x12\t\n\x05m_sec\x10\x14\x12\x0b\n\x07rad_sec\x10$\x12\x11\n\x0c\x41\x63\x63\x65leration\x10\xf5\x01\x12\n\n\x06m_sec2\x10\x15\x12\x0c\n\x08rad_sec2\x10%\x12\n\n\x05\x46orce\x10\xf6\x01\x12\x05\n\x01N\x10\x16\x12\x06\n\x02Nm\x10&\x12\x0b\n\x07percent\x10\x17*_\n\tUserGroup\x12\x18\n\x14user_group_undefined\x10\x00\x12\n\n\x06SYSTEM\x10\x01\x12\x11\n\rADMINISTRATOR\x10\x03\x12\x0c\n\x08OPERATOR\x10\x07\x12\x0b\n\x07MONITOR\x10\x0f*\xc4\x01\n\nPermission\x12\x18\n\x14permission_undefined\x10\x00\x12\x0e\n\tUSER_READ\x10\x80\x02\x12\x0f\n\nUSER_WRITE\x10\x80\x01\x12\x10\n\x0cUSER_EXECUTE\x10@\x12\x0e\n\nGROUP_READ\x10 \x12\x0f\n\x0bGROUP_WRITE\x10\x10\x12\x11\n\rGROUP_EXECUTE\x10\x08\x12\x0f\n\x0bOTHERS_READ\x10\x04\x12\x10\n\x0cOTHERS_WRITE\x10\x02\x12\x12\n\x0eOTHERS_EXECUTE\x10\x01*\xd4\x01\n\x08\x44\x61taType\x12\x17\n\x13\x64\x61ta_type_undefined\x10\x00\x12\x08\n\x04INT8\x10\x01\x12\t\n\x05UINT8\x10\x02\x12\t\n\x05INT16\x10\x03\x12\n\n\x06UINT16\x10\x04\x12\t\n\x05INT32\x10\x05\x12\n\n\x06UINT32\x10\x06\x12\t\n\x05INT64\x10\x07\x12\n\n\x06UINT64\x10\x08\x12\x08\n\x04\x42OOL\x10\t\x12\n\n\x05\x46LOAT\x10\x81\x02\x12\x0b\n\x06\x44OUBLE\x10\x82\x02\x12\t\n\x04\x43HAR\x10\x81\x04\x12\x0b\n\x06STRING\x10\x82\x04\x12\n\n\x05\x42YTES\x10\x99\t\x12\x0e\n\tUSER_TYPE\x10\x80\n*\x84\x01\n\rParameterType\x12\x18\n\x14param_type_undefined\x10\x00\x12\t\n\x05INPUT\x10\x01\x12\n\n\x06OUTPUT\x10\x10\x12\x0e\n\tPARAMETER\x10\x80\x02\x12\x17\n\x12PARAMETER_VOLATILE\x10\x81\x02\x12\x19\n\x14PARAMETER_PERSISTENT\x10\x82\x02*\xd2\x02\n\nStatusCode\x12\x06\n\x02OK\x10\x00\x12\x12\n\x0eREAD_ONLY_MODE\x10\x01\x12\x0c\n\x06\x46\x41ILED\x10\x80\xfe\x03\x12\x15\n\x10\x46\x41ILED_TO_DECODE\x10\x80 \x12\x15\n\x10SUB_LIST_IS_FULL\x10\x80\"\x12\x19\n\x14WRONG_PARAMETER_PATH\x10\x80$\x12 \n\x1b\x46\x41ILED_TO_SET_REQUESTED_FRQ\x10\x80&\x12\x18\n\x13\x46\x41ILED_TO_OPEN_FILE\x10\x80(\x12\x17\n\x12GROUP_LIST_IS_FULL\x10\x80*\x12\x1f\n\x1aTIMEOUT_WAITING_FOR_UPDATE\x10\x80,\x12\x15\n\x10SAVE_IN_PROGRESS\x10\x80.\x12\x13\n\x0eWRONG_PASSWORD\x10\x80\x42\x12\x17\n\x12USER_NOT_LOGGED_IN\x10\x80\x44\x12\x16\n\x11PERMISSION_DENIED\x10\x80\x46*v\n\nErrorLevel\x12\x19\n\x15\x65rror_level_undefined\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\x14\n\x10\x46ORCED_DISENGAGE\x10\x03\x12\x0c\n\x08SHUTDOWN\x10\x04\x12\x12\n\x0e\x45MERGENCY_STOP\x10\x05*_\n\nOffsetType\x12\x19\n\x15offset_type_undefined\x10\x00\x12\x13\n\x0fOFFSET_ELEMENTS\x10\x01\x12\x10\n\x0cOFFSET_BYTES\x10\x02\x12\x0f\n\x0bOFFSET_BITS\x10\x03*<\n\rParameterFlag\x12\x12\n\x0eLINK_IS_ACTIVE\x10\x01\x12\x17\n\x13OVERWRITE_IS_ACTIVE\x10\x02')
+
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'motorcortex_pb2', globals())
+if _descriptor._USE_C_DESCRIPTORS == False:
+
+  DESCRIPTOR._options = None
+  _UNIT._serialized_start=3796
+  _UNIT._serialized_end=4095
+  _USERGROUP._serialized_start=4097
+  _USERGROUP._serialized_end=4192
+  _PERMISSION._serialized_start=4195
+  _PERMISSION._serialized_end=4391
+  _DATATYPE._serialized_start=4394
+  _DATATYPE._serialized_end=4606
+  _PARAMETERTYPE._serialized_start=4609
+  _PARAMETERTYPE._serialized_end=4741
+  _STATUSCODE._serialized_start=4744
+  _STATUSCODE._serialized_end=5082
+  _ERRORLEVEL._serialized_start=5084
+  _ERRORLEVEL._serialized_end=5202
+  _OFFSETTYPE._serialized_start=5204
+  _OFFSETTYPE._serialized_end=5299
+  _PARAMETERFLAG._serialized_start=5301
+  _PARAMETERFLAG._serialized_end=5361
+  _PARAMETEROFFSET._serialized_start=34
+  _PARAMETEROFFSET._serialized_end=139
+  _ERROR._serialized_start=141
+  _ERROR._serialized_end=243
+  _ERRORLIST._serialized_start=245
+  _ERRORLIST._serialized_end=342
+  _PARAMETERINFO._serialized_start=345
+  _PARAMETERINFO._serialized_end=611
+  _GROUPPARAMETERINFO._serialized_start=614
+  _GROUPPARAMETERINFO._serialized_end=762
+  _HEADER._serialized_start=764
+  _HEADER._serialized_end=813
+  _GROUPMSG._serialized_start=815
+  _GROUPMSG._serialized_end=905
+  _STATUSMSG._serialized_start=907
+  _STATUSMSG._serialized_end=996
+  _LOGINMSG._serialized_start=998
+  _LOGINMSG._serialized_end=1078
+  _GETSESSIONTOKENMSG._serialized_start=1080
+  _GETSESSIONTOKENMSG._serialized_end=1137
+  _SESSIONTOKENMSG._serialized_start=1139
+  _SESSIONTOKENMSG._serialized_end=1249
+  _GETSUBCOOKIEMSG._serialized_start=1251
+  _GETSUBCOOKIEMSG._serialized_end=1305
+  _SUBCOOKIEMSG._serialized_start=1307
+  _SUBCOOKIEMSG._serialized_end=1415
+  _RESTORESESSIONMSG._serialized_start=1417
+  _RESTORESESSIONMSG._serialized_end=1488
+  _LOGOUTMSG._serialized_start=1490
+  _LOGOUTMSG._serialized_end=1538
+  _GETPARAMETERTREEMSG._serialized_start=1540
+  _GETPARAMETERTREEMSG._serialized_end=1598
+  _PARAMETERTREEMSG._serialized_start=1601
+  _PARAMETERTREEMSG._serialized_end=1755
+  _GETPARAMETERTREEHASHMSG._serialized_start=1757
+  _GETPARAMETERTREEHASHMSG._serialized_end=1819
+  _PARAMETERTREEHASHMSG._serialized_start=1821
+  _PARAMETERTREEHASHMSG._serialized_end=1935
+  _GETPARAMETERTREECOMPRESSEDMSG._serialized_start=1937
+  _GETPARAMETERTREECOMPRESSEDMSG._serialized_end=2005
+  _COMPRESSEDPARAMETERTREEMSG._serialized_start=2008
+  _COMPRESSEDPARAMETERTREEMSG._serialized_end=2175
+  _CREATEGROUPMSG._serialized_start=2177
+  _CREATEGROUPMSG._serialized_end=2281
+  _GROUPSTATUSMSG._serialized_start=2284
+  _GROUPSTATUSMSG._serialized_end=2454
+  _REMOVEGROUPMSG._serialized_start=2456
+  _REMOVEGROUPMSG._serialized_end=2524
+  _GETPARAMETERMSG._serialized_start=2526
+  _GETPARAMETERMSG._serialized_end=2594
+  _PARAMETERMSG._serialized_start=2597
+  _PARAMETERMSG._serialized_end=2746
+  _GETPARAMETERLISTMSG._serialized_start=2748
+  _GETPARAMETERLISTMSG._serialized_end=2852
+  _PARAMETERLISTMSG._serialized_start=2855
+  _PARAMETERLISTMSG._serialized_end=2994
+  _SETPARAMETERMSG._serialized_start=2997
+  _SETPARAMETERMSG._serialized_end=3126
+  _SETPARAMETERLISTMSG._serialized_start=3128
+  _SETPARAMETERLISTMSG._serialized_end=3232
+  _OVERWRITEPARAMETERMSG._serialized_start=3235
+  _OVERWRITEPARAMETERMSG._serialized_end=3388
+  _RELEASEPARAMETERMSG._serialized_start=3390
+  _RELEASEPARAMETERMSG._serialized_end=3462
+  _SAVEMSG._serialized_start=3464
+  _SAVEMSG._serialized_end=3543
+  _LOADMSG._serialized_start=3545
+  _LOADMSG._serialized_end=3624
+  _CONSOLECMDMSG._serialized_start=3626
+  _CONSOLECMDMSG._serialized_end=3693
+  _CONSOLECMDLISTMSG._serialized_start=3695
+  _CONSOLECMDLISTMSG._serialized_end=3793
+# @@protoc_insertion_point(module_scope)