Skip to content

Latest commit

 

History

History
132 lines (95 loc) · 5.41 KB

INSTALL_AM64X_SK.md

File metadata and controls

132 lines (95 loc) · 5.41 KB
Raw

wfantund Installation Guide on TI AM64x

wfantund is derived from wpantund and modified to meet the needs of TI Wi-SUN FAN Solution.

This document describes the process of building and installing wfantund on TI AM64x SK (https://www.ti.com/tool/SK-AM64).

AM64x Linux Development Environment Setup

	mkdir <SDK_PATH>/targetNFS
	cd 	<SDK_PATH>/targetNFS
	tar -xvf  <SDK_PATH>/filesystem/tisdk-default-image-am64xx-evm.tar.xz

  • Alternate Method: Run ./setup.sh

    • Important: Default targetNFS uses the tisdk-docker image. It is recommend to use the tisdk-default image
    • Set up root filesystem at default location <SDK_PATH>/targetNFS

Preparation of AM64x SD Card Image:

  • Perform steps in ti-wisun-webapp/README.md to install updated npm/node versions
  • Download lib-coap from https://github.com/obgm/libcoap/tree/release-4.3.0
    (Note: This is needed for AM64x. AM64x native SDK does not provide support to lib coap today.)
  • Setup the AutoConf dependencies sudo apt-get install autoconf autoconf-archive
  • run setup_AM64x_fileSystem.sh <AM64_SDK_PATH> <LIB_COAP DOWNLOAD PATH>
    • The Script performs the following
      • Cross compiles to AM64x platform
      • Sets up the webserver components and service start scripts
      • Sets the root file system for AM64x under <SDK_PATH>/targetNFS
  • Insert SD Card into PC & Call bin/create-sdcard.sh script provided in AM64x SDK with root privileges
    • Script will automatically partition the SD Card and prepare it for AM64x (select atleast 2 partitions)
    • Script will ask for boot folder, Linux Kernel images and root files ystem
      • Boot: recommend to provide pre-built boot: <SDK_PATH>/board-support/prebuilt-images
      • Linux Kernel: Use the option that allows Kernel images to be used from the root filesystem
      • RootFileSystem: Specify the path to prepared root file system (<SDK_PATH>/targetNFS)

Preparation of TI CC13xx Images:

TI Wi-SUN FAN OOB Demo:

  • Insert SD card in AM64x SK, connect BR NWP to its USB Port & Power On
  • AM64x will boot and automatically start the BR and ti-wisun-webapp (Note: This may take up to 2 minutes)
  • Use Mobile Phone or PC to search for WiFi Access Point TI AM64xsk_AP
  • Connect to WiFi using default password (tiwilink8)
  • Power on the two (or more) TI CC13x2R7 Launchpads with OOB node CoAP examples  (Green LED will blink fast to indicate it is trying to join the network)
  • Open Web-browser and go to 192.168.43.1:8035
  • Wait for the Wi-SUN router nodes to Join
    • The Green LED will slow down the rate at which it blinks as it gets closer to joining the Border Router
    • The Green LED will stop blinking after joining the network
    • Note: This may take around 3 - 5 minutes

User can configure and monitor the network

Trouble Shooting OOB Demo

The setup_AM64x_fileSystem.sh sets up the run configuration directories with an init script for running the ti-wisun-webapp on boot.

If the nodes do not join as expected after ~5-7 minutes one can restart wfantund as follows:

  • Simply unplug and replug the Wi-SUN Border Router NWP device.

    • It will trigger restart wfantund execution from the webapp
    • Remember to restart the nodes as the Border Router will be re-started

Cross Compiling for AM64x

The setup_AM64x_fileSystem.sh script performs the following cross compilation steps for wfantund and lib-coap. The steps are provided here for reference.

Wfantund compiling & setup instructions

From wfantund base folder:

#Set the toolchain & other cross-compile environment by using SDK environment setup
source <SDK_PATH>/linux-devkit/environment-setup-aarch64-linux

#run the bootstap.sh
sudo ./bootstrap.sh

# configure for aarch-64
./configure --sysconfdir=/etc --host=aarch64

#if there were precious makes performed, it is recommend to do a make clean
make clean

# cross compile
sudo --preserve-env=PATH make

# Install the compiled wfantund and wfanctl to the "target's root file system"
sudo make DESTDIR=<SDK_PATH>/targetNFS install

Cross Compiling libcoap

Download libcoap package from https://github.com/obgm/libcoap/tree/release-4.3.0

# Starting a clean build
sudo ./autogen.sh --clean

# Set the toolchain & other cross-compile environment by using SDK environment setup
source <SDK_PATH>/linux-devkit/environment-setup-aarch64-linux

# Run autogen
sudo ./autogen.sh

# Configure for aarch64
./configure --host=aarch64-linux  --target=aarch64-linux --prefix=/home/sdwk01/ti/ti-processor-sdk-linux-am64xx-evm-08.00.00.21/targetNFS -disable-doxygen --disable-manpages

# compile the software for target
make

# lib-coap make install uses the PATH ENV obtained from source command. Hence, preserve it when calling make install using sudo. DESTDIR is obtained from the prefix option used in configure command
sudo --preserve-env=PATH make install