Building FreeBSD's SDIO driver for BeagleBone Black

Hi all, This post mainly concern with building FreeBSD's SDIO driver for BeagleBone Black by cross compiling it on AMD platform. I had few unresolved issues with the master branch of current FreeBSD tree. So, for this i used another unofficial branch: https://github.com/kibab/freebsd/tree/mmcam-new . It does have the required KERNCONF file with stable SDIO driver.

A lot of steps below are similar to the one given on: https://forums.freebsd.org/threads/cross-compiling-beaglebone-on-amd64.64718/#post-384835  with slight but inevitable changes.

Procedure:

  1.  Before proceeding you need to first install git.
    sudo pkg update -f
sudo pkg install git

  2.  Setup project directory by mkdir /BBB

  3.  Clone the repository to /BBB/src by
    git clone -b mmcam-new https://github.com/kibab/freebsd.git /BBB/src

  4. Setup environment variables as
    setenv BASEDIR /BBB
setenv MAKEOBJDIRPREFIX $BASEDIR/obj
setenv TARGET arm
setenv TARGET_ARCH armv6

    Note that sometime it shows an error like: Undefined command setenv, in that case just switch to root as sudo -E su and then try setting the environment variables again.

  5. Create image file and setup MSDOS filesystem for u-boot
    truncate -s 2048M /BBB/bbb.img
mdconfig -f /BBB/bbb.img -u md0
gpart create -s MBR md0
gpart add -t \!12 -s 10m md0
newfs_msdos -F12 -L 'MSDOSBOOT' /dev/md0s1
gpart set -a active -i 1 md0

  6. Make Buildworld and buildkernel
    cd $BASEDIR/src
make -j8 buildworld TARGET=arm TARGET_ARCH=armv6 UBLDR_LOADADDR=0x88000000 -DWITH_FDT __MAKE_CONF=/dev/null SRCCONF=/dev/null
make buildkernel TARGET_ARCH=armv6 KERNCONF=BEAGLEBONE-MMCCAM

    Note here, that if your FreeBSD AMD environment is on virtual box, for above builds to be successful you need around 2Gb of RAM and 4Gb of Swap memory with -j7 option. Swap space can be checked via swapinfo command. For adding more swap just head towards: https://www.freebsd.org/doc/handbook/adding-swap-space.html

  7. Mount the MSDOS partition and copy the uboot stuff to it.
    mount_msdosfs /dev/md0s1 /mnt
cp /usr/ports/sysutils/u-boot-beaglebone/work/u-boot-2018.03/MLO /mnt
cp /usr/ports/sysutils/u-boot-beaglebone/work/u-boot-2018.03/boot.scr /mnt
cp /usr/ports/sysutils/u-boot-beaglebone/work/u-boot-2018.03/u-boot.img /mnt
cp /BBB/obj/arm.armv6/BBB/src/sys/boot/arm/uboot/ubldr /mnt
cp /BBB/obj/arm.armv6/BBB/src/sys/boot/arm/uboot/ubldr.bin /mnt
umount /mnt

    Note that sysutils/u-boot-beaglebone port doesn't come by default, in fresh FreeBSD installation. It has to be installed by
    pkg install u-boot-beaglebone
cd /usr/ports/sysutils/u-boot-beaglebone/ && make install clean

  8. Make the freebsd-ufs partition
    mkdir /mnt1
gpart add -t freebsd md0
gpart create -s BSD md0s2
gpart add -t freebsd-ufs md0s2
newfs /dev/md0s2a
tunefs -N enable -j enable -t enable /dev/md0s2a
mount /dev/md0s2a /mnt1

  9.  Do installworld, installkernel into the partition
    make installworld TARGET_ARCH=armv6 DESTDIR=/mnt1
make distribution TARGET_ARCH=armv6 DESTDIR=/mnt1
make installkernel TARGET_ARCH=armv6 KERNCONF=BEAGLEBONE-MMCCAM DESTDIR=/mnt1

  10.  Install setup, create fstab and rc.conf
    touch /mnt1/firstboot
mkdir /mnt1/boot/msdos

ee /mnt1/etc/fstab
# Custom /etc/fstab for FreeBSD embedded images
/dev/sdda0s1    /boot/msdos    msdosfs rw,noatime    0 0
/dev/sdda0s2a    /        ufs rw,noatime        1 1

ee /mnt1/etc/rc.conf
hostname="beaglebone"
ifconfig_DEFAULT="DHCP"
sshd_enable="YES"
sendmail_enable="NONE"
sendmail_submit_enable="NO"
sendmail_outbound_enable="NO"
sendmail_msp_queue_enable="NO"

  11. Complete setup by
    umount /mnt1
mdconfig -d -u0

     

Great, you are now ready to go and dd the obtained bbb.img image to sd card. With every thing working kernel should boot up with multiple MMCCAM debug logs as in here. In case of any error, feel free to post it on the forums or comment below.

References:

  • https://forums.freebsd.org/threads/cross-compiling-beaglebone-on-amd64.64718/#post-384835

  • http://freebsd-arm.freebsd.narkive.com/dZ0TaVwR/bbb-imx6-hummingboard-sdio-driver#post14

  • https://wiki.freebsd.org/SDIO

Comments

Post a Comment

Popular posts from this blog

Understanding SD, SDIO and MMC Interface

Image
    In this blog post i will present the gist of the paper http://www.kaltech.co.il/pdf/Eureka_sd_wp1.pdf ,  It's crucial for anyone willing to understand how removable devices like sd card work, different protocols/functionalities they support. Secure Digital (SD) memory card today, is one of the most popular non-volatile removable data storage media for consumer applications. It's not intended to remove hard-disk. Hard-disk can still deliver much better speed and memory capacity. SD card is used in applications demanding optimum memory capacity, smaller size, and low end product cost.  The combination of small foot print, lower cost and optimal performance contributed in SD-card's success. What is MultiMedia Card (MMC)? MMC and Sd-card share many common features and have the same physical and electrical specifications. The differences between the two standards are mainly on the software level commands. The similarities allow many hosts to accept both MMC and SD cards on ...
Read more

Software licensing : Introduction and it's types

Image
A lot of things changes when you write your first code for commercially use. Software licensing is one of those. Usually while coding for my own projects, i earlier use to omit this. However, recently i was hit hard by this 'vague' topic of licensing. So, i decided to study in depth about different types of licenses for open source and propriety usage and here's the summary: A software license is a type of contract between the company/person who produces the code and the one who uses it. It defines the terms of usage of that piece of code. Before moving forward i have a curious question: What if, i copy a code without accepting it's license and use it under my own terms?Who's gonna know it, just copy, paste and use!! ? Well after searching the net i came across various case studies, some of which are very interesting... Reference: here Now, coming to the types of available licenses in Open source community:  GNU GPL License GPL license has mai...
Read more

Implementing a MMC/SD/SDIO stack using CAM framework(Part 2)

Image
Hi, In the next part lets look at other files which makes up the SDIO stack within mmccam framework. Please have  a look at previous part for more info: http://81.4.107.225/wordpress/index.php/2018/03/19/implementing-a-mmc-sd-sdio-stack-using-cam-framework/ mmc_sdio.c +void sdio_fill_mmcio_rw_direct(union ccb *ccb, uint8_t f, uint8_t wr, uint32_t adr, uint8_t *data) { + struct ccb_mmcio *mmcio; + + CAM_DEBUG(ccb->ccb_h.path, CAM_DEBUG_TRACE, + ("sdio_fill_mmcio(f=%d, wr=%d, adr=%02x, data=%02x)\n", f, wr, adr, (data == NULL ? 0 : *data))); + mmcio = &ccb->mmcio; + + mmcio->cmd.opcode = SD_IO_RW_DIRECT; + mmcio->cmd.arg = SD_IO_RW_FUNC(f) | SD_IO_RW_ADR(adr); + if (wr) + mmcio->cmd.arg |= SD_IO_RW_WR | SD_IO_RW_RAW | SD_IO_RW_DAT(*data); + mmcio->cmd.flags = MMC_RSP_R5 | MMC_CMD_AC; + mmcio->cmd.data->len = 0; +} sdio_fill_mmcio_rw_direct is basically a wrapper for CMD_52 that's needed ...
Read more