IMX RTC: Difference between revisions

From Variscite Wiki
No edit summary
No edit summary
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{PageHeader|RTC}} {{DocImage|category1=Yocto|category2=VAR-SOM-MX6}}[[Category:DART-6UL]][[Category:VAR-SOM-MX7]] __toc__
<!-- Set release according to "release" parameter in URL and use RELEASE_THUD_V1.1_DART-6UL as default
--> {{INIT_RELEASE_PARAM|RELEASE_THUD_V1.1_DART-6UL}}<!--
--> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
--> {{#lst:B2QT_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
--> {{PageHeader|{{#var:HARDWARE_NAME}} - Real Time Clock (RTC)}} {{DocImage|category1=Yocto|category2={{#var:HARDWARE_NAME}}}} __toc__
= Setting the RTC =
= Setting the RTC =
To set the RTC first set the date from Linux shell, type:<br>
{{note|Please note that starting from kernel 5.x the RTC node in the device tree must not include the IRQ pin declaration if it is not actually connected.<br>
<pre>$ date --set="20150225 09:04"
If a wrong declaration is present the hwclock command will fail.}}
</pre>
 
Then set the real time clock from Linux shell, type:<br>
First set the system date & time:
<pre>$ hwclock --systohc --utc
# date --set="20171231 23:59"
</pre>
Then set the HW RTC using the system date & time:
Power down your board wait 5 minutes and power up. Check your system with date and the time should be up to date.<br>
# hwclock --systohc --utc
 
Power down your board, wait 5 minutes and power up again, then check you system date & time and verify it is correct:
# date
 
= Wakeup using the RTC =
= Wakeup using the RTC =
Wakeup using the RTC requires hardware connection of ISL12057 IRQ2# pin to a SoC GPIO (in this example GPIO1_01).<br>
All Variscite EVKs mount RTC ISL12057, however wakeup using the RTC requires hardware connection of ISL12057 IRQ2# pin to a SoC GPIO.<br>
Configure your kernel and add Intersil ISL12057 driver. Device Drivers -> Real Time Clock  -> <*> Intersil ISL12057.<br>
By default, the defconfig of latest kernels already enable the Intersil ISL12057 driver.<br>
For VAR-SOM-MX6, edit arch/arm/boot/dts/imx6qdl-var-som.dtsi<br>
The kernel configuration item is available in Device Drivers -> Real Time Clock  -> <*> Intersil ISL12057.<br>
For DART-MX6, edit arch/arm/boot/dts/imx6qdl-var-dart.dtsi<br>
{{#ifeq: {{#var:SOC}} | mx6 |
For VAR-SOM-SOLO/VAR-SOM-DUAL/VAR-SOM-MX6 on MX6CustomBoard, SoloCustomBoard and SymphonyBoard, RTC IRQ#2 pin is not connected: RTC has no wakeup capabilities.<br>
For DART-MX6 on DT6CustomBoard, RTC IRQ#2 pin is not connected: RTC has no wakeup capabilities.
|}}
{{#ifeq: {{#var:SOC}} | mx6ul |
For DART-6UL on 6ULCustomBoard, RTC IRQ#2 pin is already connected to GPIO5_IO07, as declared in the file arch/arm/boot/dts/imx6ul-imx6ull-var-dart-6ulcustomboard.dtsi
<pre>
rtc@0x68 {
compatible = "dallas,ds1337";
reg = <0x68>;
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_rtc>;
interrupt-parent = <&gpio5>;
interrupts = <7 IRQ_TYPE_EDGE_FALLING>;
};
</pre>
For VAR-SOM-6UL on ConcertoBoard, you can short pins J14.8 & J14.10 and edit arch/arm/boot/dts/imx6ul-imx6ull-var-som-concerto-board.dtsi to declare GPIO1_IO10 as IRQ#2 pin.
<pre>
<pre>
rtc@0x68 {
rtc@0x68 {
              compatible = "isil,isl12057";
compatible = "dallas,ds1337";
              reg = <0x68>;
reg = <0x68>;
              interrupt-parent = <&gpio1>;
pinctrl-names = "default";
              interrupts = <1 IRQ_TYPE_EDGE_FALLING>;
pinctrl-0 = <&pinctrl_rtc>;
};</pre>
interrupt-parent = <&gpio1>;
interrupts = <10 IRQ_TYPE_EDGE_FALLING>;
};
</pre>
For VAR-SOM-6UL on SymphonyBoard, RTC IRQ#2 pin is not connected: RTC has no wakeup capabilities.
|}}{{#ifeq: {{#var:SOC}} | mx7 |
For VAR-SOM-MX7 on MX7CustomBoard, RTC IRQ#2 pin is not connected: RTC has no wakeup capabilities.
|}}{{#ifeq: {{#var:SOC_SERIES}} | imx8 |
{{#ifexpr:{{#rpos:{{#var:HARDWARE_NAME}}|DART}}>-1|
For {{#var:HARDWARE_NAME}} on DT8MCustomBoard, RTC IRQ#2 pin is already connected to pin J3.38 of the SoM.<br>
|}}
{{#ifeq: {{#var:SOC}} | mx8mq | |
For {{#replace:{{#var:HARDWARE_NAME}}|DART|VAR-SOM}} on SymphonyBoard, RTC IRQ#2 pin is not connected: RTC has no wakeup capabilities.
}}
{{#ifeq: {{#var:SOC}} | mx8qm |
<br>For SPEAR-MX8 on SP8CustomBoard, RTC IRQ#2 pin is not connected: RTC has no wakeup capabilities.
|}}
|}}{{#ifeq: {{#var:SOC}} | mx93 |
For VAR-SOM-MX93 on SymphonyBoard, RTC IRQ#2 pin is not connected: RTC has no wakeup capabilities.
|}}


follow the Build Linux from source code guide to build the kernel and device trees and to copy them to your SD card.Don't forget to also build and install the kernel modules.<br>
== Using rtcwake command ==
To set the RTC to wakeup after 10 seconds type:<br>  
Assuming the your board implement RTC wakeup capabilities, ensure RTC and system time are synchronized
<pre>$ rtcwake -m mem -d rtc0 -s 10
# hwclock -w
</pre>
then set the RTC to wakeup after 10 seconds type:
# echo enabled > /sys/class/rtc/rtc0/device/power/wakeup
# echo `date "+%s" -d "+ 10 seconds"` > /sys/class/rtc/rtc0/wakealarm
and immediately suspend the machine
# pm-suspend

Revision as of 14:43, 22 December 2022

Warning: This page is designed to be used with a 'release' URL parameter.

This page is using the default release RELEASE_THUD_V1.1_DART-6UL.
To view this page for a specific Variscite SoM and software release, please follow these steps:

  1. Visit variwiki.com
  2. Select your SoM
  3. Select the software release
DART-6UL - Real Time Clock (RTC)

Setting the RTC

Please note that starting from kernel 5.x the RTC node in the device tree must not include the IRQ pin declaration if it is not actually connected.
If a wrong declaration is present the hwclock command will fail.

First set the system date & time:

# date --set="20171231 23:59"

Then set the HW RTC using the system date & time:

# hwclock --systohc --utc

Power down your board, wait 5 minutes and power up again, then check you system date & time and verify it is correct:

# date

Wakeup using the RTC

All Variscite EVKs mount RTC ISL12057, however wakeup using the RTC requires hardware connection of ISL12057 IRQ2# pin to a SoC GPIO.
By default, the defconfig of latest kernels already enable the Intersil ISL12057 driver.
The kernel configuration item is available in Device Drivers -> Real Time Clock -> <*> Intersil ISL12057.

For DART-6UL on 6ULCustomBoard, RTC IRQ#2 pin is already connected to GPIO5_IO07, as declared in the file arch/arm/boot/dts/imx6ul-imx6ull-var-dart-6ulcustomboard.dtsi

rtc@0x68 {
	compatible = "dallas,ds1337";
	reg = <0x68>;
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_rtc>;
	interrupt-parent = <&gpio5>;
	interrupts = <7 IRQ_TYPE_EDGE_FALLING>;
};

For VAR-SOM-6UL on ConcertoBoard, you can short pins J14.8 & J14.10 and edit arch/arm/boot/dts/imx6ul-imx6ull-var-som-concerto-board.dtsi to declare GPIO1_IO10 as IRQ#2 pin.

rtc@0x68 {
	compatible = "dallas,ds1337";
	reg = <0x68>;
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_rtc>;
	interrupt-parent = <&gpio1>;
	interrupts = <10 IRQ_TYPE_EDGE_FALLING>;
};

For VAR-SOM-6UL on SymphonyBoard, RTC IRQ#2 pin is not connected: RTC has no wakeup capabilities.

Using rtcwake command

Assuming the your board implement RTC wakeup capabilities, ensure RTC and system time are synchronized

# hwclock -w

then set the RTC to wakeup after 10 seconds type:

# echo enabled > /sys/class/rtc/rtc0/device/power/wakeup
# echo `date "+%s" -d "+ 10 seconds"` > /sys/class/rtc/rtc0/wakealarm

and immediately suspend the machine

# pm-suspend