# CS Patch Translator Networking Technical Guide ### **Executive Summary** CS Patch Translator acts as a network bridge (middleware) between two video calibration systems: **ColourSpace** (calibration software) and **DaVinci Resolve** (color grading software). It receives patch generation commands from ColourSpace and translates them into the protocol required by DaVinci Resolve. The application requires **Local Network (LAN)** access to communicate with these applications and **External Internet (WAN)** access for licensing and updates. --- ## **1. External Internet Traffic (WAN)** The application initiates outbound connections to the internet for license validation and software updates. | Destination Domain | IP Address | Port | Protocol | Purpose | | :----------------- | :------------ | :--- | :---------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- | | **api.polar.sh** | Dynamic (CDN) | 443 | HTTPS (TCP) | **Licensing & Updates:** 1. Validates the license key on startup.2. Checks for available software updates via the Polar Customer Portal API. | | **1.1.1.1** | 1.1.1.1 | 53 | TCP | **Connectivity Check:** Performs a quick TCP handshake to Cloudflare's DNS server to verify internet availability before attempting license synchronization. | - **Note:** The application does not transmit sensitive user data or video content to the internet. Only license keys, machine identifiers (for activation), and version checks are transmitted. --- ## **2. Local Network Traffic (LAN)** The application communicates heavily on the local network to bridge the two video applications. #### **A. Communication with ColourSpace (Source)** The application acts as a **Client** connecting to the ColourSpace software. - **Discovery (UDP):** - **Port:** `20123`(user selectable) - **Protocol:** UDP - **Direction:** Inbound (Listens for Broadcasts) - **Description:** Listens for UDP broadcast packets from ColourSpace to automatically discover its IP address and port. - **Data Stream (TCP):** - **Port:** Configurable (Default often `20002` or `20202`) - **Protocol:** TCP - **Direction:** Outbound (Client -> Server) - **Description:** Connects to the ColourSpace Network Server to receive patch color data (XML stream). #### **B. Communication with DaVinci Resolve (Destination)** The application acts as a **Server** for DaVinci Resolve. - **Calibration Interface (TCP):** - **Port:** Configurable (Default `20002`user selectable) - **Protocol:** TCP - **Direction:** Inbound (Server <- Client) - **Description:** Opens a TCP listener. DaVinci Resolve connects to this port (using the "Portrait Displays" calibration option) to receive color patch commands. --- ## **3. Firewall Configuration Guide** For the application to function correctly in a managed environment, the following rules may need to be applied: **Host-Based Firewall (Windows Defender / macOS Firewall):** - **Allow Inbound TCP:** On the configured Resolve Port (e.g., `20002`). - **Allow Inbound UDP:** On Port `20123` (if auto-discovery of ColourSpace is required). - **Allow Outbound TCP:** To `api.polar.sh` (443) and the ColourSpace host IP. **Network Firewall (If applications are on different subnets):** - Ensure routing is permitted between the machine running CS Patch Translator and the machine running ColourSpace. - Ensure routing is permitted between the machine running CS Patch Translator and the machine running DaVinci Resolve. ---