KernelDriverProgrammingCourse2015/OutlineDay1 - Revision history

Luteijn: /* Kernel Driver Programming Course Day 1 */ added username/password for logins

2015-08-23T11:43:08Z

Kernel Driver Programming Course Day 1: added username/password for logins

← Older revision		Revision as of 11:43, 23 August 2015
Line 34:		Line 34:
	### Now build a dtb file from the dts file:<br/> make -j4 ARCH=arm CROSS_COMPILE=arm-linux-gnu- dtbs		### Now build a dtb file from the dts file:<br/> make -j4 ARCH=arm CROSS_COMPILE=arm-linux-gnu- dtbs
	### Then install the dtb file, insert the sdcard into your laptop, mount the first partition of it, and copy arch/arm/boot/dts/sun?i-a-.dtb to the dtb directory, e.g.: <br/> sudo cp -pr arch/arm/boot/dts/sun?i-*.dtb /run/media/hans/__boot/dtb/		### Then install the dtb file, insert the sdcard into your laptop, mount the first partition of it, and copy arch/arm/boot/dts/sun?i-a-.dtb to the dtb directory, e.g.: <br/> sudo cp -pr arch/arm/boot/dts/sun?i-*.dtb /run/media/hans/__boot/dtb/
	### Boot the board again, login and do:<br/> cat /sys/firmware/devicetree/base/model<br/> to verify that your modified dtb file is being used		### Boot the board again, login and do:<br/> cat /sys/firmware/devicetree/base/model<br/> to verify that your modified dtb file is being used (root/fedora user/user)
	# Adding support for the musb otg controller to a sunxi dts file		# Adding support for the musb otg controller to a sunxi dts file
	## See [https://git.kernel.org/cgit/linux/kernel/git/mripard/linux.git/commit/?h=sunxi/for-next&id=d7a99f6bb625e7d0a256bc6e3d4538669ea22f27 the commit] enabling it on the A20 OLinuxino Lime as an example of the necessary changes		## See [https://git.kernel.org/cgit/linux/kernel/git/mripard/linux.git/commit/?h=sunxi/for-next&id=d7a99f6bb625e7d0a256bc6e3d4538669ea22f27 the commit] enabling it on the A20 OLinuxino Lime as an example of the necessary changes

Eightdot: /* Kernel Driver Programming Course Day 1 */

2015-07-26T12:35:26Z

Kernel Driver Programming Course Day 1

← Older revision		Revision as of 12:35, 26 July 2015
Line 22:		Line 22:
	### Figure out which blockdev it has been given, do:<br/> dmesg \| tail		### Figure out which blockdev it has been given, do:<br/> dmesg \| tail
	### Install u-boot by dd-ing it to the whole device (not a partition) blockdev, e.g.:<br/> sudo dd if=u-boot-sunxi-with-spl.bin of=/dev/sdc bs=1024 seek=8		### Install u-boot by dd-ing it to the whole device (not a partition) blockdev, e.g.:<br/> sudo dd if=u-boot-sunxi-with-spl.bin of=/dev/sdc bs=1024 seek=8
			### Flush buffers: sync
			### Move sdcard to the target board
	## Boot the board:		## Boot the board:
	### Plug a usb to serial convertor into your laptop		### Plug a usb to serial convertor into your laptop

Juerd: fix link

2015-07-25T20:45:02Z

fix link

← Older revision		Revision as of 20:45, 25 July 2015
Line 3:		Line 3:
	# Intro		# Intro
	## Welcome		## Welcome
	## End goal of this course is to have you all working on [KernelDriverProjects \| projects like these]		## End goal of this course is to have you all working on [[KernelDriverProjects\|projects like these]]
	## I'm going to dump a lot of information on you, don't worry you do not need to remember it all :)		## I'm going to dump a lot of information on you, don't worry you do not need to remember it all :)
	## Quickly explain of different Axx models		## Quickly explain of different Axx models

Hans de Goede at 18:06, 25 July 2015

2015-07-25T18:06:21Z

← Older revision		Revision as of 18:06, 25 July 2015
Line 48:		Line 48:
	### Use axp209.dtsi + enable the necessary regulators as described above under "Some boards are special and use the pmic ..." This will enable voltage scaling for the CPU core on these boards, after making the dts changes look for a regulator with name "DCDC2" under /sys/class/regulators, and check that when idle its voltage is aprox 1.0V and when you load the system by e.g. "md5sum /dev/urandom&" it goes up to 1.4V (as the cpu will scale up to its maximum frequency of 1GHz).		### Use axp209.dtsi + enable the necessary regulators as described above under "Some boards are special and use the pmic ..." This will enable voltage scaling for the CPU core on these boards, after making the dts changes look for a regulator with name "DCDC2" under /sys/class/regulators, and check that when idle its voltage is aprox 1.0V and when you load the system by e.g. "md5sum /dev/urandom&" it goes up to 1.4V (as the cpu will scale up to its maximum frequency of 1GHz).
	### Add and configure an lradc node to sun6i-a31-hummingbird.dts, to enable use of the home / back / menu keys of the development kit, see sun4i-a10-chuwi-v7-cw0825.dts (look for lradc) for an example.		### Add and configure an lradc node to sun6i-a31-hummingbird.dts, to enable use of the home / back / menu keys of the development kit, see sun4i-a10-chuwi-v7-cw0825.dts (look for lradc) for an example.
	### Add "codec" nodes to boards with an analog sound output, use mpg123 on the files under /root/Music to test, note the audio support is still in a bit of flux, so this ~~mau~~ not work reliably while testing. See sun7i-a20-cubietruck.dts (look for codec) for an example.		### Add "codec" nodes to boards with an analog sound output, use mpg123 on the files under /root/Music to test, note the audio support is still in a bit of flux, so this may not work reliably while testing. See sun7i-a20-cubietruck.dts (look for codec) for an example.
	## More challenging tasks:		## More challenging tasks:
	### Modify u-boot to enable the lcd display of the A31 humminbird development kit		### Modify u-boot to enable the lcd display of the A31 humminbird development kit
	### Create u-boot configs for boards which do not have a u-boot config yet. I've several of these boards with me ask and I'll give you one and I'll also give a quick intro on what needs to be done		### Create u-boot configs for boards which do not have a u-boot config yet. I've several of these boards with me ask and I'll give you one and I'll also give a quick intro on what needs to be done
	### Create kernel dts files for boards for which you've just created a u-boot config. If you do not want to create a u-boot config I've one board which already has a u-boot config, but lacks a kernel dts file.		### Create kernel dts files for boards for which you've just created a u-boot config. If you do not want to create a u-boot config I've one board which already has a u-boot config, but lacks a kernel dts file.

Hans de Goede: /* Kernel Driver Programming Course Day 1 */

2015-07-25T18:05:30Z

Kernel Driver Programming Course Day 1

@@ Line 3: / Line 3: @@
 # Intro
 ## Welcome
 ## I'm going to dump a lot of information on you, don't worry  you do not need to remember it all :)
 ## Quickly explain of different Axx models
@@ Line 42: / Line 43: @@
 ## Build and install the dts file as before
 ## Test the otg controller as demoed

Hans de Goede at 17:50, 25 July 2015

2015-07-25T17:50:50Z

← Older revision		Revision as of 17:50, 25 July 2015
Line 36:		Line 36:
	## See the A20 OLinuxino Lime [https://github.com/OLIMEX/OLINUXINO/raw/master/HARDWARE/A10-OLinuXino-LIME/A10-OLinuXino-Lime_Rev_C.pdf schematic] as an example how to figure out which gpios to use for vbus_det / id_det. Or alternatively look at the usbc0 section of [https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config/a20/a20-olinuxino_lime.fex#L727 the fex file] for the board.		## See the A20 OLinuxino Lime [https://github.com/OLIMEX/OLINUXINO/raw/master/HARDWARE/A10-OLinuXino-LIME/A10-OLinuXino-Lime_Rev_C.pdf schematic] as an example how to figure out which gpios to use for vbus_det / id_det. Or alternatively look at the usbc0 section of [https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config/a20/a20-olinuxino_lime.fex#L727 the fex file] for the board.
	## Some boards are special and use the pmic instead of a gpio for vbus-det, see e.g. the [https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config/a20/Bananapi.fex#L821 bananapi fex file]. For an example of how to deal with this in the dts file see [https://github.com/jwrdegoede/linux-sunxi/commit/a698b42a5d643250c1d0108437efad00bb7dd9a7 the commit] enabling the otg controller on the bananapi.		## Some boards are special and use the pmic instead of a gpio for vbus-det, see e.g. the [https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config/a20/Bananapi.fex#L821 bananapi fex file]. For an example of how to deal with this in the dts file see [https://github.com/jwrdegoede/linux-sunxi/commit/a698b42a5d643250c1d0108437efad00bb7dd9a7 the commit] enabling the otg controller on the bananapi.
			### These special boards need to use axp209.dtsi, so as to have the usb_power_supply node defined. This also means that they must enable the regulators which they need because including axp209.dtsi without enabling regulators explicitly will cause all axp209 regulators to get disabled leading to a non booting board. See [https://github.com/jwrdegoede/linux-sunxi/commit/6a30b7d5be6012b81e5e1439a444e41c0ac1afc1 this commit] for an example of how to include axp209.dtsi and enable the minimum set of needed regulators. Please do an lsusb before and after doing this and make sure that if a wifi chip is listed in the before lsusb output, that it does not disappear after including axp209.dtsi. If the wifi chip does disappear it is connected to another regulator, see e.g. [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/arch/arm/boot/dts/sun5i-a13-hsg-h702.dts this dts file].
	## Quick demo of how to test otg on a sunxi board		## Quick demo of how to test otg on a sunxi board
	# Hands on 2: Enable the otg controller on the board you've		# Hands on 2: Enable the otg controller on the board you've

Hans de Goede: /* Kernel Driver Programming Course Day 1 */

2015-07-25T15:27:36Z

Kernel Driver Programming Course Day 1

← Older revision		Revision as of 15:27, 25 July 2015
Line 26:		Line 26:
	### Start screen on the ttyUSB# in question, e.g.:<br/> screen /dev/ttyUSB0 115200		### Start screen on the ttyUSB# in question, e.g.:<br/> screen /dev/ttyUSB0 115200
	### Power up the board, and check that it boots properly in the screen session		### Power up the board, and check that it boots properly in the screen session
	## Build your own dts file:<br/> cd linux<br/>		## Build and install your own dts file:
			### Edit the dts file for your board:<br/> cd linux<br/> $editor arch/arm/boot/dts/sun?i-a??-$board.dts
			### At the top of the file you will see e.g. "model = "PineRiver Mini X-Plus"; This is a free format string, change the model string to something else, e.g. "Hans' test board" and then save the file
			### Now build a dtb file from the dts file:<br/> make -j4 ARCH=arm CROSS_COMPILE=arm-linux-gnu- dtbs
			### Then install the dtb file, insert the sdcard into your laptop, mount the first partition of it, and copy arch/arm/boot/dts/sun?i-a-.dtb to the dtb directory, e.g.: <br/> sudo cp -pr arch/arm/boot/dts/sun?i-*.dtb /run/media/hans/__boot/dtb/
			### Boot the board again, login and do:<br/> cat /sys/firmware/devicetree/base/model<br/> to verify that your modified dtb file is being used
	# Adding support for the musb otg controller to a sunxi dts file		# Adding support for the musb otg controller to a sunxi dts file
	## See [https://git.kernel.org/cgit/linux/kernel/git/mripard/linux.git/commit/?h=sunxi/for-next&id=d7a99f6bb625e7d0a256bc6e3d4538669ea22f27 the commit] enabling it on the A20 OLinuxino Lime as an example of the necessary changes		## See [https://git.kernel.org/cgit/linux/kernel/git/mripard/linux.git/commit/?h=sunxi/for-next&id=d7a99f6bb625e7d0a256bc6e3d4538669ea22f27 the commit] enabling it on the A20 OLinuxino Lime as an example of the necessary changes

Hans de Goede: /* Kernel Driver Programming Course Day 1 */

2015-07-25T15:18:14Z

Kernel Driver Programming Course Day 1

← Older revision		Revision as of 15:18, 25 July 2015
Line 11:		Line 11:
	## For clock tree info see: [https://github.com/allwinner-zh/documents/raw/master/A10/A10%20datasheet%20V1.7%2020121227.pdf A10 Datasheet] Clock tree diagram (pages 51 - 54)		## For clock tree info see: [https://github.com/allwinner-zh/documents/raw/master/A10/A10%20datasheet%20V1.7%2020121227.pdf A10 Datasheet] Clock tree diagram (pages 51 - 54)
	# dts file example for a simple board		# dts file example for a simple board
	## https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/arch/arm/boot/dts/sun4i-a10-mini-xplus.dts \| sun4i-a10-mini-xplus.dts]		## [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/arch/arm/boot/dts/sun4i-a10-mini-xplus.dts sun4i-a10-mini-xplus.dts]
			## [https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config/a10/mini-x-1gb.fex fex file for the mini-x board]
	# Hands on 1: Build and install u-boot and a dts file and boot the board		# Hands on 1: Build and install u-boot and a dts file and boot the board
	## Everyone gets a board, a usb to serial convertor and a sdcard		## Everyone gets a board, a usb to serial convertor and a sdcard
Line 25:		Line 26:
	### Start screen on the ttyUSB# in question, e.g.:<br/> screen /dev/ttyUSB0 115200		### Start screen on the ttyUSB# in question, e.g.:<br/> screen /dev/ttyUSB0 115200
	### Power up the board, and check that it boots properly in the screen session		### Power up the board, and check that it boots properly in the screen session
			## Build your own dts file:<br/> cd linux<br/>
	# Adding support for the musb otg controller to a sunxi dts file		# Adding support for the musb otg controller to a sunxi dts file
	## See [https://git.kernel.org/cgit/linux/kernel/git/mripard/linux.git/commit/?h=sunxi/for-next&id=d7a99f6bb625e7d0a256bc6e3d4538669ea22f27 the commit] ~~enalbing~~ it on the A20 OLinuxino Lime as an example of the necessary changes		## See [https://git.kernel.org/cgit/linux/kernel/git/mripard/linux.git/commit/?h=sunxi/for-next&id=d7a99f6bb625e7d0a256bc6e3d4538669ea22f27 the commit] enabling it on the A20 OLinuxino Lime as an example of the necessary changes
	## See the A20 OLinuxino Lime [https://github.com/OLIMEX/OLINUXINO/raw/master/HARDWARE/A10-OLinuXino-LIME/A10-OLinuXino-Lime_Rev_C.pdf schematic] as an example how to figure out which gpios to use for vbus_det / id_det. Or alternatively look at the [https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config/a20/a20-olinuxino_lime.fex fex file] for the board.		## See the A20 OLinuxino Lime [https://github.com/OLIMEX/OLINUXINO/raw/master/HARDWARE/A10-OLinuXino-LIME/A10-OLinuXino-Lime_Rev_C.pdf schematic] as an example how to figure out which gpios to use for vbus_det / id_det. Or alternatively look at the usbc0 section of [https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config/a20/a20-olinuxino_lime.fex#L727 the fex file] for the board.
			## Some boards are special and use the pmic instead of a gpio for vbus-det, see e.g. the [https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config/a20/Bananapi.fex#L821 bananapi fex file]. For an example of how to deal with this in the dts file see [https://github.com/jwrdegoede/linux-sunxi/commit/a698b42a5d643250c1d0108437efad00bb7dd9a7 the commit] enabling the otg controller on the bananapi.
			## Quick demo of how to test otg on a sunxi board
			# Hands on 2: Enable the otg controller on the board you've
			## Modify the dts file for your board in the same way as done in the provided examples
			## Build and install the dts file as before
			## Test the otg controller as demoed

Hans de Goede: /* Kernel Driver Programming Course Day 1 */

2015-07-25T14:56:34Z

Kernel Driver Programming Course Day 1

← Older revision		Revision as of 14:56, 25 July 2015
Line 12:		Line 12:
	# dts file example for a simple board		# dts file example for a simple board
	## https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/arch/arm/boot/dts/sun4i-a10-mini-xplus.dts \| sun4i-a10-mini-xplus.dts]		## https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/arch/arm/boot/dts/sun4i-a10-mini-xplus.dts \| sun4i-a10-mini-xplus.dts]
	# Hands on 1		# Hands on 1: Build and install u-boot and a dts file and boot the board
	## Everyone gets a board		## Everyone gets a board, a usb to serial convertor and a sdcard
	## Build and install u-boot:		## Build and install u-boot:
	### Figure out the config to use for your board, do:<br/> cd u-boot<br/> grep -l SUNXI configs/*_defconfig		### Figure out the config to use for your board, do:<br/> cd u-boot<br/> grep -l SUNXI configs/*_defconfig
	### Build u-boot for your board, do:<br/> make -j4 CROSS_COMPILE=arm-linux-gnu- $foo_defconfig<br/> make -j4 CROSS_COMPILE=arm-linux-gnu-		### Build u-boot for your board, do:<br/> make -j4 CROSS_COMPILE=arm-linux-gnu- $foo_defconfig<br/> make -j4 CROSS_COMPILE=arm-linux-gnu-
			### Insert the provided sdcard into your laptop
			### Figure out which blockdev it has been given, do:<br/> dmesg \| tail
			### Install u-boot by dd-ing it to the whole device (not a partition) blockdev, e.g.:<br/> sudo dd if=u-boot-sunxi-with-spl.bin of=/dev/sdc bs=1024 seek=8
			## Boot the board:
			### Plug a usb to serial convertor into your laptop
			### Figure out which ttyUSB# it has been given, do:<br/> dmesg \| tail
			### Start screen on the ttyUSB# in question, e.g.:<br/> screen /dev/ttyUSB0 115200
			### Power up the board, and check that it boots properly in the screen session
			# Adding support for the musb otg controller to a sunxi dts file
			## See [https://git.kernel.org/cgit/linux/kernel/git/mripard/linux.git/commit/?h=sunxi/for-next&id=d7a99f6bb625e7d0a256bc6e3d4538669ea22f27 the commit] enalbing it on the A20 OLinuxino Lime as an example of the necessary changes
			## See the A20 OLinuxino Lime [https://github.com/OLIMEX/OLINUXINO/raw/master/HARDWARE/A10-OLinuXino-LIME/A10-OLinuXino-Lime_Rev_C.pdf schematic] as an example how to figure out which gpios to use for vbus_det / id_det. Or alternatively look at the [https://github.com/linux-sunxi/sunxi-boards/blob/master/sys_config/a20/a20-olinuxino_lime.fex fex file] for the board.

Hans de Goede: Created page with "== Kernel Driver Programming Course Day 1 == # Intro ## Welcome ## I'm going to dump a lot of information on you, don't worry you do not need to remember it all :) ## Quick..."

2015-07-25T13:56:33Z

Created page with "== Kernel Driver Programming Course Day 1 == # Intro ## Welcome ## I'm going to dump a lot of information on you, don't worry you do not need to remember it all :) ## Quick..."

New page

== Kernel Driver Programming Course Day 1 ==

# Intro
## Welcome
## I'm going to dump a lot of information on you, don't worry you do not need to remember it all :)
## Quickly explain of different Axx models
## [https://github.com/allwinner-zh/documents/raw/master/A10/A10%20datasheet%20V1.7%2020121227.pdf A10 Datasheet] Block diagram (page 12), give a quick overview of the A10
# A10 SoC dtsi file (example)
## [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/arch/arm/boot/dts/sun4i-a10.dtsi sun4i-a10.dtsi]
## For a list of addresses see the [https://github.com/allwinner-zh/documents/raw/master/A10/A10%20User%20manual%20V1.5%2020130820.pdf A10 user manual], section 3.2 "Memory mapping", and 11.2 "Interrupt Source"
## For clock tree info see: [https://github.com/allwinner-zh/documents/raw/master/A10/A10%20datasheet%20V1.7%2020121227.pdf A10 Datasheet] Clock tree diagram (pages 51 - 54)
# dts file example for a simple board
## https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/arch/arm/boot/dts/sun4i-a10-mini-xplus.dts | sun4i-a10-mini-xplus.dts]
# Hands on 1
## Everyone gets a board
## Build and install u-boot:
### Figure out the config to use for your board, do:<br/> cd u-boot<br/> grep -l SUNXI configs/*_defconfig
### Build u-boot for your board, do:<br/> make -j4 CROSS_COMPILE=arm-linux-gnu- $foo_defconfig<br/> make -j4 CROSS_COMPILE=arm-linux-gnu-