How to use of RTC to wake up from sleep

RE: How to use of RTC to wake up from sleep

Einar Thorsrud — Mon, 29 Jul 2024 13:05:55 GMT

Hi,

k_sleep will sleep for the specified amount of time regardless of what happens. But it is only the thread with the k_sleep that will sleep. interrupts can still be processed, and other threads will still run. If you may need to process something in the sleeping thread it may be better to wait for a message queue with a timeout or similar (depending on your specific needs). You may find the first module in the nRF Connect SDK Intermediate course relevant.

RE: How to use of RTC to wake up from sleep

zsn — Sun, 14 Jul 2024 16:04:13 GMT

Hi, Einar Thorsrud I see 3 years already passed since your discussion here. But I have a question for rtc. You suggested here to use ksleep instead of rtc. I was wondering if I use a k_sleep, dont i have to wait until the ksleep timer expires to use that thread? If i have an interrupt and need to process it in that thread, then how can I cancel k_sleep and claim back that thread?

RE: How to use of RTC to wake up from sleep

Einar Thorsrud — Fri, 26 Feb 2021 14:14:00 GMT

Hi Mohamed,

To you use nrfx_saadc API directly you need to include nrfx_saadc.h. You can see a few examples of its usage here:

You need to have CONFIG_ADC_NRFX_SAADC=y for this. That should be implicitly set, though as you allready have CONFIG_ADC=y.

Einar

RE: How to use of RTC to wake up from sleep

Learner — Fri, 26 Feb 2021 11:01:12 GMT

Hello Einar,

Thank you.

You are right, I am using functions adc_read() to read adc results. So, I am using Zephyr ADC NOT nrfx_saadc API. These are the header files I am currently including in my adc.c file.

#include <zephyr.h>
#include <kernel.h>
#include <sys/printk.h>
#include <drivers/adc.h>
#include <hal/nrf_saadc.h> /*ADC definitions and includes*/
#include <device.h>
#include <drivers/gpio.h>

Which header files should I be including for nrfx_saadc APIs and which one ones should I remove from the ones currently included above or can they co-exist?

Also, do I have to change the prj.conf file?

it currently contains this line CONFIG_ADC=y.

Finally, do you an example you can share with me that uses nrfx_saadc APIs

Kind regards

Mohamed

RE: How to use of RTC to wake up from sleep

Einar Thorsrud — Fri, 26 Feb 2021 10:38:55 GMT

Hi Mohamed,

[quote user="Learner"]I am not sure. How do I know for sure if I am using nrfx_saadc API?[/quote]

You can know by looking at the functions you call to use the SAADC. Do you for instance call functions that look like nrfx_saadc_() or do they look like adc_*()? I assume the latter as you get undefined reference to nrfx_saadc_uninit().

If you want to use the nrfx API instead then you should include the nrfx_saadc.h file. This may be useful if you are not able to get the ADC current consumption down without disabling it, as the Zephyr ADC API does not have any API for that.

Br,

Einar

RE: How to use of RTC to wake up from sleep

Learner — Thu, 25 Feb 2021 22:00:58 GMT

Hi Einar,

Thank you for the tips.

[quote userid="7377" url="~/f/nordic-q-a/71977/how-to-use-of-rtc-to-wake-up-from-sleep/296321#296321"]Are you using the nrfx_saadc API? [/quote]

I am not sure. How do I know for sure if I am using nrfx_saadc API?

I looked in the build.emProject file and I can see the following which suggests I am using nrfx_saadc API. An extract from build.emProject is included below. The file nrfx_saadc_uninit() is declared in the header file C:\Zypher\v1.5.0-rc1\modules\hal\nordic\nrfx\drivers\include\nrfx_saadc.h which is included in the project file below. However, I cannot build the project because it returns the error undefined reference to nrfx_saadc_uninit().

</project>
<project Name="app/libapp.a">
<configuration
Name="Common"
build_output_file_name="app\libapp.a"
project_dependencies="cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;cmake_object_order_depends_target_app;zephyr/driver_validation_h_target;zephyr/kobj_types_h_target;zephyr/syscall_list_h_target;zephyr/zephyr_generated_headers"
project_directory=""
project_type="Externally Built Library" />
<folder Name="C_COMPILER__app_">
<file file_name="../src/adc/pid4_adc.c">
<configuration
Name="Common"
build_dependency_file_name="$(ProjectDir)/CMakeFiles\app.dir\src\adc\pid4_adc.c.obj.d"
build_object_file_name="CMakeFiles/app.dir/src/adc/pid4_adc.c.obj"
c_only_additional_options="-DBUILD_VERSION=v2.4.99-ncs1-rc1;-DKERNEL;-DNRF5340_XXAA_APPLICATION;-DUSE_PARTITION_MANAGER=0;-D_FORTIFY_SOURCE=2;-D__LINUX_ERRNO_EXTENSIONS__;-D__PROGRAM_START;-D__ZEPHYR__=1;
-IC:/Zypher/v1.5.0-rc1/modules/hal/nordic/nrfx/drivers/include
-IC:/Zypher/v1.5.0-rc1/zephyr/include;-Izephyr/include/generated;
-IC:/Zypher/v1.5.0-rc1/zephyr/soc/arm/nordic_nrf/nrf53;
-IC:/Zypher/v1.5.0-rc1/zephyr/lib/libc/newlib/include;
-IC:/Zypher/v1.5.0-rc1/nrf/include;
-IC:/Zypher/v1.5.0-rc1/modules/hal/cmsis/CMSIS/Core/Include;
-IC:/Zypher/v1.5.0-rc1/modules/hal/nordic/nrfx;
-IC:/Zypher/v1.5.0-rc1/modules/hal/nordic/nrfx/drivers/include;
-IC:/Zypher/v1.5.0-rc1/modules/hal/nordic/nrfx/mdk;
-IC:/Zypher/v1.5.0-rc1/zephyr/modules/hal_nordic/nrfx/.;
-IC:/Zypher/v1.5.0-rc1/modules/debug/segger/rtt;
-isystem;C:/Zypher/v1.5.0-rc1/nrfxlib/crypto/nrf_cc312_platform/include;
-Og;-imacros;
...

I have this config line in my prj.conf file

CONFIG_ADC=y

Which header file should I be including?

Kind regards

Mohamed

RE: How to use of RTC to wake up from sleep

Einar Thorsrud — Thu, 25 Feb 2021 14:53:05 GMT

Hi Mohamed,

Are you using the nrfx_saadc API? If so you can call nrfx_saadc_uninit() after finishing the conversion. If current consumption is still high after uninitializing then you can use the following as well:

    *(volatile uint32_t *)0x40007FFC = 0;
    *(volatile uint32_t *)0x40007FFC = 1;

The above snippet uses an undocumented register to reset the SAADC peripheral.

Einar

RE: How to use of RTC to wake up from sleep

Learner — Thu, 25 Feb 2021 14:39:49 GMT

Thank you Einar.

I experimented with the ADC and stopped reading the ADC results to see what effect it has on current consumption. To my disbelief the current consumption increased. How can this be?

Note, the ADC was still initialised and bound. For the ADC peripheral there must be a disable or power down procedure to go through.

I have not played with the SPI yet.

Kind regards

Mohamed

RE: How to use of RTC to wake up from sleep

Einar Thorsrud — Thu, 25 Feb 2021 12:46:20 GMT

Hi Mohamed,

That is different for different peripherals and also sometimes depending on which driver you use. Often it is enough to not have an active transaction or stopping it (so essentially not use it). In some other cases you may need to uninit the driver in order to properly shut down. You can refer to the API of the relevant drivers to see how.

Also, it may be useful to experiment by commenting out initialization and usage of peripherals and gradually include again if you have a unexpected current consumption and want to narrow down where what causes it. Then you can look at that peripheral and the related code specifically.

Einar

RE: How to use of RTC to wake up from sleep

Learner — Wed, 24 Feb 2021 16:16:15 GMT

OK, thank you.

Your answer has led me to my next question.

How do I disable or power down the peripherals e.g. ADC, SPI...?

Kind regards

Mohamed

RE: How to use of RTC to wake up from sleep

Einar Thorsrud — Wed, 24 Feb 2021 16:10:17 GMT

Hi Mohamed,

You will have to disable peripherals such as ADC, SPI etc explicitly. This makes sense in a practical use case as you often would need to keep some peripherals active but not the CPU (as most peripherals operate on DMA so the CPU is typically only needed to start an operation and then in the end to process the result).

Einar

RE: How to use of RTC to wake up from sleep

Learner — Wed, 24 Feb 2021 14:08:00 GMT

Thank you Einar.

I got it.

You are right I do not need to use RTC, k_sleep() will do the job.

I am trying to optimise power usage, will k_sleep() put peripheral devices such as ADC, SPI in low power mode?

Or do I have to do this separately before calling k_sleep()?

Kind regards

Mohamed

RE: How to use of RTC to wake up from sleep

Einar Thorsrud — Wed, 24 Feb 2021 13:37:52 GMT

Hi Mohamed,

The sample is located under <ncs>/zephyr/samples/basic/threads/

Einar

RE: How to use of RTC to wake up from sleep

Learner — Wed, 24 Feb 2021 13:35:13 GMT

Thank you.

I get it that my main() function is an implicit thread running under Zephyr.

I tried to get to the source code of the basic thread example but I could not. All I could see was the README.html file.

How can I view and download the project?

Kind regards

Mohamed

RE: How to use of RTC to wake up from sleep

Einar Thorsrud — Wed, 24 Feb 2021 13:25:36 GMT

Hi Mohamed,

[quote user="Learner"]I am not using threads for now. I may be using threads at some point in the near future.[/quote]

If you are using Zephyr you are using threads, even if you may not be aware of it. Your main function is a thread (see system threads documentation for more). So using k_sleep is still the most appropriate.

[quote user="Learner"]Could you please provide an example where the RTC is used to come out of sleep?[/quote]

There are no official simple RTC sample in the NCS, but you can refer to this unofficial sample (it is for the nRF9160 but the code is equally relevant for the nRF53).

[quote user="Learner"]Are you saying there are few good reasons for NOT using the built-in thread and work queues?[/quote]

Yes.

[quote user="Learner"]In other ways you are discouraging me from using threads. Is this what you meant to say?[/quote]

No, I am discouraging you from using the RTC driver and handling this yourself as the appropriate way to do this is to use what Zephyr provides for you. To expand on this: Using an RTC directly will work, and it is not complicated. But it is just not clean to use a special approach in place of a core feature of the RTOS you are using which does exactly the same thing.

Einar

RE: How to use of RTC to wake up from sleep

Learner — Wed, 24 Feb 2021 13:04:40 GMT

Thank you Einar for the quick response.

I am not using threads for now. I may be using threads at some point in the near future.

[quote userid="7377" url="~/f/nordic-q-a/71977/how-to-use-of-rtc-to-wake-up-from-sleep/296014#296014"]You are free to use an RTC peripheral directly and do it that way,[/quote]

Could you please provide an example where the RTC is used to come out of sleep?

[quote userid="7377" url="~/f/nordic-q-a/71977/how-to-use-of-rtc-to-wake-up-from-sleep/296014#296014"]but there are few good reasons for not using the build in thread and work queues support in Zephyr as suggested above.[/quote]

Are you saying there are few good reasons for NOT using the built-in thread and work queues?

In other ways you are discouraging me from using threads. Is this what you meant to say?

Kind regards

Mohamed

RE: How to use of RTC to wake up from sleep

Einar Thorsrud — Wed, 24 Feb 2021 12:30:07 GMT

Hi Mohamed,

The Zephyr RTOS handles this for you. In the idle thread it will essentially call WFE, to enter system on low power mode. If you want to wake up after some time to do some work, you can use k_sleep() or similar. You can refer to the basic thread example to see how this is done.

You are free to use an RTC peripheral directly and do it that way, but there are few good reasons for not using the build in thread and work queues support in Zephyr as suggested above.

Einar