c3rebro · c3rebro · Dec 15, 2025 · Dec 15, 2025
diff --git a/Elatec.NET.csproj b/Elatec.NET.csproj
@@ -89,6 +89,7 @@ v0.2 take legic capable reader "specialties" into account. See Readme.MD for fur
 
   <ItemGroup>
     <Compile Remove="Elatec.NET.Tests/**/*.cs" />
+    <Compile Remove="tests/**/*.cs" />
   </ItemGroup>
 
 </Project>
diff --git a/Elatec.NET.sln b/Elatec.NET.sln
@@ -5,7 +5,7 @@ VisualStudioVersion = 17.7.34221.43
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Elatec.NET", "Elatec.NET.csproj", "{53FBD2F3-638E-4892-9F09-9A372C8F76D2}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Elatec.NET.Tests", "Elatec.NET.Tests\\Elatec.NET.Tests.csproj", "{1767A7E5-6C9A-46AC-A6FD-B07080AC0CE3}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Elatec.NET.Tests", "tests\\Elatec.NET.Tests\\Elatec.NET.Tests.csproj", "{1767A7E5-6C9A-46AC-A6FD-B07080AC0CE3}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

diff --git a/README.md b/README.md
@@ -19,6 +19,15 @@ Tested bix file versions:
 * 4.50
 * 4.51
 
+## Repository layout
+
+- `src/Api` exposes the public API surface, including TWN4 reader abstractions and card models.
+- `src/Drivers` hosts the hardware and transport drivers, such as serial port access and device enumeration helpers.
+- `src/Internal` contains protocol constants and parsers that support the API but are not meant for direct consumption.
+- `src/Utils` collects shared utilities and exceptions used across the library.
+- `examples` is the place for sample applications that demonstrate how to call the API.
+- `tests` holds the unit test projects.
+
 Hint: Some readers may show unexpected behavior. Especially with Legic Capable "TWN4 Multitec (2) HF LF Legic". The reason is that some ISO14443 commands are executed by the internal legic chip.
 
 Examples for the TWN4 - Legic reader "specialties":

diff --git a/examples/README.md b/examples/README.md
@@ -0,0 +1,6 @@
+# Examples
+
+This folder is reserved for sample applications that exercise the Elatec.NET API. If you need a working starting point today,
+check out the Elatec.Net.SampleApp repository at https://github.com/c3rebro/Elatec.Net.SampleApp.
+
+Add new example projects here to keep demonstrations separate from the core library.
diff --git a/Cards/BaseChip.cs → src/Api/Cards/BaseChip.cs b/Cards/BaseChip.cs → src/Api/Cards/BaseChip.cs
diff --git a/Cards/Mifare/MifareChip.cs → src/Api/Cards/Mifare/MifareChip.cs b/Cards/Mifare/MifareChip.cs → src/Api/Cards/Mifare/MifareChip.cs
diff --git a/Cards/Mifare/MifareKey.cs → src/Api/Cards/Mifare/MifareKey.cs b/Cards/Mifare/MifareKey.cs → src/Api/Cards/Mifare/MifareKey.cs
diff --git a/Interfaces/IDeviceEnumerator.cs → src/Api/Interfaces/IDeviceEnumerator.cs b/Interfaces/IDeviceEnumerator.cs → src/Api/Interfaces/IDeviceEnumerator.cs
diff --git a/Interfaces/IReaderTransport.cs → src/Api/Interfaces/IReaderTransport.cs b/Interfaces/IReaderTransport.cs → src/Api/Interfaces/IReaderTransport.cs
diff --git a/...Classic/TWN4ReaderDevice.MifareClassic.cs → .../Mifare/TWN4ReaderDevice.MifareClassic.cs b/...Classic/TWN4ReaderDevice.MifareClassic.cs → .../Mifare/TWN4ReaderDevice.MifareClassic.cs
diff --git a/...Desfire/TWN4ReaderDevice.MifareDesfire.cs → .../Mifare/TWN4ReaderDevice.MifareDesfire.cs b/...Desfire/TWN4ReaderDevice.MifareDesfire.cs → .../Mifare/TWN4ReaderDevice.MifareDesfire.cs
diff --git a/...ight/TWN4ReaderDevice.MifareUltralight.cs → ...fare/TWN4ReaderDevice.MifareUltralight.cs b/...ight/TWN4ReaderDevice.MifareUltralight.cs → ...fare/TWN4ReaderDevice.MifareUltralight.cs
diff --git a/Rf/TWN4ReaderDevice.Iso.cs → ...rDevice/Protocols/TWN4ReaderDevice.Iso.cs b/Rf/TWN4ReaderDevice.Iso.cs → ...rDevice/Protocols/TWN4ReaderDevice.Iso.cs
diff --git a/Rf/TWN4ReaderDevice.Rf.cs → ...erDevice/Protocols/TWN4ReaderDevice.Rf.cs b/Rf/TWN4ReaderDevice.Rf.cs → ...erDevice/Protocols/TWN4ReaderDevice.Rf.cs
diff --git a/Elatec.NET.cs → ...TWN4ReaderDevice/TWN4ReaderDevice.Core.cs b/Elatec.NET.cs → ...TWN4ReaderDevice/TWN4ReaderDevice.Core.cs
diff --git a/System/TWN4ReaderDevice.System.cs → ...N4ReaderDevice/TWN4ReaderDevice.System.cs b/System/TWN4ReaderDevice.System.cs → ...N4ReaderDevice/TWN4ReaderDevice.System.cs
diff --git a/Helpers/DeviceManager.cs → src/Drivers/Enumeration/DeviceManager.cs b/Helpers/DeviceManager.cs → src/Drivers/Enumeration/DeviceManager.cs
diff --git a/Helpers/LinuxDeviceEnumerator.cs → ...vers/Enumeration/LinuxDeviceEnumerator.cs b/Helpers/LinuxDeviceEnumerator.cs → ...vers/Enumeration/LinuxDeviceEnumerator.cs
diff --git a/Helpers/MacOsDeviceEnumerator.cs → ...vers/Enumeration/MacOsDeviceEnumerator.cs b/Helpers/MacOsDeviceEnumerator.cs → ...vers/Enumeration/MacOsDeviceEnumerator.cs
diff --git a/Helpers/NullDeviceEnumerator.cs → ...ivers/Enumeration/NullDeviceEnumerator.cs b/Helpers/NullDeviceEnumerator.cs → ...ivers/Enumeration/NullDeviceEnumerator.cs
diff --git a/Helpers/WindowsDeviceEnumerator.cs → ...rs/Enumeration/WindowsDeviceEnumerator.cs b/Helpers/WindowsDeviceEnumerator.cs → ...rs/Enumeration/WindowsDeviceEnumerator.cs
diff --git a/System/SerialPortTransport.cs → src/Drivers/Transport/SerialPortTransport.cs b/System/SerialPortTransport.cs → src/Drivers/Transport/SerialPortTransport.cs
diff --git a/DataAccessLayer/Constants.cs → src/Internal/DataAccess/Constants.cs b/DataAccessLayer/Constants.cs → src/Internal/DataAccess/Constants.cs
diff --git a/Helpers/ResponseParser.cs → src/Internal/Parsing/ResponseParser.cs b/Helpers/ResponseParser.cs → src/Internal/Parsing/ResponseParser.cs
diff --git a/Properties/AssemblyInfo.cs → src/Properties/AssemblyInfo.cs b/Properties/AssemblyInfo.cs → src/Properties/AssemblyInfo.cs
diff --git a/Helpers/ByteArray.cs → src/Utils/ByteArray.cs b/Helpers/ByteArray.cs → src/Utils/ByteArray.cs
diff --git a/Helpers/ListExtensions.cs → src/Utils/ListExtensions.cs b/Helpers/ListExtensions.cs → src/Utils/ListExtensions.cs
diff --git a/Helpers/ReaderException.cs → src/Utils/ReaderException.cs b/Helpers/ReaderException.cs → src/Utils/ReaderException.cs
diff --git a/Helpers/TwnException.cs → src/Utils/TwnException.cs b/Helpers/TwnException.cs → src/Utils/TwnException.cs
diff --git a/Elatec.NET.Tests/Elatec.NET.Tests.csproj → .../Elatec.NET.Tests/Elatec.NET.Tests.csproj b/Elatec.NET.Tests/Elatec.NET.Tests.csproj → .../Elatec.NET.Tests/Elatec.NET.Tests.csproj
@@ -4,7 +4,7 @@
     <IsPackable>false</IsPackable>
   </PropertyGroup>
   <ItemGroup>
-    <ProjectReference Include="..\Elatec.NET.csproj" />
+    <ProjectReference Include="..\..\Elatec.NET.csproj" />
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.9.0" />
     <PackageReference Include="coverlet.msbuild" Version="6.0.0">
       <PrivateAssets>all</PrivateAssets>

diff --git a/Elatec.NET.Tests/FakeReaderTransport.cs → ...s/Elatec.NET.Tests/FakeReaderTransport.cs b/Elatec.NET.Tests/FakeReaderTransport.cs → ...s/Elatec.NET.Tests/FakeReaderTransport.cs
diff --git a/Elatec.NET.Tests/ProtocolTests.cs → tests/Elatec.NET.Tests/ProtocolTests.cs b/Elatec.NET.Tests/ProtocolTests.cs → tests/Elatec.NET.Tests/ProtocolTests.cs
diff --git a/Elatec.NET.Tests/TWN4ReaderDeviceTests.cs → ...Elatec.NET.Tests/TWN4ReaderDeviceTests.cs b/Elatec.NET.Tests/TWN4ReaderDeviceTests.cs → ...Elatec.NET.Tests/TWN4ReaderDeviceTests.cs
diff --git a/...NET.Tests/WindowsDeviceEnumeratorTests.cs → ...NET.Tests/WindowsDeviceEnumeratorTests.cs b/...NET.Tests/WindowsDeviceEnumeratorTests.cs → ...NET.Tests/WindowsDeviceEnumeratorTests.cs