BLUEGIGA ACCESS DEVICES USER GUIDE Tuesday, 20 September 2011 Version 4.
Copyright © 2001 - 2011 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.
TABLE OF CONTENTS 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. Getting started with Bluegiga Access Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1 Powering up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.1.1 Access Point connectors . . . . . . . . . . .
1 Introduction Bluegiga Access Server product family offers cutting-edge wireless Bluetooth® routers, Access Points and management tools - enabling you to create efficient and scalable networks. The open and adaptable platform enables you to meet your applications' and customers' needs. Bluegiga Access Server AX4 is a powerful Linux based wireless connectivity platform targeted for eHealth, point-of-sale, proximity marketing, captive portal, and long range Bluetooth connectivity applications.
2 Getting started with Bluegiga Access Device Access Point and Access Server can be controlled in four ways: by using Bluegiga Solution Manager (see BSM documentation for details) by using the WWW interface by entering commands and using applications at the shell prompt by sending and/or retrieving files to/from the device. The default username is root and the default password is buffy. 2.
Figure 1: Physical interfaces of Bluegiga Access Point In addition, Access Point 3241 has a hole in the bottom of the unit. Trough that hole user can press a button. If that button is pressed while the unit is powered on, configuration is reset to factory defaults. There is no power switch in Access Point 3201 or 3241. The adapter is the disconnection device; the socket-outlet shall be installed near the equipment and shall be easily accessible.
modem) under a cover in the bottom of the unit. See the picture below. Figure 4: Connectors below Access Server AX4 bottom cover 2.1.3 Access Server connectors The physical interface locations of Access Server 229x are described in figures below. Figure 5: Physical interfaces of Bluegiga Access Server 229x There is no power switch in Access Server. The adapter is the disconnection device; the socket-outlet shall be installed near the equipment and shall be easily accessible.
Figure 6: Leds and Compact Flash card slot of Access Server 229x All the blue status leds are turned off and the rightmost blue led (closest to the power led) blinks on four second intervals when the boot procedure is finished and the unit is ready to be connected. Bluetooth led, (blue led furthest away from power led in Access Server) blinks quickly every 30 seconds indicating Bluetooth service activity. 2.
Figure 7: Windows 7 listing UPnP devices Bluegiga Access Devices will have name "Access Point/Server Wserial number" where the serial number corresponds to the serial number in the sticker underneath the unit. To connect to Bluegiga Access Device web interface you can either double click the icon of the correct device or right click the icon and select View device webpage. Figure 8: Connecting to web setup using UPnP 2.2.
Figure 9: Wrapfinder 2.0 started listing Access Devices within local network After you have started the Wrapfinder software you might be prompted by the firewall applications to allow the use of certain ports by Wrapfinder. There are cases in which it is wise to temporarily disable completely the software firewall running in the PC, if any. Once the Wrapfinder utility has started it automatically runs a search through the local network and lists all found Bluegiga Access Devices.
2.3 Web interface When you have accessed the Bluegiga Access Device web interface using either of the methods described in previous chapter you should get main WWW page shown below: If you see a login prompt instead of this page, you have already eHealth software bundle installed. See eHealth software user guide for more information. From the top-level page, click Setup to log in to the configuration interface.
For details of WWW interface components, see Default web interface and iWRAP Bluetooth user guide. 2.4 Access Device software bundles Access Device application use cases may require additional software packages to be installed for full functionality. For key applications, these are also available in software bundles. A bundle is a single update packet which contains all software packages for certain application. You can order Access Devices with a bundle of your choice pre-installed.
3 Connecting Access Device to network This chapter describes Access Device network interfaces and WiFi and modem configuration. For additional documentation, see separate "Networking Guide" document. 3.1 Network interfaces The network interfaces used in Access Devices are described in table below: Table 2: Access Device network interfaces and their description Interface Description nap Dynamic virtual ethernet ("cable") device. This is the device having an IP address.
It is therefore recommended to enable option Setup - Network settings - Modem settings - Force connection open. With this enabled, modem Internet connection is checked every 10 minutes with the ping command. If the check fails, modem connection is restarted. Some modems power up in mass storage mode. Supported modems will be switched to modem mode automatically.
WEP network = { # WEP encryption ssid="Bluegiga" key_mgmt=NONE wep_key0="ASCII WEP key" #wep_key0=0123456789 wep_tx_keyidx=0 } ASCII WEP key is given in quotes (e.g. "abcde" or "abcdeabcdeabc") hex digits are given without quotes (e.g. 0123456789 or 01234567890123456789012345) WPA/WPA2 network = { # WPA/WPA2 encryption ssid="Bluegiga" scan_ssid=1 key_mgmt=WPA-PSK psk="WPA shared key" } shared key length must be 8..63 characters A reboot is needed for the new settings to take effect.
settings - Basic configuration. Basic configuration settings is used to change hostapd driver backend, SSID of your network, hardware mode, country code, Wi-Fi channel or maximum simultaneous client number. Default values should work with most of USB Wi-Fi dongles. Depending on used encryption, use Edit configuration file menu option and change the following lines: No encryption Change nothing more.
3.4 Shell prompt access Shell prompt access may be needed for advanced controlling operations that cannot be performed by using the WWW interface. You can get to the shell prompt by using SSH. When you are connected to the same LAN network with your Access Server or Access Point, you can find its IP address using uPnP or wrapfinder application (see Getting started with Bluegiga Access Device). You can use SSH to get shell prompt access also using Bluetooth LAN Access or PAN profile.
The boot process may stop at the following U-Boot prompt: Hit any key to stop autoboot: U-Boot> 0 If this happens, enter command boot to continue to boot Linux. 9. Wait for the device to boot up and end with the following prompt: Please press Enter to activate this console. 10. Press Enter to activate the console. You will be logged in as root in directory /root: [root@wrap root] 11. You can now control Access Server from the management console. 3.4.
4 Using services This chapter contains documentation of the default system services available in Access Devices. 4.1 Default services Access Device services are started automatically at system power-up or when another server daemon needs them. You can check which servers are currently installed and/or configured to start at system power-up with command chkconfig --list or navigating in WWW Setup to Setup - Applications - Default startup applications.
4.2 Managing software components (wpkgd) To maximize memory available for customer applications, Access Devices ship with minimal amount of software components installed. To see the installed software components and their version numbers, navigate to Setup - Advanced - System Information - List installed software components or give command wpkgd list at the shell prompt. See Available Software Packages for more information of software components installed by default and available separately.
Uninstalling software components You can uninstall software components from the shell prompt. To list installed software components use command wpkgd list. To uninstall a component, use command wpkgd erase [component]. See the wpkgd command without parameters for more information.
Note eHealth and Captive Portal bundles install more advanced lighttpd web server, which can be installed from its own software package also. 4.5 System time Access Device has Real Time Clock (RTC) which is backed up with a battery so it runs even when device is powered down. Access Device is also keeping the system time in sync with Internet time servers. 4.5.1 Real time clock (RTC) The system clock is read from the battery operated real time clock during boot.
4.6.2 Using CIFS mount To use a CIFS mount (for example a shared folder in Windows), you need the cifs-client software component installed in Access Device. First, create a mountpoint with command mkdir -p /mnt/cifs. Mount the directory by using command mount.cifs /sharename /mnt/cifs -o user=username,nounix. You will then be prompted for password of the username you specified. After entering the correct password, you can access the share in directory /mnt/cifs.
5. side. Do not power down Access Device while blue leds are blinking from side to side or if all of them are turned on. Installation takes 5-15 minutes (in AX4 less than 5), be patient. 6. Check that only led labeled "1" in Access Point or AX4 (blue led closest to the power led in Access Server 229x) turns on and off every 4 seconds.
5 Using utilities Access Device ship with many standard Linux utilities pre-installed. Most of the utilities are part of BusyBox; see Enabled Busybox Applets for complete list of enabled BusyBox commands. For a complete list of all installed and available utilities and software packages, see Available Software Packages. 5.1 Wrapid - Bluegiga Access Device System Information You can get detailed information of Access Device hardware and software at WWW setup Advanced settings Hardware information.
$ badctl --help usage: badctl DEVICE [COMMAND] Manage Bluegiga Access Device and read state of button available devices: modem internal GPRS/3G modem wifi internal Wi-Fi usb external USB port button state of button commands (all devices except button): on switch power on off switch power off reset do power cycle exit status (commands): 0 executed successfully (OK) 1 problems during running command 2 unable to open device /dev/led exit status (state of button): 0 button is not pressed 1 button is pressed 5.
5.4.2 Finder Protocol Finder protocol is used to find Access Servers or Access Points using a UDP broadcast message. Finder server is listening in port 9990 for broadcast and unicast messages. The reply is unicasted to sender. In Access Server and Access Point a finder message can be sent with command finder. See finder --help for usage. The finder server is enabled by default.
Bluegiga SMS Gateway Server is not installed by default. It can be installed from software component smsgw. When Bluegiga SMS Gateway Server is installed, it is also enabled to start at boot by default. You can disable it later (for example if you need to use the same modem for Internet connection) either with command chkconfig smsgw off or using the setup application's WWW interface at Setup Applications Default startup applications smsgw.
command watchdog id timeout. For example, watchdog test 5.
6 Using 3rd Party Peripherals 6.1 Using USB, Compact Flash or microSD Memories Access Device's persistent memory storage can be extended by using a USB storage device like a memory dongle or a portable hard drive or a Compact Flash memory card. These are also used by the wpkgd daemon each time this kind of device is inserted, it is automatically mounted and scanned for management packets, which are processed and unmounted. Access Server AX4 supports also microSD card.
If your application uses USB storage devices or Compact Flash memory cards for additional storage, you must ensure that these services do not start before these storage devices are properly mounted. You should therefore disable the automatic startup of application(s) in question either by changing their startup state to off in WWW Setup at Setup Applications Default startup applications or at shell prompt with command chkconfig application off. The system startup script /etc/rc.d/rc.
6.3 Using USB webcams Access Devices features can be extended by adding external USB webcam. All devices providing generic USB video class devices are supported. Please refer Tested 3rd Party Peripherals to see what devices we have tested. USB webcam drivers are not installed by default. Those can be installed using software component kernel-modules-media. To use the USB webcam we provide one software: mjpg-streamer.
7 Licenses, Warranty, Certification Information and WEEE Compliance Bluegiga Technologies is hereby willing to license the enclosed WRAP product and its documentation under the condition that the terms and conditions described in the License Agreement are understood and accepted. The License Agreement is supplied within every WRAP product in hard copy. It is also available on-line at http://www.bluegiga.com/terms_and_conditions. The use of the WRAP product will indicate your assent to the terms.
Cet appareil numérique de classe B est conforme aux normes canadiennes NMB-003 et CNR-210. This device complies with Industry Canada licence-exempt RSS standard. Operation is subject to the following two conditions: This device may not cause harmful interference, and this device must accept any interference received, including interference that may cause undesirable operation. Cet appareil est conforme avec Industrie Canada RSS standard exempts de licence.
Issue 4 clause 4.1. Conformité des appareils de radiocommunication aux limites d'exposition humaine aux radiofréquences (CNR-102) L'ordinateur utilise des antennes intégrales à faible gain qui n'émettent pas un champ électromagnétique supérieur aux normes imposées par Santé Canada pour la population. Consultez le Code de sécurité 6 sur le site Internet de Santé Canada à l'adresse suivante : http://www.hc-sc.gc.
This device may not cause harmful interference, and This device must accept any interference received, including interference that may cause undesired operation. 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. These limits are designed to provide reasonable protection against harmful interference in a residential installation.
The equipment WRAP Access Server equipment transmits in the 2400 - 2483.5 MHz frequency range, so the applicable MPE limit is 1 mW/cm². The equipment can be provided with up to 4 Bluetooth modules WT11# (FCC ID: QOQWT11): Under the conditions stated above MPE limits can be guaranteed as the calculation below shows: Example 1. 15.247 or 15.407 Compact Flash Card with maximum allowed e.i.r.p. of 4 W Using Equation from page 18 of OET Bulletin 65, Edition 97-01: S Compact Flash card = Prad (e.i.r.p.
Copyright © 2000-2011 Bluegiga Technologies Page 38 of 61
Copyright © 2000-2011 Bluegiga Technologies Page 39 of 61
8 Appendices 8.1 Access Device directory tree Access Device Directory Tree ============================ / |-- bin |-- dev | `-- shm | |-- etc | |-- tmp | | |-- obex | `-- var | |-- lock | | `-- subsys | |-- log | |-- run | `-- empty |-- etc | |-- backup files | |-- configreset | | |-- post.d | | `-- pre.d | |-- init.d -> rc.d/init.d | |-- ppp | | `-- peers | |-- rc.d | | |-- init.d | | `-- rc3.d | |-- rc3.d -> rc.d/rc3.d | |-- rc.d | | |-- init.d | | |-- rc0.d | | |-- rc1.d | | `-- rc3.d | |-- rc0.d -> rc.
|-- sys |-- tmp -> dev/shm/tmp {code} {code:none} |-- usr | |-- bin | |-- lib | | `-- gconv | |-- libexec | |-- local | |-- sbin | `-- share | |-- tabset | |-- terminfo | | |-- a | | |-- l | | |-- s | | |-- v | | `-- x | `-- usb-modeswitch `-- var |-- empty -> ../dev/shm/var/empty |-- lib | |-- btclass | |-- dpkg | | `-- info | |-- obexsender | `-- setup |-- lock -> ../dev/shm/var/lock |-- log -> ../dev/shm/var/log |-- run -> ../dev/shm/var/run |-- spool | `-- cron | `-- crontabs |-- tmp -> ..
Name Type Port Pluggable VID:PID without extension cable Usb-modeswitch Notes needed A-Link 3GU 3G /dev/ttyUSB2 AS=no, AP=no, AX4=yes GPRS-MODEM GPRS /dev/ttyUSB0 AS=no, AP=no, AX4=yes 067b:0609 no Falcom SAMBA 75 GPRS /dev/ttyACM0 AS=no, AP=no, AX4=yes 0681:0034 no FCC ID: QIXSAMBA75, use ATD*99***1# Global Wireless WM66-TF 3G /dev/ttyUSB0 AS=no, AP=yes, AX4=yes 05c6:0015 yes (05c6:2000) micro-SD reader does not work, do not use or AS/AP might not boot up Huawei E160E 3G /dev/ttyUSB0
MTX-H25 3G /dev/ttyACM0 AS=no, AP=no, AX4=no 0681:0047 no Newolution Webbox GPRS /dev/ttyUSB0 AS=no, AP=no, AX4=no 0403:6001 no Nokia CS-15 3G /dev/ttyACM0 AS=no, AP=yes, AX4=yes 0421:0611 yes (0421:0610) FCC ID: PYARD-10, Nokia CS-10 might work also Sierra Wireless Compass 885 3G /dev/ttyUSB3 AS=no, AP=yes, AX4=yes 1199:6880 no FCC ID: N7NC885, micro-SDHC reader works SIMCom SIM5218 3G /dev/ttyUSB2 AS=no, AP=no, AX4=no 05c6:9000 no Module in evaluation kit tested.
Non-working modems Name Type Huawei E160X / Vodafone K3565 3G VID:PID Notes 12d1:1003 Should work but we tested SIM locked device. NetComm USB56 Rave! POTS 0483:7554 NTTDocomo Foma L02A 3G 1004:610c Contact Bluegiga to get this modem to work. NTTDocomo Foma L05A 3G 1004:613a Contact Bluegiga to get this modem to work. Option Icon 225 3G 0af0:6971 does not support ppp Sony-Ericsson WD400 3G 0fce:d0e1 tested with 4.
Edimax EW-7718UN b/g/n yes AS=no, AP=yes, AX4=yes 7392:7711 rt2870 needs kernel-modules-wifi-experimental , tested by customer Linksys WUSB54GC-EU ver. 1 b/g yes AS=no, AP=yes, AX4=yes 13b1:0020 rt2571 FCC ID Q87-WUSB54GC, first version (silver) Linksys WUSB54GC-EU ver.
Non-working Wi-Fi dongles Name VID:PID Chipset A-Link WNU 0bda:8192 rtl8192 Belkin F5D7050 v5000 050d:705e rtl8187b FCC ID: K7SF5D7050E Buffalo WLI-USB-KB11 0411:0044 prism FCC ID: NKRUSB400 D-Link DWA-131 07d1:3303 rtl8192 HW ver. A1, FW ver. 1.20 tested EDUP 54M 0457:0163 sis163u Netgear WG111T 1385:4251 ar5523 Skycity SY-W8509 0bda:8176 rtl8192cu TP-LINK TL-WN620G ver 1.
Working webcams All USB video class devices needs kernel-modules-media (not installed by default) to work. Other USB video class devices should work also but we have listed only ones we have tested. Name VID:PID Notes AVEO Technology USB Camera 1871:01f0 Logitech Quickcam Ultra Vision 046d:08c9 Non-working webcams Name VID:PID Notes Logitech QuickCam Web 046d:0850 Working ethernet adapters All listed USB ethernet adapters have build-in support and appear as second ethernet device (eth1).
Name VID:PID Chipset Notes AmbiCom WL1100C-CF d601:0002 prism FCC ID: NI3IS20V35 Ambicom WL54-CF 02df:8103 libertas FCC ID: P5T-WL54CF, chipset revision too old Ambicom WL5400-CF 02df:8103 libertas insertion reboots AS Canon K30225 0004:2003 prism OEM version tested D-Link DCF-660W d601:0005 prism FCC ID: M4Y-08150 Linksys WCF12 028a:0673 prism Linksys WCF54G 0156:0004 ? Pretec 802.
8.3 Available Software Packages Package Description Installed by default badctl Bluegiga utility for controlling Access Devices. yes bash GNU Projects Bourne Again SHell, interactive shell with Bourne shell syntax. no bgtupnpd Universal plug and play daemon yes bluetooth Bluegiga iWRAP service. yes bluez-hcidump Bluetooth packet analyzer. no bluez-libs Bluetooth libraries needed by bluez-hcidump. no bstool Bluegiga Bluetooth baseband control utilities including btclass command.
duma Detect Unintended Memory Access no dun Bluegiga iWRAP service helper application. no ed POSIX-compliant line editor. no ehealthbundle Bluegiga eHealth bundle no ehealthxml XMLs and defines used in SDK no evtest evtest: Event device test program no expat The Expat XML Parser yes finder Bluegiga utility to find other Bluetooth Access Devices in the network. yes forkserver Bluegiga example: the simplest Bluetooth RFCOMM server. no ftpd Simple FTP server.
kernel-modules-ralink kernel wifi modules for ralink RT2870/RT3070/RT3370/RT3572/RT8070 no kernel-modules-realtek Linux kernel module for Realtek USB Wi-Fi chipsets. no kernel-modules-sound Linux kernel sound modules. no kernel-modules-wifi-experimental kernel linuxwireless tree no kernel-modules-wifi Wi-Fi drivers and firmwares yes kitt Bluegiga utility for controlling LEDs (and buzzer). yes ledtest Bluegiga example: LED control.
lighttpd-mod-extforward Secure, fast, compliant, flexible and small memory footprint http server. no lighttpd-mod-fastcgi Secure, fast, compliant, flexible and small memory footprint http server. no lighttpd-mod-flv-streaming Secure, fast, compliant, flexible and small memory footprint http server. no lighttpd-mod-proxy Secure, fast, compliant, flexible and small memory footprint http server. no lighttpd-mod-scgi Secure, fast, compliant, flexible and small memory footprint http server.
obexget Bluegiga iWRAP OBEX utilities: obexput and obexget commands for transfering files to/from remote devices with ObjP/FTP support. yes obexsender Bluegiga proximity marketing service. yes obexsender-db Bluegiga proximity marketing device database. yes obexserver Bluegiga iWRAP service: ObjP and FTP server. yes oggplayerbundle Bluegiga oggplayer bundle no openntpd NTP (RFC-1305) client and server.
setup Bluegiga Access Server and Access Point configuration utility and commands wrapid and supportinfo. yes setup-helloworld Bluegiga example: extending setup application. no setup-json-bridge Setup-Json-bridge no smsgw Bluegiga SMS Gateway. no socat SOcket CAT establishes byte streams and transfers data between them no sqlite SQLite is a software library that implements a self-contained, serverless, zero-configuration, transactional SQL database engine. no strace System call trace, i.e.
8.4 Enabled Busybox Applets Command Description [ Check file types, compare values etc. Return a 0/1 exit code. [[ Check file types, compare values etc. Return a 0/1 exit code. addgroup Add a group or add an user to a group. adduser Add an user. adjtimex Tune kernel clock. ar Create, modify, and extract from archives. arp Manipulate ARP cache. arping Send arp request to a neighbour host. ash The ash shell. awk Pattern scanning and processing language.
delgroup Delete group from system or user from group. deluser Delete user from system. depmod Program to generate modules.dep and map files. df Report file system disk space usage. diff Find differences between two files. dirname Strip non-directory suffix from file name. dmesg Print or control the kernel ring buffer. dnsdomainname Show the system's DNS domain name dpkg A medium-level package manager for (.deb) packages. dpkg-deb Debian package archive (.deb) manipulation tool.
inetd Internet services daemon. Notice that this server is disabled by default. Use the WWW interface of setup application or the chkconfig inetd on command to enable it. init Process control initialization. insmod Simple program to insert a module into the Linux kernel. ip Linux ipv4 protocol implementation. ipaddr Displays addresses and their properties, adds new addresses and deletes old ones. iplink Network device configuration.
nice Run a program with modified scheduling priority. nohup Run a command immune to hangups, with output to a non-tty. nslookup Query Internet name servers interactively. passwd Update a user's authentication tokens(s). patch Apply a diff file to an original. pgrep Display process(es) selected by regex. pidof List PIDs of all processes with names that match one specified. ping Send icmp echo_request to network hosts. ping6 Send icmp echo_request to network hosts.
swapon Start swapping to file/device. sync Flush file system buffers. sysctl Read/write system parameters. syslogd System logger. tail Output the last part of files. tar Create, extract, or list files from a tar file. tcpsvd Create TCP socket, bind it to ip:port and listen for incoming connection. Run PROG for each connection. telnet User interface to the telnet protocol. telnetd Telnet daemon. test Check file types and compare values. tftp TFTP client. tftpd TFTP server.
wget The non-interactive network downloader. which Shows the full path of (shell) commands. whoami Print effective userid. xargs Build and execute command lines from standard input. xzcat Decompress to standard output. yes Output a string repeatedly until killed. zcat Expand and concatenate data. zcip Manage a ZeroConf IPv4 link-local address.
9 Contact information Sales: sales@bluegiga.com Technical support: support@bluegiga.com http://techforum.bluegiga.com Orders: orders@bluegiga.com WWW: http://www.bluegiga.com http://www.bluegiga.hk Head Office / Finland: Phone: +358-9-4355 060 Fax: +358-9-4355 0660 Sinikalliontie 5 A 02630 ESPOO FINLAND Head address / Finland: P.O. Box 120 02631 ESPOO FINLAND Sales Office / USA: Phone: +1 770 291 2181 Fax: +1 770 291 2183 Bluegiga Technologies, Inc.