Skip to content

Commit 0256b2d

Browse files
Miecznik, RafałMarGasiorek
authored andcommitted
CI/CD: Promote lib files to ncs-door-lock-app @1629bf99e2b4
Source commit ID: @1629bf99e2b4 Signed-off-by: Miecznik, Rafał <rafal.miecznik@nordicsemi.com>
1 parent 4f6b395 commit 0256b2d

9 files changed

Lines changed: 92 additions & 44 deletions

File tree

app/src/platform/uwb_impl/uwb_dummy_impl/CMakeLists.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,7 @@
55
#
66

77
zephyr_include_directories(.)
8+
9+
file(GLOB uwb_src CONFIGURE_DEPENDS *.cpp)
10+
11+
zephyr_library_sources(${uwb_src})
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
/*
2+
* Copyright (c) 2025 Nordic Semiconductor ASA
3+
*
4+
* SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
5+
*/
6+
7+
#include "uwb_impl.h"
8+
9+
namespace Aliro::Uwb {
10+
11+
AliroError UltraWideBandImpl::_Init([[maybe_unused]] const Callbacks &)
12+
{
13+
return ALIRO_ERROR_NOT_IMPLEMENTED;
14+
}
15+
16+
AliroError UltraWideBandImpl::_Deinit()
17+
{
18+
return ALIRO_ERROR_NOT_IMPLEMENTED;
19+
}
20+
21+
void UltraWideBandImpl::_BleTimeSync()
22+
const { /* No operation for dummy implementation; override in derived classes if needed. */ };
23+
24+
AliroError UltraWideBandImpl::_HandleBleMessage([[maybe_unused]] const uint8_t *, [[maybe_unused]] size_t)
25+
{
26+
return ALIRO_ERROR_NOT_IMPLEMENTED;
27+
}
28+
29+
AliroError UltraWideBandImpl::_ConfigureRangingSession([[maybe_unused]] SessionIdentifier,
30+
[[maybe_unused]] const CryptoTypes::Ursk &,
31+
[[maybe_unused]] void *)
32+
{
33+
return ALIRO_ERROR_NOT_IMPLEMENTED;
34+
}
35+
36+
AliroError UltraWideBandImpl::_InitiateRangingSession()
37+
{
38+
return ALIRO_ERROR_NOT_IMPLEMENTED;
39+
}
40+
41+
AliroError UltraWideBandImpl::_TerminateRangingSession()
42+
{
43+
return ALIRO_ERROR_NOT_IMPLEMENTED;
44+
}
45+
46+
AliroError UltraWideBandImpl::_SuspendRangingSession()
47+
{
48+
return ALIRO_ERROR_NOT_IMPLEMENTED;
49+
}
50+
51+
AliroError UltraWideBandImpl::_ResumeRangingSession()
52+
{
53+
return ALIRO_ERROR_NOT_IMPLEMENTED;
54+
}
55+
56+
} // namespace Aliro::Uwb

app/src/platform/uwb_impl/uwb_dummy_impl/uwb_impl.h

Lines changed: 9 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -33,28 +33,16 @@ class UltraWideBandImpl : public UltraWideBand<UltraWideBandImpl> {
3333
return sInstance;
3434
}
3535

36-
AliroError _Init([[maybe_unused]] const Callbacks &) const { return ALIRO_ERROR_NOT_IMPLEMENTED; }
37-
AliroError _Deinit() const { return ALIRO_ERROR_NOT_IMPLEMENTED; }
38-
void
39-
_BleTimeSync() const { /* No operation for dummy implementation; override in derived classes if needed. */ };
40-
41-
AliroError _HandleBleMessage([[maybe_unused]] const uint8_t *, [[maybe_unused]] size_t) const
42-
{
43-
return ALIRO_ERROR_NOT_IMPLEMENTED;
44-
}
45-
36+
AliroError _Init([[maybe_unused]] const Callbacks &);
37+
AliroError _Deinit();
38+
void _BleTimeSync() const;
39+
AliroError _HandleBleMessage([[maybe_unused]] const uint8_t *, [[maybe_unused]] size_t);
4640
AliroError _ConfigureRangingSession([[maybe_unused]] SessionIdentifier,
47-
[[maybe_unused]] const CryptoTypes::Ursk &,
48-
[[maybe_unused]] const void *) const
49-
{
50-
return ALIRO_ERROR_NOT_IMPLEMENTED;
51-
}
52-
53-
AliroError _InitiateRangingSession() const { return ALIRO_ERROR_NOT_IMPLEMENTED; }
54-
55-
AliroError _TerminateRangingSession() const { return ALIRO_ERROR_NOT_IMPLEMENTED; }
56-
AliroError _SuspendRangingSession() const { return ALIRO_ERROR_NOT_IMPLEMENTED; }
57-
AliroError _ResumeRangingSession() const { return ALIRO_ERROR_NOT_IMPLEMENTED; }
41+
[[maybe_unused]] const CryptoTypes::Ursk &, [[maybe_unused]] void *);
42+
AliroError _InitiateRangingSession();
43+
AliroError _TerminateRangingSession();
44+
AliroError _SuspendRangingSession();
45+
AliroError _ResumeRangingSession();
5846

5947
// Delete copy and move constructors and assignment operators.
6048
UltraWideBandImpl(const UltraWideBandImpl &) = delete;

docs/door_lock_app_arch.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
:local:
88
:depth: 2
99

10-
The |APP_NAME| runs on the Nordic Semiconductor's :ref:`supported SoCs <hw_requirements>` and utilizes the Aliro stack for access protocol and communication with user device over Near Field Communication (NFC) or Bluetooth® LE.
10+
The |APP_NAME| runs on the Nordic Semiconductor's :ref:`supported SoCs <hw_requirements>` and utilizes the Aliro stack for access protocol and communication with a User Device over Near Field Communication (NFC) or Bluetooth® LE.
1111
See the following diagram for an architecture overview:
1212

1313
.. _arch_overview:
@@ -20,7 +20,7 @@ See the following diagram for an architecture overview:
2020

2121
The |APP_NAME| is build using the :ref:`nRF Connect SDK <sdk_set_up>`, which includes the Zephyr RTOS with all necessary modules.
2222

23-
The Aliro stack implements the Access Protocol logic, Aliro-specific cryptographic primitives, and communication with the user device.
23+
The Aliro stack implements the Access Protocol logic, Aliro-specific cryptographic primitives, and communication with the User Device.
2424
The interfaces layer is a bridge connecting the Aliro stack to the Zephyr OS modules through specific backends that implement the following components required by the Aliro: crypto, NFC and, ultra wideband (UWB).
2525
This layer additionally allows to utilize other, custom backends for the crypto, NFC and UWB components by implementing the provided API.
2626
By default, the |APP_NAME| uses backends shown in the :ref:`architecture overview <arch_overview>`.

docs/index.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Aliro is the new industry-standard access control and communication protocol, of
1010

1111
Aliro features several key features that distinguish it from existing access protocols:
1212

13-
* Interoperability and compatibility - Ensures seamless interaction between access readers, such as electronic locks and access control readers, and user devices like smartphone and wearables.
13+
* Interoperability and compatibility - Ensures seamless interaction between access readers, such as electronic locks and access control readers, and User Devices like a smartphone and wearables.
1414
The standardized solution allows manufacturer-independent devices and readers to work together without compromising security.
1515
* Flexibility - Does not dictate how your digital door lock or access control reader connects to the rest of your ecosystem.
1616
* Protocol support - Supports various transport protocols, including mandatory Near Field Communication (NFC), Bluetooth® LE or Bluetooth LE with Ultra-Wideband (UWB).

docs/known_issues.rst

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -46,13 +46,13 @@ AL-335: Watchdog expires for an NFC session upon test execution
4646
When executing the RD-NFC-STDTXN-2.0 test, the ``Watchdog expired for NFC session`` event occasionally occurs.
4747
This issue is caused by missing AUTH1 response from the test harness, despite logs indicating that the AUTH1 response was sent.
4848

49-
AL-239: Occasional timeout occurs in the reader when executing the RD-NFC-STDTXN-2.0 test from the test harness
50-
When executing the RD-NFC-STDTXN-2.0 test case, the reader might report an RX timeout error code in the serial console.
49+
AL-239: Occasional timeout occurs in the Reader when executing the RD-NFC-STDTXN-2.0 test from the test harness
50+
When executing the RD-NFC-STDTXN-2.0 test case, the Reader might report an RX timeout error code in the serial console.
5151
For more details, see `Test Harness issue #191`_.
5252

5353
AL-282: An undefined access decision occurs when executing the RD-NFC-STDTXN-2.0 test harness case in a loop
54-
When executing the RD-NFC-STDTXN-2.0 test case multiple times in a row (with valid credentials provisioned), the reader might not report the access decision.
55-
As a result, the ``ACCESS GRANTED`` or ``ACCESS DENIED`` logs are not displayed in the serial output of the reader under test.
54+
When executing the RD-NFC-STDTXN-2.0 test case multiple times in a row (with valid credentials provisioned), the Reader might not report the access decision.
55+
As a result, the ``ACCESS GRANTED`` or ``ACCESS DENIED`` logs are not displayed in the serial output of the Reader under test.
5656

5757
AL-148: The RD-NFC-STDTXN-1.0 test case fails when the NFC module ST X-NUCLEO-NFC05A1 is in use
5858
Testing RD-NFC-STDTXN-1.0 with the NFC module NFC05A1 results in failure.
@@ -61,22 +61,22 @@ AL-148: The RD-NFC-STDTXN-1.0 test case fails when the NFC module ST X-NUCLEO-NF
6161
**Workaround:** Switch to X-NUCLEO-NFC09A1, a newer, recommended revision of the NFC ST module.
6262
Attach X-NUCLEO-NFC09A1 shield to the nRF54L15 DK, rebuild the firmware with the ``CONFIG_ST25R200_DRV`` Kconfig option enabled, and re-flash the nRF54L15 DK.
6363

64-
AL-159: Cannot provision multiple user devices
65-
The system allows provisioning of only one user device to the reader device.
64+
AL-159: Cannot provision multiple User Devices
65+
The system allows provisioning of only one User Device to the Reader device.
6666

6767
AL-161: The RD-NFC-STDTXN-2.0 [X-NUCLEO-NFC08A1] test exhibits a delay in the transaction initiation step
6868
During the RD-NFC-STDTXN-2.0 test execution, there is a noticeable delay of a few seconds after the transaction initiation step.
6969

7070
The |APP_NAME| v0.2.0
7171
*********************
7272

73-
AL-239: Occasional timeout occurs in the reader when executing the RD-NFC-STDTXN-2.0 test from the test harness
74-
When executing the RD-NFC-STDTXN-2.0 test case, the reader might report an RX timeout error code in the serial console.
73+
AL-239: Occasional timeout occurs in the Reader when executing the RD-NFC-STDTXN-2.0 test from the test harness
74+
When executing the RD-NFC-STDTXN-2.0 test case, the Reader might report an RX timeout error code in the serial console.
7575
For more details, see `Test Harness issue #191`_.
7676

7777
AL-282: An undefined access decision occurs when executing the RD-NFC-STDTXN-2.0 test harness case in a loop
78-
When executing the RD-NFC-STDTXN-2.0 test case multiple times in a row (with valid credentials provisioned), the reader might not report the access decision.
79-
As a result, the ``ACCESS GRANTED`` or ``ACCESS DENIED`` logs are not displayed in the serial output of the reader under test.
78+
When executing the RD-NFC-STDTXN-2.0 test case multiple times in a row (with valid credentials provisioned), the Reader might not report the access decision.
79+
As a result, the ``ACCESS GRANTED`` or ``ACCESS DENIED`` logs are not displayed in the serial output of the Reader under test.
8080

8181
AL-148: The RD-NFC-STDTXN-1.0 test case fails when the NFC module ST X-NUCLEO-NFC05A1 is in use
8282
Testing RD-NFC-STDTXN-1.0 with the NFC module NFC05A1 results in failure.
@@ -86,11 +86,11 @@ AL-148: The RD-NFC-STDTXN-1.0 test case fails when the NFC module ST X-NUCLEO-NF
8686
Attach the X-NUCLEO-NFC09A1 shield to the supported Nordic development kit, rebuild the firmware with the ``CONFIG_ST25R200_DRV`` Kconfig option enabled, and reflash the DK.
8787

8888
AL-158: Access control is insufficient due to relying only on signature verification
89-
The reader device does not have the capability to configure additional access rules.
89+
The Reader device does not have the capability to configure additional access rules.
9090
Access Manager is not implemented.
9191

92-
AL-159: Cannot provision multiple user devices
93-
The system allows provisioning of only one user device to the reader device.
92+
AL-159: Cannot provision multiple User Devices
93+
The system allows provisioning of only one User Device to the Reader device.
9494

9595
AL-161: The RD-NFC-STDTXN-2.0 [X-NUCLEO-NFC08A1] test exhibits a delay in the transaction initiation step
9696
During the RD-NFC-STDTXN-2.0 test execution, there is a noticeable delay of a few seconds after the transaction initiation step.
@@ -109,11 +109,11 @@ AL-148: The RD-NFC-STDTXN-1.0 test case fails when the NFC module ST X-NUCLEO-NF
109109
Attach X-NUCLEO-NFC09A1 shield to the nRF54L15 DK, rebuild the firmware with the ``CONFIG_ST25R200_DRV`` Kconfig option enabled, and re-flash the nRF54L15 DK.
110110

111111
AL-158: Access control is insufficient due to relying only on signature verification
112-
The reader device does not have the capability to configure additional access rules.
112+
The Reader device does not have the capability to configure additional access rules.
113113
Access Manager is not implemented.
114114

115-
AL-159: Cannot provision multiple user devices
116-
The system allows provisioning of only one user device to the reader device.
115+
AL-159: Cannot provision multiple User Devices
116+
The system allows provisioning of only one User Device to the Reader device.
117117

118118
AL-161: The RD-NFC-STDTXN-2.0 [X-NUCLEO-NFC08A1] test exhibits a delay in the transaction initiation step
119119
During the RD-NFC-STDTXN-2.0 test execution, there is a noticeable delay of a few seconds after the transaction initiation step.

docs/release_notes.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ See the following section for the list of implemented features.
7272
* Transport Protocol over Near Field Communication (NFC) transport.
7373
* Trusted Framework implementation with the |NCS| PSA API as a cryptography backend.
7474
* The nRF54L15 hardware platform.
75-
* STM NFC Reader transceivers: ST25R200, ST25R3911, ST25R3916, ST25R3916B, ST25R200.
75+
* STM NFC reader transceivers: ST25R200, ST25R3911, ST25R3916, ST25R3916B, ST25R200.
7676
* ST Microelectronics R/F Abstraction Layer driver with Zephyr Platform Abstraction Layer integration.
7777
* |APP_NAME| that leverages Aliro stack and supports CLI-based provisioning of the Access Credential public key, the reader's group identifier, and the group sub-identifier.
7878
* Sample applications that uses RFAL driver.

docs/testing.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Test environment consists of two major components:
1818

1919
* The Nordic Semiconductor’s :ref:`development kit (DK) <hw_requirements>`, which serves as the Reader in the door lock component.
2020
It must be attached to an NFC card reader expansion board.
21-
* The Aliro Test Harness, which acts as the user device and simulates unlocking of the door lock.
21+
* The Aliro Test Harness, which acts as the User Device and simulates unlocking of the door lock.
2222

2323
See the :ref:`hw_requirements` page for more details.
2424

@@ -128,7 +128,7 @@ This will allow you to test the Bluetooth LE transport.
128128

129129
Test suites list.
130130

131-
Thanks to this, the Test Harness device will be operating as the Aliro user device and communicate with the Reader device.
131+
Thanks to this, the Test Harness device will be operating as the Aliro User Device and communicate with the Reader device.
132132

133133
For verification, execute the following tests, based on the `Aliro Certification Test Tool for GTE#2`_ tag:
134134

@@ -228,7 +228,7 @@ Complete the following steps for the required tests:
228228

229229
Tests selection view.
230230

231-
The Reader device will select the Test Harness user device and initiate the Aliro Access Protocol commands exchange.
231+
The Reader device will select the Test Harness User Device and initiate the Aliro Access Protocol commands exchange.
232232

233233
In the DUT's serial console, you will see logs that indicate the state of the operation and the data payloads transmitted and received by the Reader.
234234
If the results show as ``passed``, you will see the following output in the Test Harness web interface:
3.72 KB
Binary file not shown.

0 commit comments

Comments
 (0)