..
 # Copyright (c) 2024, Linaro. All rights reserved.
 #
 # This document is proprietary and confidential.
 # Unauthorized copying, distribution, or disclosure of this document or any part
 # of it is strictly prohibited without prior written consent from Linaro.

Contact Support
***************

If you have any questions related to the LAA usage or issues you may be having
with the device please don't hesitate to reach out!

Support can be reached two ways:

* For general enquiries about ONELab or other Linaro products, you can reach us
  at support@linaro.org.  
* If your question is associated with an active Linaro product subscription, we
  recommend you file a support ticket from within the [Linaro Solutions
  Hub](https://hub.linaro.com/support/request/help). Note this requires the user
  to be logged into the Linaro Solutions Hub.

Supporting Docs
***************
This section provides pointers to useful reference documentation specific to ONELab. 

SystemReady Docs
=================

-   v3.0 or later of the [Arm SystemReady Compliance System
    Requirements
    Specification](https://developer.arm.com/documentation/den0109/latest/).

    -   Outlines the requirements a platform must adhere to to be
        SystemReady Compliant.

    -   The ACS is used to test these requirements.

    -   Chapter 3 is focused on the SystemReady DT band requirements

-   `Arm SystemReady DT
    Band <https://developer.arm.com/documentation/DUI1101/3-0/SystemReady-Devicetree-Band-Overview>`_
    docs

-   `ACS Automatic Capsule Update
    Guide <https://github.com/ARM-software/arm-systemready/blob/dc119022959f451b862c1319f0ee6c5e3ff546bb/common/docs/Automatic_Capsule_Update_guide.md>`_

UEFI Specs
===========

This section provides pointers to relevant UEFI specs v2.11 or later.

-   `UEFI Specification
    2.11 <https://uefi.org/specs/UEFI/2.11/>`_

-   `Firmware Update
    chapter <https://uefi.org/specs/UEFI/2.11/23_Firmware_Update_and_Reporting.html#>`_

.. _local_acs_docs:
  
Local ACS Testing
=================

-   `System Devicetree Band Integration and Testing Guide
    v3.0 <https://developer.arm.com/documentation/DUI1101/3-0>`_

    - `Before You Begin <https://developer.arm.com/documentation/DUI1101/3-0/SystemReady-Devicetree-Band-Overview/Before-you-begin?lang=en>`_

    - `Test SystemReady DT Band <https://developer.arm.com/documentation/DUI1101/3-0/Test-SystemReady-Devicetree-band?lang=en>`_

    - `SystemReady DT Testing <https://developer.arm.com/documentation/DUI1101/3-0/Test-SystemReady-Devicetree-band?lang=en>`_

- How to independently run payload tests

  - `Linux OS Distribution Installation Test Guide <https://developer.arm.com/documentation/DUI1101/3-0/Test-SystemReady-Devicetree-band/Test-installation-of-Linux-distributions?lang=en>`_ covers what should be captured from the OS installations.

- How to independently run the SystemReady DT ACS Test suite

  - `Testing with ACS <https://developer.arm.com/documentation/DUI1101/3-0/Test-with-the-ACS?lang=en>`_ 
  - Github `DT ACS repo <https://github.com/ARM-software/arm-systemready/tree/main/SystemReady-devicetree-band>`_ with more details
  - `Applying Waivers to Test Suite Results <https://github.com/ARM-software/arm-systemready/blob/dc119022959f451b862c1319f0ee6c5e3ff546bb/common/docs/waiver_guide.md>`_

- SystemReady Scripts: `https://gitlab.arm.com/systemready/systemready-scripts <https://gitlab.arm.com/systemready/systemready-scripts>`_

  - Contains the capsule-tool.py which should be used to generate tampered and
    de-authenticated capsules.  
  - Also contains the eth-tool.py which can be curl'd and ran from the OS Distro
    shell to generate the ethtool_test.log  

.. _local_acs_testing:

Locally Running ACS
*******************

Before adding a platform to ONELab, it is beneficial to run the SystemReady DT
ACS tests locally. Doing so helps identify and resolve issues early in the
enablement process. This section outlines the steps to locally run ACS v3.0 to
verify compliance before ONELab LAA integration. Running these tests in advance
can reduce integration time when the platform is installed in ONELab.

Alternatively, you can skip this section and let ONELab handle the testing for
you. In this case, ONELab will run the test suites on your platform and provide
result logs for analysis. You can then review the results and make any necessary
firmware adjustments. However, this approach has a drawback, as firmware issues
uncovered during ACS testing will only emerge at the final stage of the
enablement process, potentially causing delays by making this step a critical
dependency.

Run ACS Tests 
=============

As noted above, independently verifying your platform’s readiness for
SystemReady DT compliance before integration can be beneficial. Refer to the
:ref:`local_acs_docs` section for guidance on running these tests.

Apply Waiver as Needed
======================

The link to applying a waiver to your tests can also be found in the
:ref:`local_acs_docs` section.

FAQs
*****

.. list-table:: **ONELab FAQs**
   :header-rows: 1

   * - Category 
     - Question
     - Answer

   * - Getting Started
     - How do I register for a ONELab account?
     - Go to the :ref:`onelab_account_reg` chapter
   * - 
     - Is my platform compatible with ONELab?
     - Review the `ONELab Comprehensive Assessment Review
       <https://linaro-onelab-user-guide.readthedocs-hosted.com/en/latest/onelab_platform_enablement.html#onelab-comprehensive-assessment-review>`_
       in the ONELab Users Guide to better understand how to validate whethe
       your platform will be compatible with use in Linaro Products that use the
       LAA.  
       
   * - 
     - How do I set up the :term:`LAA`?
     - Please visit the `Getting Started
       <https://linaro-linaro-automation-appliance-users-guide.readthedocs-hosted.com/en/latest/laa_getting_started.html#>`_ section of this the LAA User's Guide..

   * - User Interface
     - How do I build the file to input into ONELab?
     - This can be found in the :ref:`onelab_firmware` chapter.
   * - 
     - Question
     - Answer
   * - 
     - Question
     - Answer