blob: ac49b1c86e5dece44a61b9dfd37444c68ba65e6d (
plain) (
tree)
|
|
.. SPDX-License-Identifier: CC-BY-SA-4.0
.. Copyright (C) 2019 Vijay Kumar Banerjee
.. _BSP_arm_beagle:
.. _BSP_arm_beagleboardorig:
.. _BSP_arm_beagleboardxm:
.. _BSP_arm_beagleboneblack:
.. _BSP_arm_beaglebonewhite:
beagle
======
This BSP supports four variants, `beagleboardorig`, `beagleboardxm`,
`beaglebonewhite` and `beagleboneblack`. The basic hardware initialization is
not performed by the BSP. A boot loader with device tree support must be used
to start the BSP, e.g., U-Boot.
TODO(These drivers are present but not documented yet):
* Clock driver.
* Network Interface Driver.
* SDcard driver.
* GPIO Driver.
* Console driver.
* PWM Driver.
* RTC driver.
Boot via U-Boot
---------------
To boot via uboot, the ELF must be converted to a U-Boot image like below:
.. code-block:: none
arm-rtems5-objcopy hello.exe -O binary app.bin
gzip -9 app.bin
mkimage -A arm -O linux -T kernel -a 0x80000000 -e 0x80000000 -n RTEMS -d app.bin.gz rtems-app.img
Getting the Device Tree Blob
----------------------------
The Device Tree Blob (DTB) is needed to load the device tree while starting up
the kernel. We build the dtb from the FreeBSD source matching the commit hash
from the libbsd HEAD of freebsd-org. For example if the HEAD is at
"19a6ceb89dbacf74697d493e48c388767126d418"
Then the right Device Tree Source (DTS) file is:
https://github.com/freebsd/freebsd/blob/19a6ceb89dbacf74697d493e48c388767126d418/sys/gnu/dts/arm/am335x-boneblack.dts
Please refer to the :ref:`DeviceTree` to know more about building and applying
the Device Trees.
Writing the uEnv.txt file
-------------------------
The uEnv.txt file is needed to set any environment variable before the kernel is
loaded. Each line is a u-boot command that the uboot will execute during start
up.
Add the following to a file named uEnv.txt:
.. code-block:: none
setenv bootdelay 5
uenvcmd=run boot
boot=fatload mmc 0 0x80800000 rtems-app.img ; fatload mmc 0 0x88000000 am335x-boneblack.dtb ; bootm 0x80800000 - 0x88000000
I2C Driver
----------
The Beagle has the `i2c-0` device registered at initialization. For registering
`i2c-1` and `i2c-2` ``bbb_register_i2c_1()`` and
``bbb_register_i2c_2()`` wrapper functions are respectively used.
For registering an I2C device with a custom path (say `/dev/i2c-3`) the
function ``am335x_i2c_bus_register()`` has to be used.
The function prototype is given below:
.. code-block:: C
int am335x_i2c_bus_register(
const char *bus_path,
uintptr_t register_base,
uint32_t input_clock,
rtems_vector_number irq
);
SPI Driver
----------
The SPI device `/dev/spi-0` can be registered with ``bbb_register_spi_0()``
For registering with a custom path, the ``bsp_register_spi()`` can be used.
The function prototype is given below:
.. code-block:: C
rtems_status_code bsp_register_spi(
const char *bus_path,
uintptr_t register_base,
rtems_vector_number irq
);
Debugging
---------
RTEMS's ``libdebugger`` requires the ARM debug resources be enabled for it to
work. The TI SOC used on the ``beagleboneblack`` board provides no access for
software to the ARM defined debug enable signal ``DBGEN``. The signal is
negated on power up locking software out of the ARM debug hardware. The signal
can only be accessed via the JTAG interface.
The ``beagleboneblack`` BSP provides a low level solution to enable the
``DBGEN`` signal via the JTAG interface if the board has the following
hardware modification installed. The modification requires the addition of two
small wire links soldered to the pads of the JTAG connect on the underside of
the board. A small length of fine wire, a fine tip soldering iron, some good
quality solder and a pair of fine tip pliers are required. If you are new to
soldering I suggest you find something to practice on first.
The modification details and software driver can be found in the BSP in the
file ``bsps/arm/beagle/start/bspdebug.c``. The driver is automatically run
and the ``DBGEN`` is asserted via JTAG when ``libdebugger`` is started.
The modification is:
1. Locate P2 on the bottom side of the board. It is the JTAG connector
pads. If you look at the underside of the board with the SD card holder to
the right the pads are top center left. There are 20 pads in two
columns. The pads are numbered 1 at the top left then 2 top right, 3 is
second top on the left, 4 is second top to the right, then the pin number
increments as you move left then right down the pads.
2. Connect P2 to P5.
3. Connect P7 to P13.
The resulting wiring is:
.. code-block::
1 === /--=== 2
3 === | === 4
5 ===--/ === 6
7 ===--\ === 8
9 === | === 10
11 === | === 12
13 ===--/ === 14
15 === === 16
17 === === 18
19 === === 20
.. figure:: ../../images/user/bbb-p2-debug-mod.jpg
:width: 50%
:align: center
:alt: BeagleBone Black JTAG Hardware Modification
BeagleBone Black JTAG Hardware Modification
If ``libdebugger`` fails to detect the registers open the ``bspdebug.c``
source and change ``has_tdo`` to ``1``, save then rebuild and install the
BSP. This will turn on an internal feeback to check the JTAG logic. Discard
the edit once the hardware is working.
|
