Bluegiga Access Server 229x Software version 3.2 README ======================================================= Location ======== https://www.bluegiga.com/as/ Contact ======= support@bluegiga.com Contents ======== - Full software release for all Access Server hardware versions. - SDK update is available for SDK customer. DO NOT TRY TO USE OLD SDK. Description =========== This update contains fixes and updates for Access Server Software. For details of changes since earlier software versions, see below. This update is recommended to all Bluegiga Access Servers. This update can be applied to Access Server using software version 3.0 or 3.1. You can verify the software version with the command "wrapid". If there is no such command or it talks about wrong version number, please upgrade your system to 3.1 first. Instructions are available at https://www.bluegiga.com/techforum/ AFTER INSTALLING THIS UPDATE, IT IS NOT NEEDED (NEITHER WORKING ANYMORE) TO USE NULL MODEM ADAPTER WITH SERIAL CABLE TO CONNECT THE MANAGEMENT CONSOLE. Just use the shipped direct serial cable without the adapter. Installation Instructions ========================= Three update packages are delivered: reflash-if-3.2-*.wpk for AS with S/N 0607240001 or higher reflash-df-3.2-*.wpk for AS with S/N 0607239999 or smaller, using software 3.1 update-3.2-*.wpk for AS using software 3.1 (saves old configs) Read below instructions to select the correct one. reflash-if-3.2-*.wpk -------------------- - for Access Server with serial number 0607240001 or higher, using software version 3.0 or 3.1 - performs "factory reset" and reflash, all data on root partition is erased and system is fully reprogrammed - user data partition under /usr/local is not touched reflash-df-3.2-*.wpk -------------------- - for Access Server with serial number 0607239999 or smaller, using software version 3.0 or 3.1 - performs "factory reset" and reflash, all data on root partition is erased and system is fully reprogrammed - user data partition under /usr/local is not touched update-3.2-*.wpk ---------------- - update package for Access Server using software 3.1, all serial numbers - old configuration files are mostly not touched - if touched, old configuration file is renamed to *.wpkg-save - if not touched, new configuration file is renamed to *.wpkg-new - user data partition under /usr/local is not touched Installation Instructions ------------------------- WARNING: IF YOU HAVE YOUR OWN APPLICATIONS RUNNING IN ACCESS SERVER, STOP THEM FIRST! To install, either: 1) Upload wpk file using WWW Setup -> Advanced settings -> Upload a software update or 2) Copy wpk file to the root directory of an empty USB memory dongle. Insert the dongle into Access Server's USB port. Wait for blue LEDs to start blinking from side to side and then remove the dongle. DO NOT TURN POWER OFF WHILE BLUE LEDS ARE BLINKING FROM SIDE TO SIDE. INSTALLATION TAKES 5-10 MINUTES, BE PATIENT! It is safe to use Access Server when all blue LEDs have turned off (only one LED blinks about every 30 seconds indicating Bluetooth server activity). Changes from 3.1 to 3.2 ======================= Fixed Bugs ---------- - watchdog reboot may fail on Access Server with S/N 0607240001..0612319999 ObexSender 2 ------------ - rewrite of old ObexSender - new config file format, please check it carefully - some old features are removed or renamed - some new features are added - support for device recognizing General Changes in System ------------------------- - kernel: use rtc watchdog in 229x-if (workaround for watchdog reboot bug) - kernel: add USB HID and event device support into kernel-modules - setup: server channels of supported BT profiles are now user configurable - setup: "sync now" option for NTP - setup: added generic "set bluetooth listen" configurator (SPP-over-IP etc..) - setup: added support for editing "description" field shown in wrapfinder - setup: option to configure syslog size and count - setup: warn about default passwords - finder: automatic fallback to nap:9 if nap has IP 0.0.0.0 - finder server: fix finding local IP addresses - sshd: protocol version 1 disabled - telnetd: enable standalone daemon (NEVER use telnet, use ssh instead!) - obexserver: --fork parameter is executed as is, file name is not appended - obexserver: some meta characters added to --fork, see manual iWRAP Changes ------------- - Connector: new application added for making automatic outgoing calls - added iWRAP command "SET BLUETOOTH LISTEN psm L2CAP:host:port" to forward incoming L2CAP to host:port using a raw TCP socket - in "CALL ... FORK" and "SET BLUETOOTH LISTEN" iWRAP commands, '-characters can be used to group multiple words to one parameter - new iWRAP commands: RSSI, TXPOWER, BER, CLOCK - added support for DeviceID profile - CSR firmware build ID is now shown in iWRAP's READY. prompt and wrapid output - iWRAP's "debug" command (and command line parameter) is removed. New command "log" is added. It takes one or two parameters: - bitmask number for log level: NONE 0x00 CONNECT 0x01 <- default IWRAP 0x02 IWRAPDEBUG 0x04 - logfile target: syslog <- default iWRAP stdout /path/to/logfile - btcli: add "--no-ready" parameter to omit READY. prompt - b2b_class#: renamed to btclass - To do inquiry, the correct command is "INQUIRY" without any parameters. The optional "NAME" parameter is removed. See manual for more information. Updates in Open Source Utilities -------------------------------- - busybox: updated to 1.3.1 - busybox: enabled "comm", "seq", "sha1sum" and some tr features - added: hostapd and wpa_supplicant: support for WPA/RSN supplicant and WPA/RSN authenticator modes (separate packages) - added: dosfstools: fsck.vfat binary to check usb dongles after power fail - added: CIFS client to mount CIFS shares (separate package) - added: lighttpd (separate package) SDK Changes ----------- - SDK requires Linux with GLIBC 2.5 (Fedora Core 6, Foobar Linux 5, RHEL 5, Ubunty Feisty, ...) - new libraries: bgiwrap, bgsocket, bgwatchdog, examples rewritten to use them Changes from 3.0 to 3.1 ======================= Fixed Bugs ---------- - after "reboot", Ethernet does not always come up - #136: "reboot" does sometimes not restart system - #117: GPRS/pppd problem: "unrecognized option '/dev/ttyS0'", ttyS0 lost General Changes in System ------------------------- - no need for null modem adapter with direct serial cable (management console) USING NULL MODEM ADAPTER DOES NOT WORK - Bluetooth PAN is disabled by default for security reasons. To enable PAN, copy enable-pan.wpk from the root directory of CD or lib directory of SDK CD to an USB dongle and insert the dongle to Access Server's USB port. You can also enable it at WWW Setup -> Bluetooth settings -> Bluetooth profiles -> Enable PAN network access point profile - SW version number reported in output of "wrapid" command and in /etc/bluegiga-release is "3.1" (previous ones: "wrap-3-0", "wrap-2-2") - security update: use shadow passwords - all Bluegiga application version numbers updated - kernel: updated from 2.6.17 to 2.6.17.14 - new command: supportinfo - /etc/inittab: cleaned up, better shutdown support added - Minor reorganizing in menu hierarchy of "setup" application: - order of top level menus - Bluetooth profile menus reorganized - "Default startup applications" also shows runlevel 0 (halt) Updates in Open Source Utilities -------------------------------- - removed applications from default image (available in separate packages): - tcpdump - strace - picocom - gdbserver - ntpclient: replaced with openntd 3.9p1 - busybox: - updated from 1.2.1 -> 1.2.2.1 - usleep command enabled - crond is now enabled by default, exits automatically if nothing to do - other updates: - bridge-utils 0.9.6 -> 1.2 - openssl 0.9.8a -> 0.9.8c - iptables 1.3.4 -> 1.3.6 - ftpd 1.4beta-2 -> 1.4beta-3 - pcmciautils 012 -> 014 - openssh 4.0p1 -> 4.5p1 - updates in utilities available in separate packages: - openvpn 2.0.5 -> 2.0.8 - tcpdump 3.9.4 -> 3.9.5 - gcc 3.4.5-1 -> 3.4.5-2 - hostap utils 0.3.7 -> 0.4.7 - new open source utilities, available in separate packages: - zd1211-driver r83: Wi-Fi driver for USB dongles with zd1211 or zd1211b like one from A-Link - openssl-progs 0.9.8c: openssl binary for file encryption, key creation for OpenVPN - heyu 2.0beta.6.2: X10 driver - hcidump 1.32: utility for debugging Bluetooth at HCI level - screen 4.0.2 (with and without UTF-8 support) - ncurses 5.5, needed by screen - default dhcpd configuration for nap added (disabled by default) SDK Changes ----------- - termcap updated - openssl compile configuration parameters changed: old: "no-idea no-cast no-rc2 no-rc4 no-rc5 no-mdc2 no-asm no-hw no-krb5" new: "no-idea no-rc5 no-mdc2 no-asm no-hw no-krb5" - ncurses updated from 5.3 -> 5.5 - setup-helloworld example added Changes from 2.2 to 3.0 ======================= General Changes in System ------------------------- - no need for null modem adapter with direct serial cable (management console) USING NULL MODEM ADAPTER DOES NOT WORK - Compact Flash memory cards are now supported - there is no /mnt/mtd anymore, user flash partition is mounted to /usr/local, also some other directory structure cleanup - kernel updated to 2.6.17 - multi-user support (when you log in as root, you are now in /root, not /) - network startup scripts and configuration in Setup reworked - hotplug reworked - wlan support reworked - /etc/termcap added - /etc/inittab improved - /etc/motd removed - updated BusyBox to 1.2.1 - rc.sysinit: runonce scripts and cleanup - udhcpd.conf -> udhcpd-gn.conf - RTC in SW2.2 used wrong epoch 1970, kludge added to fix it - UTF-8 support - use zcip for zeroconf - pppd: dhcp support for (already obsolete) Bluetooth lan profile - hotplug.usb: use wpkgdparam ("--auth") to usb dongles too - several open source component updates iWRAP Changes ------------- - /etc/bluetooth.setup is removed, all settings (with Setup, by user) are now stored to /etc/bluetooth.conf - Serial Port Profile is now disabled by default - updated ObexSender, Obexserver, SMS GW, see https://www.bluegiga.com/as/2.2/2-2-obex-smsgw/ - use compile date in iWRAP's READY prompt, not source's rcs stamp - iWRAP socket is not closed if invalid password - you can have lines with format "10101 SET CONTROL AUTOEXEC ..." in /etc/bluetooth.conf, not needing "10101 { SET CONTROL AUTOEXEC ... }" syntax Utilities Changes ----------------- - updated ObexSender, Obexserver, SMS GW, see https://www.bluegiga.com/as/2.2/2-2-obex-smsgw/ - setup: - "setup -o" outputs current config for "setup -m" - Advanced: add "btcli inquiry 4" - Bluetooth: add LAP IP config, mostly for ppp-dhcp-plugin - fix if obexsender.conf or log directive is missing - fix loading of empty iWRAP pass - fix root crontab location in Setup help - wrapid: outputs updated software components, some more options: --serial, --product, --prodid, --revision, --revid - btcli: add --fast: same as "--timeout 1" add --quiet: don't output anything. Return 1 if there is no output from iWRAP, 0 if some. For example: "btcli -q quit || echo iWRAP is not running" - wpkgd: added --list and --erase wrappers to dpkg - dataflasher: system upgrade utility reworked - kitt: LED/buzzer utility added - dfu: baseband upgrade application reworked - addgroup, delgroup: commands added - wrapfinder: Find zeroconf duplicates. Return errorlevel 1 if none found. - added "service" command - libhistory added SDK Changes ----------- - toolchain updates: - kernel 2.6.17 - GCC 3.4.5 - Glibc 2.3.6 - GDB 6.4 - Crosstool 0.42 - reflash-df.wpk is for old (pre 060630001 AS) with 16MB of DataFlash, reflash-if.wpk for RoHS versions with 32MB Intel Strataflash - libbgio removed; all information can be retrieved from wrapid and LED/Buzzer controlled using /dev/led - libobex and libobexclient removed, low level access to OBEX API must be done with a separate contract with Bluegiga in the future. obexbrowser is no longer an example. - "make sdk" builds native toolchain, which can be mounted from USB stick with sdkmount.wpk - SDK has better support for generating wpk's (use "make appwiz"!) - software packages (wpk) now have support for defining config files so that they are not overwritten in upgrade - openssl is not splitted to two packages anymore