Panasonic PAN9026 Instruction Manual

PAN9026
Wi-Fi Dual Band 2.4/5 GHz and Bluetooth Module
Developer's Guide
Rev. 1.0
Wireless Modules

PAN9026 Wi-Fi/BT Module
Developer's Guide Rev. 1.0 Page 2
By purchase of any of the products described in this document the customer accepts the document's
validity and declares their agreement and understanding of it is contents and recommendations.
Panasonic Industrial Devices Europe GmbH (Panasonic) reserves the right to make changes as required
at any time without notification.
© Panasonic Industrial Devices Europe GmbH 2018.
This document is copyrighted. Reproduction of this document is permissible only if reproduction is without
alteration and is accompanied by all associated warranties, conditions, limitations, and notices. Do not
disclose it to a third party.
All rights reserved.
This Developer’s Guide does not lodge the claim to be complete and free of mistakes.
The information contained herein is presented only as guidance for Product use. No responsibility is
assumed by Panasonic for any infringement of patents or any other intellectual property rights of third
parties that may result from the use of Product. No license to any intellectual property right is granted by
this document, whether express or implied, by estoppel or otherwise.
Description of hardware, software, and other information in this document is only intended to illustrate the
functionality of the referred Panasonic product. It should not be construed as guaranteeing specific
functionality of the product as described or suitable for a particular application.
Any provided (source) code shall not be used or incorporated into any products or systems whose
manufacture, use or sale is prohibited under any applicable laws or regulations.
Any outlined or referenced (source) code within this document is provided on an “as is” basis without any
right to technical support or updates and without warranty of any kind on a free of charge basis according
to § 516 German Civil Law (BGB) including without limitation, any warranties or conditions of title, non-
infringement, merchantability, or fitness for a particular purpose. Customer acknowledges that
(source) code may bear defects and errors.
The third-party tools mentioned in this document are offered by independent third-party providers who are
solely responsible for these products. Panasonic has no responsibility whatsoever for the performance,
product descriptions, specifications, referenced content, or any and all claims or representations of these
third-party providers. Panasonic makes no warranty whatsoever, neither express nor implied, with respect
to the goods, the referenced contents, or any and all claims or representations of the third-party providers.
To the maximum extent allowable by Law Panasonic assumes no liability whatsoever including without
limitation, indirect, consequential, special, or incidental damages or loss, including without limitation loss of
profits, loss of opportunities, business interruption, and loss of data.

PAN9026 Wi-Fi/BT Module
Developer's Guide Rev. 1.0 Page 3
Table of Contents
1About This Document.........................................................................................................................4
1.1 Purpose and Audience ..............................................................................................................4
1.2 Revision History.........................................................................................................................4
1.3 Use of Symbols .........................................................................................................................4
1.4 Related Documents...................................................................................................................5
2Overview..............................................................................................................................................6
2.1 Wi-Fi Features...........................................................................................................................6
2.2 Bluetooth Features ....................................................................................................................6
3Installation...........................................................................................................................................8
3.1 Boot Card Setup........................................................................................................................8
3.2 Device for Remote Control ........................................................................................................9
4Developer Image...............................................................................................................................10
4.1 Prerequisites............................................................................................................................11
4.2 Configuration Steps.................................................................................................................11
4.3 Build Steps ..............................................................................................................................12
4.4 µSD Card Creation Steps........................................................................................................13
5Application Usage.............................................................................................................................14
5.1 Setup.......................................................................................................................................14
5.2 Connecting to the Access Point...............................................................................................15
5.3 Remote Controlling the PAN9026-IMX....................................................................................16
5.4 Exploring the Wi-Fi Features...................................................................................................16
5.5 Exploring the Bluetooth Features ............................................................................................18
6Background Information ..................................................................................................................23
6.1 Distribution Configuration ........................................................................................................23
6.2 Base Image Configuration.......................................................................................................23
6.3 Kernel-Specific Configuration..................................................................................................23
6.4 Addition of Marvell Drivers.......................................................................................................24
6.5 DHCP Configuration................................................................................................................25
6.6 ALSA Configuration.................................................................................................................25
6.7 Web Server Configuration .......................................................................................................25
6.8 Bluetooth Applications.............................................................................................................25
6.9 Custom Service.......................................................................................................................26
7Contact Details..................................................................................................................................27
7.1 Contact Us...............................................................................................................................27
7.2 Product Information .................................................................................................................27

PAN9026 Wi-Fi/BT Module
1 About This Document
Developer's Guide Rev. 1.0 Page 4
1 About This Document
1.1 Purpose and Audience
This Developer’s Guide explains how to re-create “developer image”which is based on
Yocto Project Linux.
The image is suited for the PAN9026-IMX system, which consists of a Wandboard Dual
(WB-IMX6U-BW) and the PAN9026-MSD.
This Developer’s Guide also describes the necessary steps to work with the resulting system
and explains some background details of the implementation.
The document is intended for experienced software engineers that want to get the
PAN9026 module to work in their custom Linux-based host system.
1.2 Revision History
Revision
Date
Modifications/Remarks
1.0
2018-09-13
Initial version
1.3 Use of Symbols
Symbol
Description
Note
Indicates important information for the proper use of the product.
Non-observance can lead to errors.
Attention
Indicates important notes that, if not observed, can put the product’s functionality
at risk.
Tip
Indicates useful information designed to facilitate working with the module.
[chapter number]
[chapter title]
Cross reference
Indicates cross references within the document.
Example:
Description of the symbols used in this document 1.3 Use of Symbols.

Requirement
Indicates a requirement that must be met before the corresponding tasks can be
completed.

Result
Indicates the result of a task or the result of a series of tasks.
This font
GUI text
Indicates fixed terms and text of the graphical user interface.
Example:
Click Save.

PAN9026 Wi-Fi/BT Module
1 About This Document
Developer's Guide Rev. 1.0 Page 5
Symbol
Description
Menu > Menu item
Path
Indicates a path, e.g. to access a dialog.
Example:
In the menu, select File > Setup page.
This font
File names, messages, user input
Indicates file names or messages and information displayed on the screen or to
be selected or entered by the user.
Examples:
pan1760.c contains the actual module initialization.
The message Failed to save your data is displayed.
Enter the value Product 123.
[ Key ]
Key
Indicates a key on the keyboard, e.g. [ F10 ].
1.4 Related Documents
[1] PAN9026 Quick Start Guide
Please refer to the Panasonic website for more information as well as related documents
7.2 Product Information.

PAN9026 Wi-Fi/BT Module
2 Overview
Developer's Guide Rev. 1.0 Page 6
2 Overview
The PAN9026-IMX is a development platform for the Wi-Fi/BT PAN9026 module.
The PAN9026 module requires a fairly powerful host processor that executes both the low-level
Wi-Fi driver as well as some high-level Wi-Fi application software.
Because of this, the Wandboard was chosen as the hardware platform. It is based on the
well-known and powerful NXP i.MX6 processor and provides a separate µSD card slot for
attaching peripheral devices like the PAN9026-MSD.
A Linux-based installation was chosen as the software platform. The Linux kernel provides an
established environment for running a Wi-Fi driver and the available Wi-Fi applications make it
possible to use the PAN9026 module to its full extend.
Two different software environments are available for the PAN9026-IMX.
First, an Ubuntu Linux-based environment is available to showcase all the different possibilities
of the PAN9026 module, which also allows the user to experiment with the system using a
graphical user interface. This environment is described in the PAN9026 Quick Start Guide
which is available separately.
Second, a Yocto Project Linux-based environment is available to showcase the easy integration
into a customer-specific build environment. This environment is described in this
Developer’s Guide.
This Developer’s Guide assumes deep knowledge about how to use the
Yocto Project to create a Linux-based system image. It will not go into details
and answer questions that are considered out of scope for PAN9026-IMX.
The Linux environment created by using the Yocto Project provides access to the Wi-Fi and
Bluetooth features of the PAN9026 module.
Please refer to the Panasonic website for related documents 7.2 Product Information.
2.1 Wi-Fi Features
The Linux environment created by using the Yocto Project provides access to the Wi-Fi features
of the PAN9026 module by supplying a web server running on a Wi-Fi access point.
After a connection to that access point has been established, it is possible to interact with the
PAN9026 module with the browser.
It can simultaneously connect to another Wi-Fi access point and relay any internet connectivity
from there.
2.2 Bluetooth Features
The Linux environment created by using the Yocto Project also provides access to the
Bluetooth features of the PAN9026 module by providing several Bluetooth applications.
All Bluetooth applications have been implemented using “Blue SDK”from OpenSynergy.
For further information please refer to http://www.opensynergy.com/en/products/blue-sdk.

PAN9026 Wi-Fi/BT Module
2 Overview
Developer's Guide Rev. 1.0 Page 7
It is possible to select one of the following Bluetooth applications through the user interface
provided by the web server.
The Bluetooth Basic Rate A2DP application allows the PAN9026-IMX to become a Bluetooth
audio sink. It is possible to playback audio from a remote device that is connected via Bluetooth
Basic Rate, which is then output via the audio jack.
Alternatively the PAN9026-IMX may become a Bluetooth Low Energy proximity beacon using
the “AltBeacon”Protocol, which is a popular beacon implementation used for indoor navigation.

PAN9026 Wi-Fi/BT Module
3 Installation
Developer's Guide Rev. 1.0 Page 8
3 Installation
The PAN9026-IMX consists of the following components:
PAN9026-MSD –µSD card form factor
Wandboard Dual (WB-IMX6U-BW)
USB Power cable as power supply
The following additional components are not included, but are required for all use cases:
µSD card with at least 2 GB capacity
RS232 serial connection cable (interface the built-in UART port to a control PC)
Some Wi-Fi capable device like a mobile phone or a tablet
Finally the following additional components are not included, but may be required depending on
the use case:
Headphones with 3.5 mm jack (in order to listen to Bluetooth audio)
3.1 Boot Card Setup
The Wandboard actually consists of two separate parts:
The Baseboard that contains all the connectors and
A system-on-module that contains the i.MX6 processor.
The system-on-module is located on the back of the Wandboard and may have a heat-spreader
covering the processor.
The Wandboard has two µSD card slots:
One for the boot medium, which is located on the system-on-module, and
One for peripheral devices, which is located on the Baseboard.
Usually the µSD card with the Ubuntu Linux image is already inserted in the µSD card slot on
the system-on-module so that the Wandboard will boot from it.

PAN9026 Wi-Fi/BT Module
3 Installation
Developer's Guide Rev. 1.0 Page 9
Notice that the µSD card slot of the system-on-module can be found on the
left side when the Wandboard is turned around and the audio connectors are
facing downwards:
In order to replace the µSD card gently press the connector and the µSD card will spring out.
Remember the orientation of the contacts –the contacts must face upwards
when the µSD card is inserted.
3.2 Device for Remote Control
Certain functions of the PAN9026-IMX can be remote controlled via Wi-Fi, so a Wi-Fi capable
device for controlling is needed.
For the sake of simplicity it is assumed that an Android mobile phone is used for this purpose,
but other devices may be used as well.

PAN9026 Wi-Fi/BT Module
4 Developer Image
Developer's Guide Rev. 1.0 Page 10
4 Developer Image
The Yocto Project is used to create a custom embedded Linux distribution for the
PAN9026-IMX.
For further information please refer to https://www.yoctoproject.org.
A fairly powerful Linux-based machine running a compatible Linux distribution is necessary to
build the developer image.
Ubuntu Linux 16.04 LTS has been successfully used to build the developer
image.
Ubuntu Linux 18.04 LTS has been used successfully as well, but the Yocto
Linux environment will emit a warning message.
The build process may take several hours to complete and requires an internet connection.
Make sure that all prerequisites as explained on
https://www.yoctoproject.org/docs/2.4.3/yocto-project-qs/yocto-project-qs.html
in the chapter “The Build Host Packages” are installed on the system.
The “repo”tool is used to manage the necessary Git repositories.
For further information please refer to https://gerrit.googlesource.com/git-repo.
Make sure that the “repo”tool is installed on the system. It may be necessary
to customize the user name and e-mail address as well.
After creation, this distribution consists of a disk image which includes a recent Linux kernel,
kernel modules for both the Wi-Fi and Bluetooth parts of the PAN9026 module, a complete
wireless access point setup (including IPv4 forwarding) and a running web server to remote
control the setup.
The disk image containing this custom embedded Linux distribution is called “developer image”
for the rest of this document.

PAN9026 Wi-Fi/BT Module
4 Developer Image
Developer's Guide Rev. 1.0 Page 11
4.1 Prerequisites
The following items are additionally needed to successfully execute the instructions that follow:
Panasonic “pan-yocto” software package ZIP file
Marvell software package ZIP file
4.1.1 Panasonic Software Package
The Panasonic “pan-yocto” software package ZIP file contains the environment and the
necessary “recipe” files for the Yocto Project Linux to create the “developer image”.
Please contact your local Panasonic sales representative in order to get
access to the latest version of the “pan-yocto” software package ZIP file.
4.1.2 Marvell Software Package
A recent software package from Marvell is necessary to build the drivers for the
PAN9026 module.
The following Marvell software package has been used as a basis for the developer image:
SD-WLAN-SD-BT-8977-U16-MMC-V16.68.1.p170-16.26.1.p170-C4X16544_V2-
MGPL.zip
To download this or the latest version, please refer to
https://extranet.marvell.com.
Please contact your local Panasonic sales representative in order to get
access to the Marvell Extranet.
4.2 Configuration Steps
1. Unpack the Panasonic “pan-yocto” software package ZIP file on the build machine.
The file contains the following minimal Git repositories:
–manifest
–meta-pideu
–pideu-base
The repo manifest file manifest/default.xml is the starting point for starting the image
creation.

PAN9026 Wi-Fi/BT Module
4 Developer Image
Developer's Guide Rev. 1.0 Page 12
2. Execute the following shell commands in the location where the ZIP file was unpacked:
repo init -u manifest
repo sync
The “repo”tool will download all necessary external dependencies for the build that
are not included in the delivery.
3. After the download has finished, unzip the Marvell driver to the right location.
In this example it is assumed that the download of the driver was done to the
folder /tmp/.
unzip /tmp/SD-WLAN-SD-BT-8977-U16-MMC-V16.68.1.p170-16.26.1.p170-
C4X16544_V2-MGPL.zip -d ./sources/meta-pideu/recipes-
kernel/kernel-modules/
4.3 Build Steps
The following requirements must be met:
Successfully configuration
1. Setup the environment in the directory build:
TEMPLATECONF=$(pwd)/sources/base/conf MACHINE=pan-imx DISTRO=pan
source setup-environment "build"
The directory conf within the folder build is only updated the first time when
the folder build is populated.
Consecutive executions of the above command will not synchronize the
content of the folder conf.
2. Start the actual build from the directory build.
bitbake image-pideu
The resulting binary image is named imx-uboot-spl-<timestamp>-
mmcblk.direct.

PAN9026 Wi-Fi/BT Module
4 Developer Image
Developer's Guide Rev. 1.0 Page 13
4.4 µSD Card Creation Steps
The binary image that was created in the previous step can now be written to a µSD card, for
example by using the built-in SD card slot of a PC or an external USB-to-SD adapter.
Make very sure to use the correct /dev/ entry. Accidently using a wrong entry
may damage your system!
The resulting <path-to-SD-device> depends on your system. It is something like
/dev/sdb, or /dev/mmcblk0.
The <path-to-image> is the image file you created in the previous build step.
1. Write the binary image to the µSD card:
sudo dd if=<patch-to-image> of=<path-to-SD-device> bs=1M
status=progress

PAN9026 Wi-Fi/BT Module
5 Application Usage
Developer's Guide Rev. 1.0 Page 14
5 Application Usage
By default the system provides a Wi-Fi access point that remote devices can connect to.
The following features can be controlled through a simple-to-use web interface:
Provide one wireless network access point (AP)
Access a wireless network
Forward IP connections between the different networks
Bluetooth Classic for A2DP audio streaming
Bluetooth LE for beacon functionality
No additional peripherals are needed.
5.1 Setup
The following components are needed:
Wandboard with µSD card containing the Yocto Project Linux image
PAN9026-MSD with µSD card form factor
Headphones with 3.5 mm jack
Power supply
1. Insert the µSD card containing the Yocto Project Linux image as explained in
3.1 Boot Card Setup.
2. Insert the PAN9026-MSD into the µSD card slot of the Baseboard (1).
3. Insert the headphones with 3.5 mm jack into the green audio socket (2).
4. Insert the power supply (3).
The system will boot up. This takes approximately one minute.

PAN9026 Wi-Fi/BT Module
5 Application Usage
Developer's Guide Rev. 1.0 Page 15
5.2 Connecting to the Access Point
1. Navigate to the Wi-Fi configuration settings of your device and enable Wi-Fi if it is not
enabled already.
The access point provided by the PAN9026 module is named PAN9026_uAP0 and will be found
automatically.
2. Click PAN9026_uAP0 to make the device connect to this access point.
The connection is established and is shown as Connected, no Internet.
Add this point you can access the PAN9026 module just fine, but cannot use
any features that required internet access yet.

PAN9026 Wi-Fi/BT Module
5 Application Usage
Developer's Guide Rev. 1.0 Page 16
5.3 Remote Controlling the PAN9026-IMX
On the PAN9026-IMX a web server is running which provides the user interface for remote
controlling the system.
1. Open the web browser.
2. Navigate to the address 192.168.33.1 to access (1).
5.4 Exploring the Wi-Fi Features
The Wi-Fi features of the PAN9026 module can be controlled using the Station section on the
web page (1).
The PAN9026 module is capable of connecting to an existing access point while acting as an
access point itself.

PAN9026 Wi-Fi/BT Module
5 Application Usage
Developer's Guide Rev. 1.0 Page 17
The user interface is intuitive and will guide you through the possible use cases.
(1) Click Refresh to refresh the list of found access points.
(2) Click Network SSID to select an access point.
(3) Enter the matching password into the Network Password field.
(4) Click Create Connection to create the connection.
The PAN9026 module will connect to it. This takes approximately a couple of
seconds.
Because the PAN9026 is connected to an access point with internet
connection, your device is now able to access the internet through the access
point of PAN9026-IMX as well.

PAN9026 Wi-Fi/BT Module
5 Application Usage
Developer's Guide Rev. 1.0 Page 18
Now you can use another browser window to access any page in the internet,
for example pideu.panasonic.de (1).
5.5 Exploring the Bluetooth Features
The Bluetooth features of the PAN9026 module can be controlled using the Bluetooth section
on the web page (1).

PAN9026 Wi-Fi/BT Module
5 Application Usage
Developer's Guide Rev. 1.0 Page 19
1. Click Stop application to stop the currently running Bluetooth application (1).
5.5.1 Bluetooth Low Energy AltBeacon
1. Click Beacon application to start the Bluetooth Low Energy AltBeacon application (1).
The device is advertising according to the AltBeacon specification.
You can use the “Locate Beacon”app from “Radius Networks, Inc.”to
discover the PAN9026 module.

PAN9026 Wi-Fi/BT Module
5 Application Usage
Developer's Guide Rev. 1.0 Page 20
In the Locate Beacon app the PAN9026 module will show up as a regular AltBea-
con (1).
5.5.2 Bluetooth Basic Rate A2DP audio sink
1. Click A2DP application to start the Bluetooth Basic Rate A2DP audio sink
application (1).
The device is available as an A2DP audio sink.
2. Navigate to the Bluetooth settings of your device. Make sure that Bluetooth is enabled.
3. Click on the entry to connect to the PAN9026 module (1).