[ BBB - yocto (10) ] 오버레이

0) 참고하면 좋은 자료

https://www.digi.com/resources/examples-guides/use-device-tree-overlays-to-patch-your-device-tree


참고로 오버레이 지원여부는 확인해봐야 한다. 본인의 보드가 오버레이를 지원하지 않을 수도 있다.

imx6 emmc가 있는 계열은 오버레이를 사용할 수 없는 것으로 알고 있다.


챕터 9에서 설정한 uart1의 멀티플랙싱 설정, uart1 노드 속성 설정 부분을 지워두길 바란다.




 1) 디바이스 트리 오버레이란?


디바이스 트리를 수정하지 않고, 오버레이를 작성하여 사용할 핀 속성을 수정해 사용할 수 있다.


오버레이 전용 문법이 따로 존재한다.





2) 디바이스 트리 오버레이 문법


오버레이 문법은 다음과 같다


1. 상위 부분 /dts-v1/;

마찬가지로 디바이스 트리 버전을 지정한다.


2. /plugin/;

컴파일 할 때 오버레이라는 것을 컴파일러가 알아챌 수 있게 하기 위해 사용한다.


3. 노드 선언

-[fragment 고정]@[fragment 번호]


4. fragment 속성

-target : 상대 참조할 타겟 라벨 지정

-target-path : 절대 참조할 타겟 경로 지정


5. fragment 자식 노드 __overlay__

-ovelay 노드에는 타겟 라벨로 상대 참조한 노드의 속성이 들어간다.


예를들어

/dts-v1/;
/plugin/;
/{
	fragment@0 {
		target = <&node_label>;
		__overlay__{
			node-attr-1;
			child_node@0 {
                            child_node_attr;
                        };
		};
	};
};


node_label을 타겟으로 지정하여 상대 참조한다.

그러면 타겟으로 지정한 노드의 속성을 수정해 줄 수 있는데 노드 속성을 지정하거나(node-attr-1) 자식 노드(child_node)를 설정할 수 있다.


노드 속성을 추가로 설정하고 싶다면, 

/dts-v1/;
/plugin/;
/{
	fragment@0 {
		target = <&node1_label>;
		__overlay__{
			node-attr-1;
			sub_node@0 {
                            sub_node_attr;
                        };
		};
	};

	fragment@1 {
		target = <&node2_label>;
		__overlay__{
			node-attr-2;
		};
	};
};

fragment를 그대로 적고 fragment 번호를 1 늘려서 적어주면 된다.


참고로 /{ 부분은 루트 노드를 뜻하며, 오버레이를 컴파일하려면 루트 노드를 선언해주어야 한다.


루트 노드가 존재하지 않으면 오버레이를 컴파일 할 수 없어 오류가 발생한다.





3) uart1을 활성화하는 오버레이 작성하기


오버레이 작성을 위해 dts 폴더로 이동하자

$ cd poky경로/
$ source oe-init-build-env
$ cd ./tmp/work-shared/beaglebone/kernel-source/arch/arm/boot/dts
$ code .

이동 후 아래 파일을 작성하고 BB-USER_DEVICE_TREE.dtso로 저장하자


참고로 마지막에 dtso 확장자는 디바이스 트리 오버레이 확장자이다.

/dts-v1/;
/plugin/;


//BB-USER_DEVICE_TREE.dtso

#include <dt-bindings/pinctrl/am33xx.h>
/{
	fragment@0 {
		target = <&am33xx_pinmux>;
		__overlay__{
			uart1_pins: uart1-pins {
				pinctrl-single,pins = <
				AM33XX_PADCONF(AM335X_PIN_UART1_RXD, PIN_INPUT, MUX_MODE0)
				AM33XX_PADCONF(AM335X_PIN_UART1_TXD, PIN_OUTPUT, MUX_MODE0)
				>;
			};
		};
	};

	fragment@1{
		target = <&uart1>;
		__overlay__{
			pinctrl-names = "default";
			pinctrl-0 = <&uart1_pins>;
			status = "okay";
		};
	};
};


인클루드 한 이유는 omap.h의 매크로 AM33XX_PADCONF와 AM335X_PIN_이하 상수들을 사용하기 위함이다.


dts에서와 마찬가지로 속성을 지정하여 주면 된다.





4) 디바이스 트리 오버레이 빌드하기

dts 폴더에서 다음을 실행한다.

$ code Makefile


dtb-$(CONFIG_SOC_이름) 이 있는데 여기서 비글본의 코어 AM33XX를 검색하자.


우리가 만든 오버레이가 빌드되게 하려면 저기에 오버레이를 추가해주어야 한다.

#Makefile 맨 아래에 추가하기, 추가로 dtbo가 확장자임
dtb-$(CONFIG_SOC_AM33XX) += BB-USER_DEVICE_TREE.dtbo


local.conf에 추가로 설정해 주어야 한다.

$ cd poky디렉토리/build/conf/
$ code .

이후 local.conf를 열자

KERNEL_DEVICETREE:append = " BB-USER_DEVICE_TREE.dtbo"

마찬가지로 확장자를 dtbo로 지정하여 커널 디바이스 트리에 오버레이 파일을 추가한다


이후 다음 명령을 실행한다.

$ bitbake -c compile -f virtual/kernel
$ bitbake -c deploy -f virtual/kernel

이러면 deploy-ti 폴더에 BB-USER_DEVICE_TREE.dtbo 파일이 보일 것이다.





5) 디바이스 트리 오버레이 uboot 적용

uboot에서 이제 디바이스 트리를 로드하여 사용하도록 설정해주어야 한다.


로드 하는 방법은 fatload를 쓰면 된다.


디바이스 트리를 적용하는데는 3개의 명령어를 사용한다.


1. fdt addr

디바이스 트리의 주소를 uboot에 설정한다.


2. fdt resize

디바이스 트리의 남은 메모리 공간을 추가로 할당하여, 오버레이가 들어갈 공간을 마련한다.


3. fdt apply

디바이스 트리 오버레이 주소를 uboot에 설정한다. 이러면 오버레이와 디바이스 트리가 병합된다.


실제로 로드 부팅해보자.

=> bootcmd=fatload mmc 0:1 0x80000000 zImage
=> fatload mmc 0:1 0x82000000 am335x-boneblack.dtb
=> fatload mmc 0:1 0x83000000 BB-USER_DEVICE_TREE.dtbo
=> fdt addr 0x82000000
=> fdt resize 8196
=> fdt apply 0x83000000
=> bootz 0x80000000 - 0x82000000

이를 bootcmd에 지정해 주면 된다(setenv bootcmd 사용)


사실 uboot에서는 uboot.env파일을 복사하지 않고도 bootcmd와 bootargs를 설정할 수 있다.

$ bitbake -c menuconfig virtual/bootloader

나오는 메뉴화면에서 bootcmd와 bootargs를 설정하면 된다.


boot options를 선택하자


boot 인자를 활성화하고 우리가 bootargs에 적었던 인자를 적어주면 된다.

Enable boot arguments 바로 아래의 빈 공간을 엔터를 쳐서 들어간다음


이렇게 기존과 똑같이 부팅 인자를 설정해주길 바란다.


그리고 밑의 옵션을 보면 Enable a default value for bootcmd가 있는데 마찬가지로 바로 아래의 기본 명령어가 적힌 공간에서 엔터를 누른다.

bootcmd를 우리가 원하는대로 지정하자. 


bootcmd=fatload mmc 0:1 0x80000000 zImage; fatload mmc 0:1 0x82000000 am335x-boneblack.dtb; fatload mmc 0:1 0x83000000 BB-USER_DEVICE_TREE.dtbo;fdt addr 0x82000000;fdt resize 8196; fdt apply 0x83000000;bootz 0x80000000 - 0x82000000


이러고 부팅해서 uboot에서 printenv로 bootcmd와 bootargs를 찍어보면 uboot.env 파일이 없는데도 설정한 대로 되어있다.



6) 플래싱 하여 확인하기

deploy-ti로 이동한뒤 share폴더에 빌드 산출물들을 복사하자.

$ cd poky디렉토리/build/deploy-ti/images/beaglebone
$ cp zImage u-boot.img MLO core-image-fullcmdline-beaglebone.tar.xz am335x-boneblack.dtb BB-USER_DEVICE_TREE.dtbo ~/share

https://leejunggyun.blogspot.com/2025/02/sd.html

여기서 사용했던 sd_flashing.sh을 약간 수정할 것이다.

if [ $# -ne 1 ]; then
	echo $# arg number error
	echo arg1 can be disk character like a, b, c, d.
	exit -1
fi

sudo umount /dev/sd$11
sudo umount /dev/sd$12

sudo ./partitioning.sh $1
sudo mkfs.vfat -F 32 /dev/sd$11
sudo mkfs.ext4 /dev/sd$12

sudo mount /dev/sd$11 /mnt
rm -rf /mnt/*
sudo cp ./MLO /mnt
sudo cp ./u-boot.img /mnt
sudo cp ./BB-USER_DEVICE_TREE.dtbo ./zImage ./am335x-boneblack.dtb /mnt
sudo sync
sudo umount /mnt

sleep 2

sudo mount /dev/sd$12 /mnt
rm -rf /mnt/*
sudo tar -xvf core-* -C /mnt
sudo sync
sudo umount /mnt

uboot.env파일을 없애주길 바란다.


플래싱 된 비글본을 부팅하여 /proc/tty/driver/serial을 cat으로 찍어보면


uart1번이 활성화 되어있다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

[ BBB - yocto (9) ] 장치트리(DEVICE TREE)

이미지
 0) 참조하면 좋은 문서 spruh73q.pdf (am335x reference manual) https://www.ti.com/lit/ug/spruh73q/spruh73q.pdf am3358-ep.pdf(핀 속성 보려고 다운로드) https://www.ti.com/lit/ds/symlink/am3358-ep.pdf BBB_SCH.pdf (비글본 회로도) https://github.com/beagleboard/beaglebone-black/blob/master/BBB_SCH.pdf 디바이스 트리를 설명해둔 문서 https://developer.toradex.com/software/linux-resources/device-tree/device-tree-overview 1) 장치트리란? 장치트리란 커널이 사용하도록 할 장치들의 정보를 기술해놓은 파일이다. 장치 트리 파일을 바탕으로 커널은 적절한 드라이버를 로드하기도 하고 핀 멀티플랙싱(핀의 역할을 지정)등을 한다. 그럼 이 장치 트리에 대해서 알아보자. 본인의 poky 디렉토리로 이동한다. 그리고 dts 파일 쪽으로 이동하여 보자. $ cd /path/to/poky $ source oe-init-build-env $ cd build/tmp/work-shared/beaglebone/kernel-source/arch/arm/boot/dts dts 디렉토리에서 다음 명령어를 실행한다. $ code . 명령어를 실행하고 vscode 에서 ctrl + p를 눌러 다음 3개 파일을 열어보자. 이것이 장치 트리이다. 우리가 사용하고 있는 am335x-boneblack.dtb 파일은 위 4개를 컴파일 하여 dtb(디바이스 트리를  바이너리로 컴파일)한 것이다. 안의 문법을 보면 특이하게 되어 있다. 구조는 위와 같으며 안의 문법을 보면 특이하게 되어 있다. 하나씩 알아가 보자. 1. 디바이스 트리 버전 - 디바이스 트리 버전이다. 디바이스 트리를 컴파일 할 때 여기에 명시된 버전을 기준으로 컴파일 한다. 2...
자세한 내용 보기

[ BBB - yocto (11) ] uart

이미지
 1) 개요 uart 어플리케이션을 작성할 것이다. 참고로 챕터 10에서 우리가 설정한 핀이 핀헤더의 P9 24, 26번 부분이다. 패킷 구조는 간단히 보면 저렇게 되어있다. 여기에 추가로 uart 트랜시버를 사용해서 rs232 혹은 rs422, 485 등으로 변환해서 보낼 수 있는데 그에 따라 조금씩 제어 방식이 달라진다. 스탑비트, 시작 비트는 1바이트를 주로 쓰는데, 스탑비트는 2바이트로 확장해서 쓸 수 있다. 2) termios 구조체 termios.h를 인클루드하면 termios라는 구조체를 사용할 수 있다. 각 맴버 변수들에 대해서 설명하겠다. 우선 플래그에서는 uart에 대해서 패리티, 스탑 비트, 그리고 데이터 비트 수, baud레이트, 흐름제어(CRTSCTS[232, 422 전용]) 등 설정할 수 있다. 1. tcflag_t c_iflag; - input 플래그를 설정한다. 플래그 비트 값 설명 IGNPAR 0000004 패리티 무시 PARMRK 0000010 패리티 오류 표시해둠. 패리티 무시 비트가 설정되면 무시됨 INPCK 0000020 입력 패리티 체크 활성화 INLCR 0000100 줄바꿈 문자'\n' -> '\r'로 변환 IGNCR 0000200 케리지 리턴 '\r' 무시 ICRNL 0000400 케리지 리턴 '\r' -> '\n'으로 변환 IUTF8 0040000 utf8 인코딩 지원 - 이 외에도 여러 플래그들이 있지만 IGNPAR 혹은 PARMRK, INPCK 만 알아둬도 충분할 것 같다. - 자새한 내용은 /usr/include/x86_64-linux-gnu/bits/termios-c_iflag.h를 참조하길 바란다. 2. tcflag_t c_oflag; - output 플래그를 설정한다. - 거의 설정할 일이 없다... - 자새한 내용은 /usr/include/x86_64-linux-gnu/bits/termios-c_ofl...
자세한 내용 보기

[ BBB - yocto (5) ] makefile 작성법과 컴파일 자동화

이미지
1. 헤더파일 소스파일 우선 makefile에 들어가기 전에 헤더파일과 소스파일에 대해서 간단히 알아보자 - 헤더파일  1) *.h로 끝남 2) 함수, 매크로, 구조체, 열거형...등을 다른 소스파일 혹은 헤더파일에서 인클루드(#include)하여 사용할 수 있도록 해주는 파일이라 생각하면 될거야 - 소스파일 1) *.c로 끝남 2) 로직의 동작 과정을 짜는 공간이라 생각하면 됨, 주로 함수의 동작을 코드로 적어놓은 파일이야 - 해더파일과 소스파일 사용시 주의사항 1) 중복 인클루드 방지 /* gpio.h */ #ifndef __GPIO__ #define __GPIO__ //대충 함수 #endif 이 과정을 보면, #ifndef 매크로와 #define매크로로 중복 인클루드 방지 처리를 해놓은 것을 볼 수 있어 저게 없으면 헤더파일을 중복하여 인클루드하는 경우 오류가 발생하지. #ifndef [매크로 변수] : 매크로 변수가 정의되어 있지 않으면 #define [매크로 변수] : 매크로 변수를 정의한다. #endif : #if 매크로의 끝 이렇게 하면 헤더 파일을 중복 인클루드 하면 매크로 변수가 정의되어 있어 #endif로 바로 점프하게 되어 헤더파일 중복 인클루드를 방지할 수 있어. 2) 전역 변수 선언하지 않기 중복 방지를 했다고 해서 컴파일하는데 오류가 안나는건 아니야 아래 코드를 봐보자. /* gpio.h */ #ifndef __GPIO__ #define __GPIO__ int gpio; #endif 파일이 이렇게 있어 > gpio.c gpio.h main.c 코드를 이렇게 짰다고 하자 겉보기에는 아무런 문제가 없어 보여 하지만 이것을 gpio.c에서 gpio.h를 포함하려고 하고, main.c에서 gpio.h를 포함하려고하면 문제가 되어 버리지 main.c에서 gpio.h를 읽어, gpio 인트형을 만들고 gpio.c에서 gpio.h를 읽어, gpio 인트형을 만들려고 보니 이미 선언돼있네? 이래서 오류가 발생해,...
자세한 내용 보기