# tijuca/raritan-pdu-json-rpc-sdk architecture

> Architecture diagram of the GitHub repository tijuca/raritan-pdu-json-rpc-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tijuca/raritan-pdu-json-rpc-sdk
- Repository: https://github.com/tijuca/raritan-pdu-json-rpc-sdk

## Overview

This repository combines Raritan PX2 JSON-RPC client bindings for Python and .NET with command-line examples and a documented PX2 deployment/configuration utility. The principal SDK workflow is a client issuing an RPC through a proxy and transport agent to a PDU, then decoding its response. The README also describes configuration, verification, identification, reboot, fitness export, firmware updates, and timezone operations, but the documented Perl entry point is not present in the supplied tree. Source excerpts show parts of the .NET transport and generated bindings; other domain coverage is based on the tree and SOURCE INDEX.

Main entry points: [`pdu-dotnet-api/src/Com/Raritan/JsonRpc/ObjectProxy.cs`](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/Com/Raritan/JsonRpc/ObjectProxy.cs) (Object proxy), [`pdu-dotnet-api/src/Com/Raritan/JsonRpc/Agent.cs`](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/Com/Raritan/JsonRpc/Agent.cs) (HTTP agent), [`pdu-python-api/raritan/rpc`](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/tree/debian/sid/pdu-python-api/raritan/rpc) (Python RPC API), [`pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/sys/System.cs`](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/sys/System.cs) (System control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dotnet[".NET RPC client"]
  node_proxy["Object proxy<br/>[ObjectProxy.cs]"]
  node_agent["HTTP agent<br/>[Agent.cs]"]
  node_json["JSON values<br/>[JsonValue.cs]"]
  node_async["Async requests<br/>[AsyncRequest.cs]"]
end

subgraph group_domain["Device domains"]
  node_system["System control<br/>[System.cs]"]
  node_events["Event engine<br/>[Engine.cs]"]
  node_peripheral["Peripheral devices"]
  node_webcam["Webcam storage<br/>[StorageManager.cs]"]
  node_lua["Lua service<br/>[Manager_2_0_1.cs]"]
  node_roles["Role management<br/>[RoleManager.cs]"]
  node_cascade["Cascade control<br/>[CascadeManager.cs]"]
end

subgraph group_python["Python bindings"]
  node_pythonapi["Python RPC API"]
  node_pymodel["Python PDU models<br/>[__init__.py]"]
  node_luaexample["Lua client example"]
end

node_caller(("API caller"))
node_pdu{{"PX2 device"}}

node_caller -.->|"invokes"| node_proxy
node_proxy -->|"sends RPC"| node_agent
node_agent -->|"HTTP POST"| node_pdu
node_agent -->|"returns response"| node_proxy
node_proxy -.->|"encodes RPC"| node_json
node_proxy -.->|"tracks async"| node_async
node_system -->|"extends"| node_proxy
node_events -->|"extends"| node_proxy
node_peripheral -.->|"extends"| node_proxy
node_webcam -->|"extends"| node_proxy
node_lua -.->|"extends"| node_proxy
node_roles -.->|"extends"| node_proxy
node_cascade -.->|"extends"| node_proxy
node_pythonapi -->|"provides models"| node_pymodel
node_luaexample -.->|"uses bindings"| node_pythonapi

click node_proxy "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/Com/Raritan/JsonRpc/ObjectProxy.cs"
click node_agent "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/Com/Raritan/JsonRpc/Agent.cs"
click node_json "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/LightJson/JsonValue.cs"
click node_async "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/Com/Raritan/Util/AsyncRequest.cs"
click node_system "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/sys/System.cs"
click node_events "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/_event/Engine.cs"
click node_peripheral "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/peripheral/DeviceManager_3_0_1.cs"
click node_webcam "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/webcam/StorageManager.cs"
click node_lua "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/luaservice/Manager_2_0_1.cs"
click node_roles "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/usermgmt/RoleManager.cs"
click node_cascade "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/cascading/CascadeManager.cs"
click node_pythonapi "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/tree/debian/sid/pdu-python-api/raritan/rpc"
click node_pymodel "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-python-api/raritan/rpc/pdumodel/__init__.py"
click node_luaexample "https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/luaservice_client.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_proxy,node_agent,node_json,node_async toneBlue
class node_system,node_events,node_peripheral,node_webcam,node_lua,node_roles,node_cascade toneAmber
class node_pythonapi,node_pymodel,node_luaexample,node_caller toneMint
class node_pdu toneIndigo
```

## Components

### .NET RPC client

- [Object proxy](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/Com/Raritan/JsonRpc/ObjectProxy.cs): `pdu-dotnet-api/src/Com/Raritan/JsonRpc/ObjectProxy.cs`
- [HTTP agent](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/Com/Raritan/JsonRpc/Agent.cs): `pdu-dotnet-api/src/Com/Raritan/JsonRpc/Agent.cs`
- [JSON values](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/LightJson/JsonValue.cs): `pdu-dotnet-api/src/LightJson/JsonValue.cs`
- [Async requests](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/src/Com/Raritan/Util/AsyncRequest.cs): `pdu-dotnet-api/src/Com/Raritan/Util/AsyncRequest.cs`

### Device domains

- [System control](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/sys/System.cs): `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/sys/System.cs`
- [Event engine](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/_event/Engine.cs): `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/_event/Engine.cs`
- [Peripheral devices](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/peripheral/DeviceManager_3_0_1.cs): `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/peripheral/DeviceManager_3_0_1.cs`
- [Webcam storage](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/webcam/StorageManager.cs): `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/webcam/StorageManager.cs`
- [Lua service](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/luaservice/Manager_2_0_1.cs): `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/luaservice/Manager_2_0_1.cs`
- [Role management](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/usermgmt/RoleManager.cs): `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/usermgmt/RoleManager.cs`
- [Cascade control](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/cascading/CascadeManager.cs): `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/cascading/CascadeManager.cs`

### Python bindings

- [Python RPC API](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/tree/debian/sid/pdu-python-api/raritan/rpc): `pdu-python-api/raritan/rpc`
- [Python PDU models](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/pdu-python-api/raritan/rpc/pdumodel/__init__.py): `pdu-python-api/raritan/rpc/pdumodel/__init__.py`
- [Lua client example](https://github.com/tijuca/raritan-pdu-json-rpc-sdk/blob/debian/sid/luaservice_client.py): `luaservice_client.py`

### Other components

- **API caller**
- **PX2 device**

## Connections

- API caller → Object proxy: invokes
- Object proxy → HTTP agent: sends RPC (evidence: `pdu-dotnet-api/src/Com/Raritan/JsonRpc/ObjectProxy.cs`)
- HTTP agent → PX2 device: HTTP POST (evidence: `pdu-dotnet-api/src/Com/Raritan/JsonRpc/Agent.cs`)
- HTTP agent → Object proxy: returns response (evidence: `pdu-dotnet-api/src/Com/Raritan/JsonRpc/ObjectProxy.cs`)
- Object proxy → JSON values: encodes RPC (evidence: `pdu-dotnet-api/src/Com/Raritan/JsonRpc/ObjectProxy.cs`)
- Object proxy → Async requests: tracks async (evidence: `pdu-dotnet-api/src/Com/Raritan/JsonRpc/ObjectProxy.cs`)
- System control → Object proxy: extends (evidence: `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/sys/System.cs`)
- Event engine → Object proxy: extends (evidence: `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/_event/Engine.cs`)
- Peripheral devices → Object proxy: extends (evidence: `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/peripheral/DeviceManager_3_0_1.cs`)
- Webcam storage → Object proxy: extends (evidence: `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/webcam/StorageManager.cs`)
- Lua service → Object proxy: extends (evidence: `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/luaservice/Manager_2_0_1.cs`)
- Role management → Object proxy: extends (evidence: `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/usermgmt/RoleManager.cs`)
- Cascade control → Object proxy: extends (evidence: `pdu-dotnet-api/_idlc_gen/dotnet/Com/Raritan/Idl/cascading/CascadeManager.cs`)
- Python RPC API → Python PDU models: provides models (evidence: `pdu-python-api/raritan/rpc/__init__.py`)
- Lua client example → Python RPC API: uses bindings (evidence: `luaservice_client.py`)
