BLUEGIGA APX4 SOFTWARE DEVELOPMENT KIT - Digi-Key
Contents
1. BLUEGIGA APX4 SOFTWARE DEVELOPMENT KIT USER GUIDE Wednesday 10 April 2013 Version 5 0 0 beta10 ENTE sis gt Copyright 2001 2012 Bluegiga Technologies Bluegiga Technologies reserves the right to alter the hardware software and or specifications detailed herein at any time without notice and does not make any commitment to update the information contained herein Bluegiga Technologies assumes no responsibility for any errors which may appear in this manual Bluegiga Technologies products are not authorized for use as critical components in life support devices or systems Bluegiga Access Server Access Point APx4 AX4 BSM iWRAP BGScript and WRAP THOR are trademarks of Bluegiga Technologies The Bluetooth trademark and logo are registered trademarks and are owned by the Bluetooth SIG Inc ARM and ARMG are trademarks of ARM Ltd Linux is a trademark of Linus Torvalds All other trademarks listed herein belong to their respective owners TABLE OF CONTENTS TINTO cl AA AA AA AA 4 114 GI0SSAN EA ND a ica este oh ab vcd RN cine NAY ER Rad ee er cae snd hao hap Pan aaa 4 1 2 SDK directory layout sa ia fas takes State Lanes Sake ee Ea he Ped BEDA ee athe ah 5 13 Meta lay CIS aaa anan shed a aa eine a NG ce a NANG a eaten douse ioe gute Guichen rl Gatch 5 1 4 Other interesting links 0 ccc ete eee 6 Ty5 Sources forrecipes lt 2 FM A a ek tested was se toed Ge Gn A Se 6 2 Etna started vis sel SN2. and click on the first item in the list the project will be built again and executable sent to remote device 7 4 Debugging the project In order to debug the project you need to install the gdbserver package on the remote system Log in to the remote system as root and issue the following command pene DOK Ww CYA AA AA AA AA AA PAA PA AA PAP A AA PA AA AA S opkg update S opkg install gdbserver From the Run menu select Debug Configurations The run configuration you created previously should be selected on the list on the left hand side of the window Select the Debugger tab Put arm bluegiga linux gnueabi gdb into the GDB debugger field Click Debug If the Open Associated Perspective prompt appears click Yes to get into the debug perspective The debug perspective should open up and show the first line of the main function of your application The next time you want to debug your application it is enough to click on the menubar Run gt Debug History and click on the first item in the list Copyright 2001 2012 Bluegiga Technologies Page 21 of 22 8 Contact information Sales Technical support Orders WWW Head Office Finland Head address Finland Sales Office USA Sales Office Hong Kong sales bluegiga com support bluegiga com http techforum bluegiga com orders bluegiga com http www bluegiga com http www bluegiga hk Phone
3. 358 9 4355 060 Fax 358 9 4355 0660 Sinikalliontie 5 A 02630 ESPOO FINLAND P O Box 120 02631 ESPOO FINLAND Phone 1 770 291 2181 Fax 1 770 291 2183 Bluegiga Technologies Inc 3235 Satellite Boulevard Building 400 Suite 300 Duluth GA 30096 USA Phone 852 3182 7321 Fax 852 3972 5777 Bluegiga Technologies Inc Unit 10 18 32 F Tower 1 Millennium City 1 388 Kwun Tong Road Kwun Tong Kowloon Hong Kong Copyright O 2001 2012 Bluegiga Technologies Page 22 of 22
4. It handles package dependencies and executes build commands Recipe contains building instructions for bitbake It has information about url of source code package rules of compiling and package dependencies All applications have their own recipes Layeris a Yocto term to indicate a set of recipes and configuration files Recipes are divided into different layers such as board support and distribution meta layers bpk indicates Bluegiga package format It can contain complete filesystem images for the APx4 or scripts that are run when the package is installed Reflash is a term used in the name of special bpk packages containing full file system images A reflash bpk can be installed using the web interface or by other ways for example by uploading it to the tmp autoinstall directory lpkis a package format used by the OPKG package management system Copyright O 2001 2012 Bluegiga Technologies Page 4 of 22 1 2 SDK directory layout t bluegiga sdk t build in this build folder bitbake command is executed fol sel sel der t conf local conf ected here t bblayers conf ected here local configuration file bitbake layer config file e g target meta layers are machine is tmp deploy t images after building t ipk into subfolders t all t armvbte t apx4devkit work built and packaged file system images and u boot binaries are here location for ipk packages pac
5. haa hana ie 15 GST GR IO a a a aga aa a akaya aretha nate EN pan Nka han An tos nana Na BA han Ng a dos 15 612 120 Aa A Nan gg Dat BA la AA 18 6 2 LIDTANGS sasak a a na Paa ando bhla 7 ECIIPSO SUPDOML a ra NS te E E A BN A A E E NADAAN NPA 19 7 1 Setting up the development environment 0 cece tte 19 7 1 1 Step 1 Install the Bluegiga SDK aaa aaa aaa aaa 19 7 1 2 Step 2 Prepare IDE support aaa aa aaa aa aaa aa aa aaa aaa 19 7 1 3 Step 3 Install the Eclipse Juno IDE eee 19 7 1 4 Step 4 Install required plugins_ a a a aaa aa aaa eaaa 19 7 1 5 Step 5 Configure the Eclipse Yocto Plugin aa aaa eee 20 7 2 Creating a new project aaa aaa aa aa a aaa a aa aa aaa aa aa eee 20 7 3 Building and deploying the project aaa aaa aaa aaa aaa aaa 20 7 4 Debugging the project a aaa e aa a a eaaa aa eaaa aaa eaaa aaa eaaa 21 8 Gontactinformatione 112280212129103 hae kaa ja Ten GEN Gak Aa a cate aw at Ka akeni KN ga Aa KA aa kaka te de Dec te Gag a aa a Na Ea 22 1 Introduction Bluegiga SDK is based on Yocto project build system Yocto offers powerful tools for cross compiling and debugging embedded applications and is also used to prepare custom distributions like the one used as the default for the APx4 Yocto build system is very flexible and it is delivered with hundreds of open source applications 1 1 Glossary Bitbake is the application cooker
6. in an installable reflash bpk package 2 2 5 Step 5 Copy Re flash package to target You can now install the compiled Re flash package into the APx4 To install the Re flash package you could use SCP application for uploading it into the APx4 The syntax for copying a file using SCP is A iri nai a ba ib A Ka A WA Pa Ga Kia Ka Ga ih Ki ajan Dh di ES ATIN e Semen ai Ba AN DA KA PA ORA KG GA a GISING maa AA A Kh AGA KN KS AH AGA KAB AB GK KN ir Ha KK AG AA WA A Gi UA Gi BAANG PAK NGKANG The installation of the package starts automatically if it is uploaded to the correct directory that is tmp autoinstall PALAKANG ig NG Badi A E S A A AA GANAN NILAGA AS AA AA cd bluegiga sdk build tmp deploy images S scp bluegiga console reflash 5 0 beta1 20120328105830 apx4devkit bpk root 10 1 1 127 tmp autoinstall 2 2 6 Troubleshooting In case the installation of the SDK did not succeed for example you were not able to compile the reflash package please contact Bluegiga technical support for assistance Include in your request the details of your PC as well as all installation and error logs Copyright 2001 2012 Bluegiga Technologies Page 10 of 22 3 Compiling and installing Hello World Applications are compiled and ipk packages are built by bitbake command User has to provide the meta data of the application and a set of building rules for bitbake These data and rules are written to a text file called a recipe which file ex
7. 0 Ox0a ASOC I2C BOARD INFO pcf8563 0x51 RIC AA PAA AA AA AA AA AA AA AASA AA AA AA AA AA AA AA AA AA AA AA AA AA AA a seek ese a est asi cia oles AA First string is driver s 12C name In this case pcf8563 comes from drivers rtc rtc pcf8563 c 0x51 is device s 12C address Please refer to 12C device s datasheet for that one Copyright 2001 2012 Bluegiga Technologies Page 18 of 22 7 Eclipse support 7A Setting up the development environment This section describes how to install and configure the Bluegiga SDK and Eclipse IDE 7 1 1 Step 1 Install the Bluegiga SDK If you have Bluegiga SDK already installed you may skip this step Please follow the installation instructions found in the Getting started section 7 1 2 Step 2 Prepare IDE support Enable IDE support in the Bluegiga SDK by issuing the following commands awan aran ss WA a GN Wi Sia AG KA Kan Kh Bb AK BA Hi GADA Ah ALA NGANGA KA NAAN NE E E A a E E A E E BK pr D A A A ar AG Wa AN a RATAN NAN A KELANGAN Ka Ga BB Gan Kn GANG cd bluegiga sdk S source init sdk env S bitbake meta ide support La PAA PAPA A E E si ak oie A E E E AA AA APA AA 7 1 3 Step 3 Install the Eclipse Juno IDE If you already have the Eclipse Juno 4 2 IDE installed on your system you may skip this step Download the Eclipse Juno 4 2 tarball from http www eclipse org downloads choose the Eclipse Classic version Once you have the tarball downloaded
8. 7 3 Building and deploying the project First you should build your project to make sure that it is syntactically correct 1 2 From the Project menu select Build Project Make sure that your project is selected in the left hand side navigation pane Copyrigh 2001 2012 Bluegiga Technologies Page 20 of 22 If the building succeeds you may proceed to configure the remote system where you want the program to be copied to and executed 9 10 11 From the Run menu select Run Configurations Select C C Remote Application and click the New icon in the top row of the dialog In the Connection area click New Select SSH Only as the remote system type and click Next Insert the IP address of your APx4 development kit into the Host name field and click Finish In the C C Application area click Search Project Double click on the binary file in the Binaries list Insert path and name of the executable according to how you want it to be copied to the remote system into the Remote Absolute File Path for C C Application field e g usr bin helloworld Click Run Insert your username and password for the APx4 into the corresponding fields Click OK You should see the output of the program in the bottom of the screen in the Console tab If you modify your application and want to see the changes in effect it is enough to click on the menubar Run gt Run History
9. EC EC _FEC EC EC EC UP UP UP MXS PAD 8MA MXS PAD 3V3 MXS PAD PULLUP MX28 PAD SSPO DATA SSP2 SCK MXS PAD 12MA MXS PAD 3V3 MXS PAD NOPULL define MXS PAD FEC MXS PAD 8MA MXS PAD 3 fec0 X28 PAD ENETO MDC ENETO MDC MXS PAD FEC MX28 PAD ENETO MDIO ENETO MDIO MXS PAD F MX28 PAD ENETO RX EN ENETO RX EN MXS PAD X28 PAD ENETO_RXDO__ENETO_RXDO XS PAD F X28 PAD ENETO RXD1 ENETO RXD1 XS PAD F MX28 PAD ENETO X EN ENETO TX EN MXS PAD MX28 PAD ENETO XDO ENETO XDO MXS_PAD_F MX28 PAD ENETO XD1 ENETO XD1 MXS_PAD_F X28 PAD ENE CLK CLKCTRL_ENET XS PAD F saif0 amp saifl MX28 PAD SAIFO LRCLK SAIFO IRCIK MXS PAD 12MA MXS PAD 3V3 MXS PAD PUL X28 PAD SAIFO BITCLK SAIFO BITCIK MXS PAD 12MA MXS PAD 3V3 MXS PAD PUL MX28 PAD SAIFOQ SDATAO SAIFO SDATAO MXS PAD 12MA MXS PAD 3V3 MXS PAD PUL X28 PAD SAIF1 SDATAO SAIF1 SDATAO Copyright 2001 2012 Bluegiga Technologies Page 17 of 22 MXS PAD 12MA MXS PAD 3V3 MXS PAD PULLUP 6 1 2 12C 12C pins MX28 PAD I2CO SCL 2C0 SCL and MX28_PAD_12C0_SDA_12C0_SDA are used for RTC on the module On the APX4 Development Kit also SGTL5000 audio codec is also connected to it 12C is a shared bus so you don t need to change pin assigments Just add your devices to the list below arch arm mach mxs mach apx4devkit c static struct i2c board info apx4devkit i2c boardinfo __initdata I2C BOARD INFO sgt1500
10. SSP2_MOSI__AUART2_TX X28_PAD_SSP2_SCK__AUART2_RX UART3 X28_PAD_SSP2_SS0__AUART3_TX X28_PAD_SSP2_MISO__AUART3_RX 1I2C MX28_PAD_12C0_SCL__12C0_SCL X28_PAD_12C0_SDA__12C0_SDA MMCO MX28_PAD_SSPO_DATAO__SSP0_DO MXS_PAD_8MA MXS_PAD_3V3 XS_PAD_PULLUP X28_PAD_SSPO_DATA1__SSP0_D1 MXS_PAD_8MA XS_PAD_3V3 XS_PAD_PULLUP MX28_PAD_SSPO_DATA2__SSP0_D2 MXS_PAD_8MA MXS_PAD_3V3 XS_PAD_PULLUP X28_PAD_SSPO_DATA3__SSP0_D3 MXS_PAD_8MA XS_PAD_3V3 XS_PAD_PULLUP MX28_PAD_SSP0_CMD__SSPO0_CMD MXS_PAD_8MA XS_PAD_3V3 XS_PAD_PULLUP MX28_PAD_SSPO_DETECT__SSPO_CARD_DETECT MXS_PAD_8MA XS_PAD_3V3 XS_PAD_NOPULL X28_PAD_SSP0_SCK__SSP0_SCK MXS_PAD_12MA MXS_PAD_3V3 MXS_PAD_NOPULL MMC2 WiFi X28_PAD_SSPO_DATA4 SSP2 DO MXS_PAD_8MA XS PAD 3V3 XS PAD PULLUP MX28 PAD SSP2 SS1 SSP2 D1 MXS PAD 8MA MXS PAD 3V3 XS PAD PULLUP X28 PAD SSP2 S52 SSP2 D2 MXS PAD 8MA XS PAD 3V3 XS PAD PULLUP MX28 PAD SSP0O DATA5 SSP2 D3 MXS PAD 8MA MXS PAD 3V3 XS PAD PULLUP X28 PAD SSPO DATAG SSP2 CMD Copyright 2001 2012 Bluegiga Technologies Page 16 of 22 V3 MXS PAD PULLUP EC _FEC
11. Target Management Terminal e TCF Remote System Explorer add in e TCF Target Explorer Expand the Programming Languages entry and select the Autotools Support for CDT box Clik Next buttons and complete the installation Restart the Eclipse IDE In addition to the standard plugins a Yocto plugin needs to be installed It streamlines the configuration of the cross compiling toolchain Next steps explain how to install the plugin al ROD NO Start up the Eclipse IDE and select the workspace From the Help menu select Install New Software Click Add in the Work with area Enter Yocto in the Name field and _ http downloads yoctoproject org releases eclipse plugin 1 3 _ in the URL field and click OK Mak sure Yocto http downloads yoctoproject org releases eclipse plugin 1 3 is selected in the Work with drop down list Check the box next to Development tools SDKs for Yocto Linux Complete the installation discarding any message about software containing unsigned content and restart the Eclipse IDE 7 1 5 Step 5 Configure the Eclipse Yocto Plugin The last step in settings up the development environment is to configure the cross compiler and target options to be used in the Yocto plugin These options will become the default settings for new projects BAON Start up the Eclipse IDE and select the workspace From the Window menu select Preferences Selec
12. X28 PAD LCD DO7 LCD D7 LCD MODE MX28 PAD LCD D0O8 LCD D8 LCD MODE X28 PAD LCD DOY LCD D9 LCD MODE X28 PAD LCD D10 LCD D10 LCD MODE MX28 PAD LCD D11 LCD D11 LCD MODE MX28 PAD LCD D12 LCD D12 LCD MODE X28 PAD LCD D13 LCD D13 LCD MODE X28 PAD LCD D14 LCD D14 LCD MODE X28 PAD LCD D15 LCD D15 LCD MODE MX28 PAD LCD D16 LCD D16 LCD MODE MX28 PAD LCD D17 LCD D17 LCD MODE X28 PAD LCD D18 LCD D18 LCD MODE X28 PAD LCD D19 LCD N19 LCD MODE MX28 PAD LCD D20 LCD D20 LCD MODE Copyright 2001 2012 Bluegiga Technologies Page 15 of 22 D21 X28 PAD LCD LCD D21 LCD MODE X28 PAD LCD D22 LCD D22 LCD MODE MX28 PAD LCD D23 LCD D23 LCD MODE MX28 PAD LCD RD E LCD VSYNC LCD MODE MX28 PAD LCD WR RWN LCD HSYNC LCD MODE X28 PAD LCD RS LCD DOTCIK LCD MODE X28 PAD LCD CS LCD ENABLE LCD MODE DUART X28_PAD_PWM1__DUART_TX MXS PAD CTRL X28 PAD PWMO DUART RX MXS PAD CTRL UARTO MX28_PAD_AUARTO_TX__AUARTO_TX X28_PAD_AUARTO_RX__AUARTO_RX X28_PAD_AUARTO_CTS__AUARTO_CTS MX28_PAD_AUARTO_RTS__AUARTO_RTS UART1 Bluetooth X28 PAD AUART1 TX AUART1 TX X28 PAD AUART1 RX AUART1 RX UART2 X28_PAD_
13. e BALA naaa ED iach cdi GG ha ts Snes as 7 2 1 System requirements aa sn kk a a aaa ak aa tees 7 2 2 Installing the SDK ma ee BANGDI a ca 8 2 2 1 Step 1 Install required packages cece tenes 8 2 2 2 Step 2 Extract the SDK package a aaa aaa aaa aaa ene 8 2 2 3 Step 3 Start building a aaa aaa aaa aa aa aa aaa aa aaa aaa 8 2 2 4 Step 4 SDK installation completed_ aa aa aaa aaa aaa 10 2 2 5 Step 5 Copy Re flash package to target_ 0 cece eee 10 2 2 6 Troubleshooting rrien oe e KA UDa eee eae 10 3 Compiling and installing Hello World a a a aa aa a aa aa aa aa aaa eee 11 3 1 Simple own Hello World applicalion_ lt a tenes 11 3 2 Autotools based Hello World application 0 0 a a eaaa aaa 12 3 3 MoreinfOrmation sa asa arid aa NG NA ad Aa nG A Baa A aha 12 4 Customizing file system image to include additional programs ooo 13 5 Configuring Linux kernel 1 2 2 2 aaa aaa aaa aa aaa aa a aa aaa aaa aaa aaa ea 14 5 1 Enabling features or drivers inside the kernel aaa aaa 14 5 2 Compiling kernek kaaa kaaa che ae kaha hi Baha NG PALA aa Goats NG ba 14 5 3 Building external kernel module a a aaa aa aaa aaa aaa aaa aaa 14 5 4 Configuring LCD display aaa aaa aa aa aa aaa aa aa aaa aa aa aaa 6 Modifying the software to support your own motherboard 2 15 ST Emux kemmel stato kanaman aa ta ee pan kaha
14. ecdce0010cf2c4985ccb445ef490f768b927c0 inherit autotools 3 3 More information More information about writing recipes and using bitbake is available at e Yocto Reference Manual http www yoctoproject org docs current poky ref manual poky ref manual html e Recipe 4 Patch Style Guide https wiki yoctoproject org wiki Recipe_ 26_Patch_Style_Guide e OpenEmbedded User Manual partly outdated but might be very useful http docs openembedded org usermanual html Copyright O 2001 2012 Bluegiga Technologies Page 12 of 22 4 Customizing file system image to include additional programs If you want to add your own applications like helloworld and hello into the file system image it is possible to do so File system images can be customized adding new packages to IMAGE INSTALL variable of recipe meta bluegiga distro recipes image bluegiga customized console image bb IMAGE FEATURES bluegiga apps console bluegiga apps connectivity LICENSE MIT inherit bluegiga image IMAGE_INSTALL helloworld hello Build customized file system image using bitbake command A AE AP AA AA H cd bluegiga sdk S source init sdk env S bitbake customized console image More information about image customization can be found from documentation of Yocto http www yoctoproject org docs latest dev manual dev manual html usingpoky extend customimage Copyright 2001 2012 Bluegiga Technolog
15. ee hard disk space e 2GB of RAM Internet access In order to check the Ubuntu version use the following command AA AA A BEA APA AA a A E A OS aa 1sb release a No LSB modules are available Distributor ID Ubuntu Description Ubuntu 12 04 LTS Release 12 04 Codename precis paia ih isin tn SAGASAAN See Ba Aa Gah Kai A Ga ii BA BG Ki A dan ini Wb Ga NG Bk jik ka pi A E BAG KN Ga Kn knal ai di ih Ma Gn a Ki ba A Ba Aa ar di PA AB Ka Ga Ki cnet da Bar WG d Ti ir AN IASA S uname a Linux csteam ThinkPad Z60m 3 0 0 16 generic 29 Ubuntu SMP Tue Feb 14 12 49 42 UTC 2012 i686 i686 i386 GNU Linux A EP APA A A APAPAP PAA AP AA AA AA AP AA AA Pi A INENG A E O EE S df h Filesystem Size Used Avail Use Mounted on dev sdal 90G 9 8G 76G 12 udev 996 4 0K 996M 1 dev tmpfs 401 788K 401M 1 run none 5 0 0 5 0M 03 run lock none 1003 200K 1003M 1 run shm free m total used free shared buffers cached Mem 7985 5352 2633 0 152 1346 buffers cache 3852 4133 Swap 8188 0 8188 Copyright 2001 2012 Bluegiga Technologies Page 7 of 22 2 2 Installing the SDK The SDK installation is a fairly straightforward process and requires only a few steps This section walks you through the SDK installation and compilation of your first Re flash packet amp System wide root or sudo access is required to do some of the installation steps 2 2 1 Step 1 Install required packages Bluegiga SDK requires
16. entation e New Developer Screencast Tutorial by Yocto http www yoctoproject org blogs jeff 2012 new yocto project introductory screencast e Frequently asked questions https wiki yoctoproject org wiki FAQ 1 5 Sources for recipes If you want to use an application but did find it from the prebuild packages please look for below source of recipes The sources are listed in an order where the recipes found from the first ones are most likely to compile without modifications The recipes found from the links that are further down are more likely to require some tuning before they work 1 oe core yocto is fetching data from this repository http git openembedded org openembedded core tree 2 these should be fully compatible with latest yocto http git openembedded org meta openembedded tree 3 tens of community driven meta layers http www openembedded org wiki Layerlndex 4 deprecated openembedded classic these recipes are not fully compatible http git openembedded org openembedded tree Copyright 2001 2012 Bluegiga Technologies Page 6 of 22 2 Getting started Bluegiga SDK is tested to work with Ubuntu 12 04 LTS Separate SDK packages are delivered for 32 bit and 64 bit host operating systems 64 bit version not yet available at the time of writing but 32 bit SDK can be used in 64 bit OS installations 2 1 System requirements Ubuntu 12 04 LTS other Ubuntu distributions should work as well e 10 GB of fr
17. extract it into your home directory For example if you downloaded it into Downloads executing the following commands will extract the content of the tarball into eclipse AA NE KAE A perce aoe ease ens cee a aes AA PAP PAA AAP AA AA AA AA PAA AAP AA E N E AAP PAA ed gt tar xvf Downloads eclipse SDK 4 2 linux gtk tar gz 7 1 4 Step 4 Install required plugins First you need to install official Eclipse plugins which are required for building executing and debugging applications in APx4 You may do so by following the steps below 1 Start the Eclipse IDE using commands cd eclipse and eclipse Make sure you have Java installed by using the command java version In case you need to install Java use for example the command sudo apt get install openjdk 7 jre headless has suggested by the output of the java version command Select a workspace From the Help menu select Install New Software Select Juno http download eclipse org releases juno _ from the Work with drop down list Expand the Linux Tools entry when it is retrieved form the internet and select checkbox the LTT ng Linux Tracing Toolkit box Expand the Mobile and Device Development entry and check the following boxes e C C Remote Launch e Remote System Explorer End user Runtime e Remote System Explorer User Actions oR OP o Copyright O 2001 2012 Bluegiga Technologies Page 19 of 22 7 8 9 e
18. helloworld 1 0 r1 armv5te ipk by bitbake To install the hello world to your APx4 you have multiple choices e Using the web interface gt Software upload e Using SCP scp bluegiga sdk build tmp deploy ipk armv5te helloworld 1 0 r1 armv5te ipk root APx4 IP address tmp autoinstall Once installed you can run the program at the shell prompt of the APx4 usr bin helloworld where also usr bin is defined in the recipe see http docs openembedded org usermanual html directories_installation html Copyright 2001 2012 Bluegiga Technologies Page 11 of 22 3 2 Autotools based Hello World application Bluegiga SDK is designed for building autotools based applications see http en wikipedia org wiki GNU_build_system User needs only to define meta data and URL of source package SDK is capable of handling the rest like compiling binaries and installing files A basic example of autotools based hello workd application is at bluegiga sdk meta bluegiga examples helloworld hello_2 7 bb bluegiga sdk meta bluegiga examples helloworld hello_2 7 bb DESCRIPTION GNU Helloworld application SECTION examples LICENSE GPLv3 IC ES CHKSUM file COPYING md5 d32239bcb673463ab874e80d47fae504 DEPENDS ng H I a virtual gettext SRC_URI http ftp gnu org gnu S PN S PN S PV tar gz SRC_URI md5sum fc01b05c7 943d3c42124942a2a9bb3a SRC_URI sha256sum fA593b5bcf 6d1bbbd7dibb7eefd
19. ies Page 13 of 22 5 Configuring Linux kernel 5 1 Enabling features or drivers inside the kernel To enable features or drivers from kernel org kernel SDK shell session cd bluegiga sdk source init sdk env bitbake linux c menuconfig bitbake linux c devshell nnn Ur New devshell console window will appear SDK shell session cp config i x bluegiga sdk meta bluegiga bsp recipes kernel linux linux 3 2 apx4devkit defcoi exit 5 2 Compiling kernel SDK shell session cd bluegiga sdk S source init sdk env S bitbake linux AU AG MEA AA AUG Yah A Gan ib Wk in KA A d a AGA rah A Gi b BA mlah Kg a a a A aa KA di A Gah Ba badi wi AKAN 5 3 Building external kernel module Build strategy differs from a module to module as it depends how it is meant to be build Please refer to instructions found inside the package and apply those to the SDK We provide very simple hello world kernel module example under bluegiga sdk meta bluegiga examples recipes hellokernel Please take a look to files under that directory and modify those to your needs Source code of the module is under the files directory Copyright 2001 2012 Bluegiga Technologies Page 14 of 22 6 Modifying the software to support your own motherboard 6 1 Linux kernel 6 1 1 GPIO All interfaces defined as LCD SDIO SAIF UARTs etc in default software can be changed to be used as GPIOs Following three lines are not routed to the connector P
20. in MX28 PAD PWM3 PWM 3 is the APX4 module s LED next to power LED Pin MX28 PAD GPMI CE1N GPIO O 17 is reserved as Bluetooth reset and is an active low signal MX28 PAD GPMI RDY1 GPIO 0 21 is reserved as Wi Fi reset and is also an active low signal Also lines for UART1 MMC2 and FECO are reserved for specific purposes and are not routed to the module s connector arch arm mach mxs mach apx4devkit c static const iomux_cfg_t apx4devkit_pads _ initconst LED MX28_PAD_PWM3 PWM_3 MXS_PAD_CTRL LCD Backlight X28 PAD PWM4 PWM 4 MXS PAD CTRL GPIO MX28_PAD_GPMI_CE1N__GP10_0_17 MXS_PAD_CTRL Bluetooth reset active low X28_PAD_GPMI_RDY1 GPIO O 21 MXS_PAD_CTRL Wifi reset active low MX28 PAD LCD RESET GPIO 3 30 MXS_PAD_CTRL LCD reset active low MX28 PAD SAIFO MCK GPIO 3 20 MXS_PAD_CTRL USB reset active low X28 PAD JTAG RTCK GPIO 4 20 MXS PAD CTRL Factory reset button active low MXSFB define LCD MODE MXS PAD 3V3 MXS_PAD_4MA X28 PAD LCD DOO LCD DO LCD MODE X28 PAD LCD D0O1 LCD D1 LCD MODE MX28 PAD LCD D02Z LCD D2 LCD MODE MX28 PAD LCD D03 LCD D3 LCD MODE X28 PAD LCD _ DU4 LCD D4 LCD MODE X28 PAD LCD D05 LCD D5 LCD MODE X28 PAD LCD _ DUH LCD DE LCD MODE M
21. kages are divided work directory where applications are patched t conf downloads sstate cach images u boot binaries t meta t bluegiga bsp t bluegiga distro t bluegiga binary utils templates for local conf and bblayers conf files source file download cache sstate cache location for pre built file system images and pre compiled binaries meta layers for Bluegiga SDK which provides apx4 hardware support containing open source applications with Bluegiga closed source applications layer layer layer bluegiga t yocto command 1 3 Meta layers xamples layer that contains example applications location for Yocto meta layers and bitbake Bluegiga SDK contains following meta layers yocto meta meta bluegiga bsp meta bluegiga distro meta bluegiga binary utils meta bluegiga examples Recipes from Yocto Bluegiga hardware Board Support Package BSP for apx4devkit Bluegiga Linux distribution related recipes add on software on top of Yocto base installation Bluegiga utils and helper applications Bluegiga example applications Yocto is base of whole SDK and all other layers are depending on it Following figure shows all layers and their dependencies Copyright 2001 2012 Bluegiga Technologies Page 5 of 22 Bluegiga Utils Bluegiga Examples Bluegiga Distro Bluegiga BSP 1 4 Other interesting links e Yocto documentation htip Www yoctoproject org docum
22. mmand is executed the current directory will be changed to bluegiga sdk build which is the directory where bitbake must be run always Then you can experiment building your first reflash package with Yocto s command called bitbake Example ready target recipes are bluegiga console image to obtain a full installable filesystem like the one installed by default in APx4s using recipes from all meta layers as from graph in chapter 1 3 or bluegiga base image to obtain a minimal distribution spanning only meta layers Yocto Bluegiga BSP and a reduced Bluegiga Distro By Copyright O 2001 2012 Bluegiga Technologies Page 8 of 22 default bitbake will search for the given recipe in all meta layers directories defined in bluegiga sdk build conf bblayers conf and for example the bluegiga console image happens to be under bluegiga sdk meta bluegiga distro recipes image bluegiga A Building a Reflash package should take less than 15 minutes with a quad core CPU with 4 GB of RAM but please keep in mind that it might take a lot longer with older machines Example cd bluegiga sdk source init sdk env l bitbake bluegiga console image l A successful build operation will deliver the following output Pseudo is not present but is required building this first before the main build Parsing recipes 1003 444444444444444324442355434235443 35445 343544 4 Time 00 00 53 Parsing of 883 bb files complete 0 cached 883 parsed 1162
23. some additional packages in order to work properly Packages can be installed running the following commands maa AA AA AA AA AA AA AA AE S sudo apt get update S sudo apt get install sed wget cvs subversion git core coreutils N unzip texi2html texinfo libsd11 2 dev docbook utils gawk python pysqlite2 diffstat help2man make gcc build essential N g desktop file utils chrpath libgll mesa dev libglul mesa dev mercurial autoconf automake groff The command above will require the download of about 550 650MB depending on the Ubuntu installation from the Internet and this will take a while depending on your Internet connection speed You will be asked if you want to download the packages from the Internet and you need to answer Yes to the question 2 2 2 Step 2 Extract the SDK package After the compressed archive containing the SDK files is received from Bluegiga and is copied to the local file system you will have to extract its contents into your home directory by running the following commands A e S cd S tar xvf path to bluegiga sdk sstate 5 0 0 beta2 apx4devkit tgz Before uncompressing the archive make sure once again that there is enough space under your home directory with command df h 2 2 3 Step 3 Start building First you need to prepare the necessary environment variables and create a build folder You can do this by running the script source init sdk env as seen in the example below after this co
24. t Yocto Project ADT from the list on the left side of the preferences dialog box Configure the Cross Compiler Options section as follows a Make sure that Build system derived toolchain is selected b Enter the path to the build directory inside the Bluegiga SDK root into the Toolchain Root Location field c Enter the path to the build tmp sysroots apx4devkit directory inside the Bluegiga SDK root into the Sysroot Location field d Make sure armv5te bluegiga linux gnueabi is selected from the Target Architecture drop down list Configure the Target Options section as follows a Make sure that External HW is selected Click the OK button 7 2 Creating a new project This section describes how to create a new Autotools based project within the Eclipse IDE wk DODNDOAON Start up the Eclipse IDE and select the workspace Select File gt New gt Project Expand the C C entry and double click C Project Put the name of your project into the Project name field do not use character Expand the Yocto Project ADT Project and select Hello World ANSI C Autotools Project Click Next Add information in the Author Copyright notice and License fields Click Finish If the Open Associated Perspective prompt appears click Yes to get into the C C perspective You can access your project files using the navigtion pane on the left hand side of the screen
25. targets 38 skipped 0 masked 0 errors NOTE package bluegiga console image 1 0 r0 task do rootfs Started NOTE package bluegiga console image 1 0 r0 task do rootfs Succeeded NOTE Running task 1977 of 1978 ID 8 tmp sdk bluegiga sdk yocto meta bluegiga distro recipes reflash bluegiga bluegiga console reflash bb o_build_reflash OTE package bluegiga console reflash 1 0 r0 task do build reflash Started OTE package bluegiga console reflash 1 0 r0 task do_build_reflash ucceeded NOTE Running noexec task 1978 of 1978 ID 5 tmp sdk bluegiga sdk yocto meta bluegiga distro recipes reflash bluegiga bluegiga console reflash bb do build NOTE Tasks Summary Attempted 1978 tasks of which 1910 didn t need to be Qi A Z un rerun and all succeeded After the building tasks are completed the reflash package can be found in the following directory bluegiga sdk build tmp deploy images The file itself will be called bluegiga console reflash_5 0 0 beta _apx4devkit bpk and in that same directory also a symbolic link called bluegiga console reflash_apx4devkit bpk will exist always pointing to the last compiled package Copyright O 2001 2012 Bluegiga Technologies Page 9 of 22 2 2 4 Step 4 SDK installation completed Congratulations you have now successfully installed the Bluegiga APx4 SDK and created your first file system image delivered
26. tension is bb More information about recipes and bitbake command is available at Bitbake User Manual and Openembedded User Manual 3 1 Simple own Hello World application Bluegiga SDK offers very simple and world famous Hello World application as an example The application files are located at bluegiga sdk meta bluegiga examples recipes helloworld The Hello World application consists of a recipe file and a source code file written in C language Recipe file is named helloworld 1 0 bb where helloworld is the project name and 7 0 is version of the project bluegiga sdk meta bluegiga examples helloworld helloworld_1 0 bb PR rl LICENSE CLOSED S S WORKDIR FILES S PN SRC_URI file helloworld c do_compile S CC helloworld c o helloworld do_install install d D bindir install m 0755 helloworld D bindir The recipe contains meta data for the creation of the ipk package list of source files and instructions for compiling binary and building package Hello world application is then built using bitbake command as shown below Remember that the source init sdk env must always be launched when a new terminal window is opened E E E EA Hr Gah KK BADA Nn A E EN Ki DG Bh Wr nk da a ih jar E E A A AAA cd bluegiga sdk S source init sdk env S bitbake helloworld The ready ipk package will be copied to bluegiga sdk build tmp deploy jpk armv5te
Download Pdf Manuals
Related Search