=============================
Writing Custom Device Drivers
=============================

This page guides users through setting up a .NET C# demo driver server project in Visual Studio 2022 Community.

Additional guides can be found directly from the `Microsoft Visual Studio Tutorial Pages <https://learn.microsoft.com/en-us/visualstudio/get-started/csharp/tutorial-debugger?view=vs-2022>`_.


Required Software
-----------------

* **Windows Environment**. Ensure you are in a Windows environment for development.
* **Visual Studio**. Download and install `Visual Studio 2022 Community Edition  <https://visualstudio.microsoft.com/vs/community/>`_. During installation, select the following workloads:

  * ✔️ `ASP.NET <https://ASP.NET>`_ and web development

  * ✔️ .NET desktop development

  .. image:: _static/visual_studio_install.png
  .. note::
      You can skip the sign-in step when launching Visual Studio.


Running the Demo Server
-----------------------

1. Extract the Demo Solution project files provided into a project folder. Example: :file:`C:/src/`

2. From Visual Studio, :guilabel:`Open` the :file:`Artificial.DemoAPIServer.sln` file.

   .. note::
      This file is located at :file:`C:/src/driver-demo/Artificial.DemoApiServer/Artificial.DemoApiServer.sln`

3. Select :guilabel:`Debug` and :guilabel:`Start Debugging` or :kbd:`F5` from the Visual Studio context menu.

   .. image:: _static/visual_studio_debug.png

4. Click :guilabel:`Yes` and allow any prompts to Install and trust local certificates.

5. In a browser, validate the setup by visiting the below URLs. If you were successful in your setup, you will see the pages populate.

   * http://localhost:49835/ should show the Swagger UI.
   * http://localhost:49835/api/v1/web should show the server log.