{
  "id": "xarm-python-sdk-example-wrapper-common-5008-get-cgpio-state-py",
  "framework": "xarm-python-sdk",
  "kind": "official_example",
  "source": {
    "repository": "https://github.com/xArm-Developer/xArm-Python-SDK",
    "commit": "d911319cebc45142613e18086aabb8067b18ab7f",
    "tag": "master",
    "path": "example/wrapper/common/5008-get_cgpio_state.py",
    "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/example/wrapper/common/5008-get_cgpio_state.py",
    "raw_url": "https://raw.githubusercontent.com/xArm-Developer/xArm-Python-SDK/d911319cebc45142613e18086aabb8067b18ab7f/example/wrapper/common/5008-get_cgpio_state.py",
    "sha256": "0dda6f2a560f3c45225fb5141968c9c87003f7811155ed3f6d5ba6a84746c628",
    "bytes": 1520,
    "authors": [
      "UFACTORY Inc.",
      "Vinman"
    ]
  },
  "license": {
    "spdx": "BSD-3-Clause",
    "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/LICENSE",
    "sha256": "3f14a09c97aae546da459e135d1257c3ba37a692ec1a6be4628da078d38b75a4",
    "scope": "Selected first-party UFACTORY Python example source under the pinned BSD-3-Clause license and its own UFACTORY/Vinman notices. Preserve copyright, conditions, attribution and disclaimers. This source identity does not establish rights or compatibility for robot hardware, firmware, payloads, recorded trajectories, third-party dependencies or external assets.",
    "bytes": 1521
  },
  "access": {
    "mode": "source_reference",
    "hub_prepare": false,
    "instructions": "Fetch the pinned repository, verify this source checksum, and use upstream installation and invocation. This record does not install or execute code.",
    "setup_url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/README.md",
    "setup_evidence": [
      {
        "path": "README.md",
        "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/README.md",
        "sha256": "563c3dcb63062b68220d19df9502211e4cefd3bbb22afee032e8840a27f72475",
        "bytes": 16139,
        "purpose": "Official setup, example/model links and controller address declaration"
      },
      {
        "path": "README.rst",
        "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/README.rst",
        "sha256": "715eb6a8fbe427f13dbf0b3f964ae824033ae4247d5542b84788b8934bd7551b",
        "bytes": 1811,
        "purpose": "Official author/product and Python declarations"
      },
      {
        "path": "setup.py",
        "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/setup.py",
        "sha256": "59d2fb40338f8e03273e9f613c953016e0c1543f5d81db8235c159ae27915841",
        "bytes": 2402,
        "purpose": "Author, package setup and Python declaration; treated as inert text"
      },
      {
        "path": "pyproject.toml",
        "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/pyproject.toml",
        "sha256": "2d44732e1c250ed70143cb2930f1bc1eec90b70664b3214185d660ee7f3fe46f",
        "bytes": 1640,
        "purpose": "Package author/maintainer and Python/build declarations"
      },
      {
        "path": "xarm/version.py",
        "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/xarm/version.py",
        "sha256": "3e449707f57e6d6b33e6fcfde7341fddc629b4a4987772a5e1b20b1fa54c483e",
        "bytes": 24,
        "purpose": "SDK source version declaration, not installed distribution or firmware"
      },
      {
        "path": "example/wrapper/robot.conf",
        "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/example/wrapper/robot.conf",
        "sha256": "c7c600dc691cf18f1a5e3130888ff2cadd8e734bb85b6f3accaaec6c93c8f013",
        "bytes": 25,
        "purpose": "Shipped example address configuration; never contacted"
      }
    ]
  },
  "requirements": {
    "python": "Python >=3.5 declared by pinned pyproject.toml/setup.py; README.rst names 3.5-3.13. These are upstream declarations, not a tested runtime combination.",
    "packages": [
      "xarm-python-sdk from the exact source revision; xarm.wrapper.XArmAPI"
    ],
    "display": "Operator-supplied reachable robot-controller address, matching model/payload/control configuration and applicable firmware. Example scripts accept an address argument or use relative robot.conf/input. No controller, installed SDK, firmware or combined environment was verified.",
    "execution_domain": "hardware",
    "source_imports": [
      "configparser",
      "os",
      "sys",
      "time",
      "xarm.wrapper"
    ],
    "notes": "No installed SDK or executable environment was tested. Source scripts may move or reconfigure hardware even when their primary task is inspection.",
    "declared_requirements": {
      "sdk_source_version": {
        "value": "1.18.5",
        "path": "xarm/version.py",
        "sha256": "3e449707f57e6d6b33e6fcfde7341fddc629b4a4987772a5e1b20b1fa54c483e",
        "bytes": 24,
        "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/xarm/version.py",
        "meaning": "Source declaration only; no installed SDK or firmware version inferred."
      },
      "readme_wheel_example_version": {
        "value": "1.16.0",
        "source": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/README.md",
        "meaning": "The README's wheel-install example differs from the frozen version file; not treated as the SDK version at this pin."
      },
      "empty_runtime_requirements_file": {
        "path": "requirements.txt",
        "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
        "bytes": 0,
        "url": "https://github.com/xArm-Developer/xArm-Python-SDK/blob/d911319cebc45142613e18086aabb8067b18ab7f/requirements.txt",
        "git_blob_sha1": "e69de29bb2d1d6434b8b29ae775ad8c2e48c5391",
        "declaration": "This file is exactly empty. Its zero-byte identity is reviewed in the static receipt, not an assertion that every optional SDK feature has no dependencies."
      },
      "controller_address": "Operator-supplied; examples use an argument, relative ../robot.conf, or interactive input. Shipped address is example data and was not contacted.",
      "source_control_mode_values": [],
      "control_mode_meaning": "Literal set_mode arguments in this source, in initialization/control code; not model/controller/firmware compatibility declarations.",
      "firmware": "unknown unless a source-specific requirement is stated below",
      "license_boundaries": "BSD source terms do not establish hardware access, firmware/payload terms, entitlement or runtime compatibility."
    }
  },
  "invocation": {
    "entrypoint": "python example/wrapper/common/5008-get_cgpio_state.py",
    "notes": "These examples execute at module top level without __main__ guards. Do not import them to inspect metadata: import would execute connection/control code. Use upstream setup and the selected script only within an independently authorized robot task. Address, mode, targets, units, payload and firmware must be reviewed; this source reference installs/runs nothing."
  },
  "popularity": {
    "metric": "github_stars",
    "repository_stars": 330,
    "checked_at": "2026-10-18",
    "meaning": "Dated repository interest, not robot-skill usage, compatibility or runtime success."
  },
  "evidence": {
    "level": "source_reviewed",
    "runtime_verification": "not_run",
    "checked_at": "2026-10-18",
    "entrypoint_kind": "python_top_level_script",
    "inspection_method": "automated_static",
    "limitations": [
      "Unguarded top-level code connects to a controller and executes operational API calls when run or imported upstream. It was only parsed as text here.",
      "Hard-coded target values, control modes, units and rates are examples, not tested-safe values for any installed robot.",
      "The GPIO inspection script may clear warning/error conditions; it is not a strictly passive controller read."
    ],
    "inspection": "Verified exact source, applicable license and author/setup document bytes at a full Git commit; parsed Python AST and matched the reviewed SDK import, direct module-level constructor binding and subsequent instance method calls in module/control-flow syntax, excluding nested definitions and comprehension scopes. This is syntactic evidence, not proof of execution or reachability. No upstream code, installation, robot command, dataset, mesh or checkpoint was executed or loaded; runtime compatibility is unverified.",
    "script_entrypoint": {
      "format": "from_import_constructor_methods",
      "import_module": "xarm.wrapper",
      "import_name": "XArmAPI",
      "import_binding": "XArmAPI",
      "instance": "arm",
      "methods": [
        "get_cgpio_state"
      ],
      "import_line": 18,
      "constructor_line": 30,
      "method_calls": [
        {
          "method": "get_cgpio_state",
          "line": 37
        }
      ],
      "method": "reviewed_sdk_syntactic_module_control_flow",
      "scope": "Static syntactic presence only; execution, reachability and runtime compatibility are unverified.",
      "runtime_verification": "not_run",
      "reachability_verified": false,
      "compatibility_inferred": false
    }
  },
  "name": "UFACTORY xArm Python SDK: Controller GPIO state inspection",
  "summary": "Clear warning/error conditions when present and inspect controller GPIO state. Static source reference; upstream setup and hardware configuration require separate review.",
  "source_registry": "official-robot-workflows-v1",
  "capabilities": [
    "controller-gpio",
    "io-inspection"
  ],
  "robot_types": [
    "manipulator"
  ],
  "robot_scope": "Source-specific SDK example only. Generic examples identify no exact model; named paths supply discovery labels only, with controller/firmware/payload/runtime compatibility unknown.",
  "artifact": {
    "kind": "workflow",
    "format": "python",
    "workflow_role": "io-inspection"
  }
}