USER MANUAL WRAP™ PRODUCT SERIES Version 1.1.
USER MANUAL WRAP PRODUCT SERIES © BlueGiga Technologies 2002 BlueGiga Technologies assumes no responsibility for any errors which may appear in this manual, reserves the right to alter the devices, software or specifications detailed herein at any time without notice, and does not make any commitment to update the information contained herein. BlueGiga Technologies’ products are not authorized for use as critical components in life support devices or systems.
USER MANUAL WRAP PRODUCT SERIES TABLE OF CONTENTS 1 INTRODUCTION .......................................................................................................................................4 LICENSES AND WARRANTY .................................................................................................................4 CERTIFICATION INFORMATION ............................................................................................................
USER MANUAL 1 WRAP PRODUCT SERIES INTRODUCTION WRAP™ The Wireless Remote Access Platform (WRAP™) from BlueGiga Technologies is a series of integrated hardware and software products, which cost-effectively add wireless connectivity to machines and devices. WRAP products enable substantial cost and timesavings by providing you with a complete solution for remotely accessing devices in the short, local and global range.
USER MANUAL WRAP PRODUCT SERIES The following software components: GCC compiler tool chain, uClinux kernel, and uClinux-userland applications are licensed under the terms and conditions of the GPL General Public License (file \doc\GPL.txt on the WRAP CD-ROM). Upon request, BlueGiga will distribute a complete machine-readable copy of the source of the aforementioned software components during a period of three (3) years from the order date of the product.
USER MANUAL WRAP PRODUCT SERIES The radiated output power of WRAPTM 3000 is far below the FCC radio frequency exposure limits. Nevertheless, the WRAPTM 3000 shall be used in such a manner that the potential for human contact during normal operation is minimized. This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of the FCC Rules.
USER MANUAL 2 WRAP PRODUCT SERIES QUICK START The WRAP boards are delivered with the latest release of the WRAP platform installed. No additional installation is required for getting started with the WRAP. Just connect the Ethernet cable (WRAP 2151 and 3000 only) and the power cable and the WRAP boots up. After this, you can connect to the WRAP using a device that has Bluetooth LAN Access Client profile support.
USER MANUAL WRAP PRODUCT SERIES Figure 2. WRAP 2151 Starter Kit Management Port Connector Location. The serial port settings for the management console are shown in Table 1. When you use the management console, you are automatically logged in as the superuser (root). The serial cable is in fact a standard direct cable for WRAP 1260 and WRAP 3000 products and a standard cross-over cable for WRAP 2151 Starter Kit.
USER MANUAL WRAP PRODUCT SERIES /> ifconfig eth0 Link encap:Ethernet HWaddr 00:07:80:80:00:81 inet addr:10.1.1.32 Bcast:10.1.1.255 Mask:255.255.255.0 UP BROADCAST NOTRAILERS RUNNING MTU:1500 Metric:1 RX packets:134 errors:0 dropped:0 overruns:0 frame:0 TX packets:104 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 RX bytes:0 (0.0 b) TX bytes:0 (0.0 b) Interrupt:17 Base address:0x300 lo Link encap:Local Loopback inet addr:127.0.0.1 Bcast:127.255.255.255 Mask:255.0.0.
USER MANUAL 3 WRAP PRODUCT SERIES CONFIGURATION When the WRAP is installed and powered up for the first time, the default configuration settings are being used. With these settings, the WRAP automatically configures its network settings assuming that the board is connected to a LAN network with a DHCP server running. After booting, you can use the WRAP as a Bluetooth LAN access point to the network without any changes in configuration.
USER MANUAL WRAP PRODUCT SERIES 3.3.1 GENERAL BLUETOOTH SETTINGS 1. Friendly Name [BlueGiga_*] The name shown when this device is found when inquired by other Bluetooth devices. The name may end with asterisk (*), which will be replaced with the last 3 digits of the serial number of this WRAP board. 2. Bluetooth Server Socket Interface Password [buffy] The password required to enter before any commands when discussing with the WRAP Bluetooth Server Socket Interface. 3.
USER MANUAL WRAP PRODUCT SERIES Whether the Serial Port Profile is enabled or not. 2. Act as the Calling Device [N] Whether this device should act as the calling device (DevA) or the answering device (DevB). 3. BPS Rate [9600] The bits-per-second rate of the connection. Possible values are 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400 and 460800. 4. Data Bits [8] The number of data bits in the connection. Possible values are 5, 6, 7 and 8. 5.
USER MANUAL 3.4 WRAP PRODUCT SERIES RAMDISK SETTINGS 1. Size of the ramdisk (in kilobytes) [512] The size of the ramdisk (/mnt/ram/). Sizes below minimum (currently 50) and above maximum (currently 1024) are not allowed. 3.5 SYSTEM LOGGER SETTINGS 1. Log locally [Y] This option determines whether or not the System Logger (syslogd) should log locally (to /var/log/messages). 2. Address of the Remote Syslog Server [] The address of the device in the network to which the System Logger should log to.
USER MANUAL WRAP PRODUCT SERIES Note: Instead of typing the contents of the file, you can of course also copy-and-paste it from your favourite text editor. You can also create and edit the file using the "vi" editor at WRAP telnet prompt. Note: Currently it is not possible to use "vi" at management console due some WRAP operating system problems. However, it is also possible to use your own text editor. Just download the file, edit it locally in your computer and upload the file back again.
USER MANUAL 4 WRAP PRODUCT SERIES USING THE SYSTEM This chapter describes the basic features of a BlueGiga WRAP board and their usage. This includes using the WRAP board as a Bluetooth LAN Access Point, Bluetooth Serial Port Cable Replacer, using the Web and FTP servers for uploading content for browsing and downloading, as well as getting familiar with the utility applications and the pre-compiled examples on the WRAP CD.
USER MANUAL WRAP PRODUCT SERIES In the state B) the long serial connection is replaced with a Bluetooth Serial Port Profile connection between the two WRAP devices. Those WRAP devices are then connected locally to the user devices with (short) serial cables. The cable between the user device A and the WRAP device A must be a cross-over cable. The cable between the user device B and the WRAP device B must be the same cable (direct or cross-over) that was used in state A).
USER MANUAL WRAP PRODUCT SERIES 4.2.1 WEB SERVER The integrated web server in the BlueGiga WRAP supports HTTP/1.0 methods GET and POST, and has light user authentication capabilities. The content can be either static or dynamic – the WWW server is CGI/1.1 compatible. The web server is always running and the content (http://wrap-ip-address/) is located in the /var/www/htdocs/ directory in the WRAP file system. By default, there is only a simple example file, index.
USER MANUAL Application basename cat chgrp chmod chown clear cmp cp cut date dd df dirname du echo env expr false find free ftp grep gunzip gzip head hostname ifconfig ipfwadm kill killall ln logger ls md5sum mkdir mkfs.minix mktemp more mount mv obexbrowser obexget obexput passwd pidof ping ps pwd reboot renice rm rmdir route WRAP PRODUCT SERIES Purpose Strip directory and suffix from filenames. Concatenate files and print on the standard output. Change group ownership. Change file access permissions.
USER MANUAL rtc sh sed setup sleep sort tail tar telnet test touch tr true umount uname uniq unzip uptime uudecode uuencode wc vi wget wrapid which zcat xargs xmodem WRAP PRODUCT SERIES WRAP Real Time Clock (RTC) programming application. Run "rtc –h" for usage. Remember that parameters containing spaces must be enclosed in quotes. Shell: sh, ., break, case, cd, continue, eval, exec, exit, export, for, if, read, readonly, set, shift, trap, umask, wait, while A Stream EDitor. WRAP Setup Application.
USER MANUAL WRAP PRODUCT SERIES After connecting to the WRAP FTP daemon, you need to decide where you want to put your files – either on the ramdisk for testing purposes or on the flash filesystem for preserving your files between power-offs. The ramdisk is accessed through the ram-directory and the flash filesystem through the flash-directory after logging in with FTP.
USER MANUAL WRAP PRODUCT SERIES /> cd /tmp /mnt/ram/tmp> xmodem –s test.log start xmodem transfer now. Now start xmodem (checksum, not CRC) receive from your terminal. xmodem send completed. If you want to save the application to /usr/local/bin (on the flash filesystem), you will have to replace 'cd /tmp' with 'cd /usr/local/bin'. To examine the directory structure on the WRAP, please see the appendix in the WRAP SDK manual. 4.
USER MANUAL WRAP PRODUCT SERIES Here is an example session from a Windows 2000 laptop, in which all examples are transferred and unpacked, and the led example is started in the end: C:\>d: D:\>cd tar D:\tar>ftp Connected to . 220 Welcome to Stupid-FTPd server. User (:(none)): root 331 Guest login ok, send your e-mail address as password. Password: buffy (not echoed) 230 User root logged in. ftp> bin 200 Type set to I. ftp> cd ram/tmp 250 CWD command successful.
USER MANUAL WRAP PRODUCT SERIES Example, source in wrap/src/examples/ helloworld serial btsend Usage, when installed to mnt/ram/tmp and it is the current directory ./helloworld ./serial /dev/ttyS3 ./btsend – 12 on the first device, ./btsend 12 on second io/led io/dip io/gpio io/ad ./led ./dip ./gpio ./ad m2n echo testmessage | ./m2n man2m ./ledserver & browse with Java-enabled browser to http://wrap-ip-adress/man2m/ Note: assumes WWW pages moved as guided.
USER MANUAL WRAP PRODUCT SERIES 4.6.1 SYSTEM REQUIREMENTS The following hardware and software is required to re-install WRAP: • PC with • Serial port (D9 connector) • CD-ROM drive • Operating System o Windows 2000 or o Linux (tested with RedHat 6.2, 7.0, 7.1, 7.2 and 7.3) 4.6.2 RE-INSTALLING WRAP USING MICROSOFT WINDOWS To re-install WRAP under Windows: 1. Insert the WRAP CD into the CD-ROM drive. 2. Enter the root of the CD and double click reinstall.exe. 3.
USER MANUAL 5 WRAP PRODUCT SERIES BLUETOOTH TECHNOLOGY OVERVIEW TCP/IP PPP Wireless Applications Wireless Applications Profiles BGT Bluetooth API SDP RFCOMM Profiles BT Upper Layers Logical Link Control and Adaption Protocol (L2CAP) HCI driver Physical Bus Driver HCI Firmware Link Manager Protocoll (LMP) BaseBand BT Lower Layers Link Controller (LC) RF RF Figure 4. Bluetooth Software and Hardware Components. 5.
USER MANUAL WRAP PRODUCT SERIES The Bluetooth frequency band is divided into distinct channels with 1 MHz channel spacing. In order to comply with out-of-band regulations in each country, a guard band is used at the lower and upper band edge. For the USA, Europe, and most other countries the frequency range is 2.400 – 2483.5 MHz and the corresponding channels are f = 2402 + k MHz; k = 0 ¼ 78. In France, the frequency range is 2.4465 – 2.
