From 9641d3cbc99461b5db0501fd88537d568cae60c5 Mon Sep 17 00:00:00 2001
From: Daniel Mulholland <dan.mulholland@gmail.com>
Date: Sun, 8 Mar 2026 13:33:22 +1000
Subject: [PATCH 1/2] feat: add Reference element for IEDs (closes #3)

---
 SSD/SLD/v0/ssd-sld-v0.xsd | 40 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/SSD/SLD/v0/ssd-sld-v0.xsd b/SSD/SLD/v0/ssd-sld-v0.xsd
index 3eb9502..19566bd 100644
--- a/SSD/SLD/v0/ssd-sld-v0.xsd
+++ b/SSD/SLD/v0/ssd-sld-v0.xsd
@@ -380,4 +380,44 @@
         </xs:complexType>
     </xs:element>
 
+    <xs:element name="Reference">
+        <xs:annotation>
+            <xs:documentation> Generic reference element for linking SLD layout information to an 
+                SCL element via identity string. 
+                
+                Current usage supports IED references.
+            
+                Example usage:
+                &lt;Private type="OpenSCD-SLD-Layout"&gt;
+                    &lt;esldoscd:Reference
+                        esldoscd:id='IED[name="P2"]'
+                        esldoscd:type="IED"&gt;
+                        &lt;esldoscd:SLDAttributes
+                            esldoscd:x="7"
+                            esldoscd:y="4"
+                            esldoscd:lx="8"
+                            esldoscd:ly="5"/&gt;
+                    &lt;/esldoscd:Reference&gt;
+                &lt;/Private&gt;
+            </xs:documentation>
+        </xs:annotation>
+        <xs:complexType>
+            <xs:sequence>
+                <xs:element ref="esldoscd:SLDAttributes" minOccurs="0" maxOccurs="1" />
+            </xs:sequence>
+            <xs:attribute name="id" type="xs:string" use="required">
+                <xs:annotation>
+                    <xs:documentation>Identity string of the referenced SCL element. </xs:documentation>
+                </xs:annotation>
+            </xs:attribute>
+            <xs:attribute name="type" use="required">
+                <xs:simpleType>
+                    <xs:restriction base="xs:string">
+                        <xs:enumeration value="IED" />
+                    </xs:restriction>
+                </xs:simpleType>
+            </xs:attribute>
+        </xs:complexType>
+    </xs:element>
+
 </xs:schema>

From 964261a8bd945e77070139d31d2fd2dcdf836dcd Mon Sep 17 00:00:00 2001
From: Daniel Mulholland <dan.mulholland@gmail.com>
Date: Wed, 18 Mar 2026 08:26:30 +1000
Subject: [PATCH 2/2] feat: add instructions for schema use

---
 README.md | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2ef353c..4e517b2 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,35 @@
 # oscd-extensions
+
 Here we are collecting extension namespaces to IEC 61850-6 used within the OpenSCD ecosystem.
 
-If you have identified a need for an extension namespace that in your opinion is of use for the OpenSCD ecosystem and not for your individual project feel free to open a PR with a XSD file defining the namespace. 
+If you have identified a need for an extension namespace that in your opinion is of use for the OpenSCD ecosystem and not for your individual project feel free to open a PR with a XSD file defining the namespace.
 
 > Please make sure to check existing namespaces before proposing a new one. We generally want to avoid multiple namespaces for the same purpose. If an existing namespace is somewhat but not fully serving your purpose, please request a change to this one first.
 
 > Please be aware that adding a new namespace here is something which is likely to require considerable debate and discussion and take some time. Once agreed, concerns around extendability, maintenance and backwards compatibility will be important. The review process is something we take seriously and we may request changes along the way.
+
+## Verifying a file with a schema
+
+To use a schema for validating an SCL file in a text editor, add a schema reference to it.
+For instance if the schema is in the same folder as the SCL file, add a schema reference as follows to the SCL element by adding a namespaced attribute.
+For example with the SLD schema:
+
+```xml
+<SCL ... xsi:schemaLocation="https://openscd.org/SCL/SSD/SLD/v0 ssd-sld-v0.xsd" ...>
+```
+
+You will also need to ensure the `xsi` schema is defined on the document element:
+
+```xml
+<SCL ... xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ...>
+```
+
+On an SCL document element this could look like:
+
+```xml
+<SCL xmlns="http://www.iec.ch/61850/2003/SCL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	version="2007" revision="B" release="4" xmlns:eosld="https://openscd.org/SCL/SSD/SLD/v0"
+	xsi:schemaLocation="https://openscd.org/SCL/SSD/SLD/v0 ssd-sld-v0.xsd">
+```
+
+This is known to work with the XML Tools extension in VS Code.