1 mangOH Green with WP7607 or WP7607-1

Contents

1.1 Board Overview

The mangOH Green is an open-source hardware development platform for CF3 modules that incorporates several hardware interfaces and standardized IoT Expansion Card slots for expanded functionality.

1.1.1 Block Diagram

Fig. 1.44 mangOH Green Basic Block Diagram

Fig. 1.45 mangOH Green Detailed Block Diagram

1.1.2 Photos

Fig. 1.46 mangOH Green Top View

Fig. 1.47 mangOH Green Angled View

Fig. 1.48 mangOH Green Front View

1.2 Build Targets

1.2.1 Machines

Table 1.24 Supported Machines

Board[1]	Target YAML[2]	Machine[3]	Target Recipe(s)[4]	Running Media[5]	Installation Media[6]
mangOH Green with WP7607 or WP7607-1	mangoh-green-wp7607.yml	mangoh-green-wp7607	tanowrt-image-full	NAND flash	–

[1]

Target board.

[2]

Target YAML-file located in the kas/targets directory.

[3]

Target machine name stored in the MACHINE BitBake variable for selected Target YAML.

[4]

Recipes that will be built by default for the target. In Section 1.2.2, you can find list of supported recipes for the target images, which you can build in addition to the default recipes using optional --target option in build command (see Section 1.3).

[5]

External or internal data storage where the TanoWrt operating system is running.

[6]

External storage device for which an installation image is generated. When booting from the Installation Media, the TanoWrt system is installed on the Running Media storage.

1.2.2 Images

Table 1.25 Supported Images

Read-Only Root Filesystem Image	Recipe[7]	Supported by Target(s)	Description
tanowrt-image-full	tanowrt-image-full	All	Standard TanoWrt image.

[7]

Image recipe name. This name can be used as argument for --target build command option (see Section 1.3 section).

1.3 Build

Please read the common information on how to perform a TanoWrt images build and preparing the build environment in section “Building TanoWrt”.

See also

• See section Section 1.2.1 to select the required target YAML file (<target-yml>).

• See section Section 1.2.2 to select the required root filesystem image recipe (<target-recipe>).

• See section Section 1.5 for detailed information about the produced build artifacts.

1.3.1 Examples

1.3.1.1 Build Default Image for mangOH Green Board with WP7607

$ kas build targets/kas/mangoh-green-wp7607.yml

1.4 Partitioning Layouts

Here is a list of used by system MTD partitions and their descriptions.

MTD	Name	Size	Description
mtd11	aboot	1 MiB	Little Kernel (LK) bootloader
mtd12	boot	14 MiB	Linux kernel
mtd13	system	59 MiB	Read-only root filesystem (squashfs)
mtd14	lefwkro	17.25 MiB	Unused
mtd15	swirw	15.5 MiB	Unused
mtd16	userapp	130 MiB	Overlay filesystem (ubifs)

All user data are stored in overlayfs in partition mtd16 (userapp). You can clean up this partition manually after system is boots up using the command:

[root@tanowrt ~]# jffs2reset -r -y

or over web-interface LuCI (see Restore section in System → Backup).

1.5 Produced Build Artifacts

All produced build artifacts are stored in the ~/tanowrt/build/tanowrt-glibc/deploy/images/<MACHINE> directory. Refer to table Produced Build Artifacts for a description of some common build artifacts.

Table 1.26 Produced Build Artifacts

Artifact	Target(s)	Description
Bootloader
appsboot.mbn	All	Bootloader (Little Kernel) binary with fastboot support.
boot-yocto-mdm9x28.img	All	Image with bootloader and linux kernel.
Linux Kernel and DTB
zImage-<MACHINE>.bin	All	Linux kernel compressed binary image.
dtb	All	Folder with compiled Device Tree Blobs (DTB).
masterDTB.4k	All	Image with compiled Device Tree Blobs (DTB).
Images
<rootfs-image>-<MACHINE>.squashfs	All	Read-only root filesystem image (squashfs).
<rootfs-image>-<MACHINE>.ubi	All	Read-only root filesystem image (UBI).
<rootfs-image>-<MACHINE>.wp76xx.spk	All	SPK image contains bootloader, linux kernel, DTB and read-only filesystem images. This image can be used for firmware upgrade with swiflash utility (see Writing Images).

Note

<MACHINE> in the artifacts path and artifact file names are replaced by the actual value of the MACHINE BitBake variable for the chosen target. <rootfs-image> is replaced by the actual read-only root filesystem image name.

For example, below is the lists of artifacts produced by the mangoh-green-wp7607-nand.yml and mangoh-green-wp7607-sd.yml target builds. There are two types of listings here — a complete listing, and a reduced listing without the symbolic links display.

ReducedComplete

[~/tanowrt/build/tanowrt-glibc/deploy/images/mangoh-green-wp7607]$ ls -gGh | grep -v -e "^l"
total 315M
-rwxr-xr-x 1 530K Jul 29 10:56 appsboot.mbn
-rw-r--r-- 1   32 Jul 29 11:00 boot_hash.2k
-rw-r--r-- 1   32 Jul 29 11:00 boot_hash.4k
-rw-r--r-- 1   40 Jul 29 11:00 boot_mbnhdr
-rw-r--r-- 1 6.0M Jul 29 11:00 boot-yocto-mdm9x28-20220729080026.2k.img
-rw-r--r-- 1 6.1M Jul 29 11:00 boot-yocto-mdm9x28-20220729080026.4k.img
-rw-r--r-- 1 6.0M Jul 29 11:00 boot-yocto-mdm9x28.2k.img.signed
-rwxr-xr-x 1 6.0M Jul 29 11:00 boot-yocto-mdm9x28.2k.img.unsigned
-rw-r--r-- 1 6.1M Jul 29 11:00 boot-yocto-mdm9x28.4k.img.signed
-rwxr-xr-x 1 6.0M Jul 29 11:00 boot-yocto-mdm9x28.4k.img.unsigned
drwxr-xr-x 3 4.0K Jul 29 11:00 dtb
-rw-r--r-- 1   67 Jul 29 11:00 kernel.version
-rw-r--r-- 1   44 Jul 29 10:56 lk.version
-rw------- 2 414K Jul 29 11:00 masterDTB.2k
-rw------- 2 420K Jul 29 11:00 masterDTB.4k
-rw-r--r-- 2  37M Jul 29 11:00 modules--3.18.140+git0+4e1fa14c28-tn-3.2.7.20.0.6-mangoh-green-wp7607-20220729063515.tgz
-rw-r--r-- 2 512K Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.reset.ubifs.4k.ubi
-rw-r--r-- 2  45K Jul 29 11:02 tanowrt-image-full-mangoh-green-wp7607-20220729063515.rootfs.manifest
-rw-r--r-- 2  21M Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.rootfs.squashfs
-rw-r--r-- 2 176K Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.rootfs.squashfs.hash
-rw-r--r-- 2  608 Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.rootfs.squashfs.hash.txt
-rw-r--r-- 2 5.5K Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.rootfs.squashfs.rhash
-rw-r--r-- 2   65 Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.rootfs.squashfs.rhash.unsigned
-rw-r--r-- 2  117 Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.rootfs.squashfs.ubinize.cfg
-rw-r--r-- 2   24 Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.rootfs.version
-rw-r--r-- 2  23M Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.squashfs.4k.ubi
-rw-r--r-- 2 325K Jul 29 11:02 tanowrt-image-full-mangoh-green-wp7607-20220729063515.testdata.json
-rw-r--r-- 1  30M Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.wp76xx.clean.spk
-rw-r--r-- 1  30M Jul 29 11:03 tanowrt-image-full-mangoh-green-wp7607-20220729063515.wp76xx.spk
-rwxr-xr-x 2 132M Jul 29 11:00 vmlinux
-rw-r--r-- 2 5.6M Jul 29 11:00 zImage--3.18.140+git0+4e1fa14c28-tn-3.2.7.20.0.6-mangoh-green-wp7607-20220729063515.bin

1.6 Writing Images

Note that when flashing the <rootfs-image>-<MACHINE>.wp76xx.spk images (see Produced Build Artifacts section), user data in overlayfs are not cleared. This allows flashing of a new system while keeping the user configuration. However, it can also cause issues with the new firmware as it may not update some important files. See “Used Flash Partitions” section for extra information about clearing overlayfs data.

To write the built image to the device, follow these steps:

1. Power off the mangOH Green board.

2. Turn SW401-7 (TP1_BOOT) DIP switch to ON state.

3. Connect mangOH Green board with your PC via micro USB cable (connector CN311).

4. Power on mangOH Green board.

5. Run the swiflash utility on your PC as follows:

   $ swiflash -m wp76xx -i <path-to-image> -p <port>
   

   Where:

   -i <path-to-image>

   Path to image file in the CWE (SPK) format.

   -p <port>

   USB port that will be used to firmware downloading. You can use any path from /dev/serial/by-path or /dev/serial/by-id.

   Example:

   $ swiflash -m wp76xx \
       -p /dev/serial/by-id/usb-Sierra_Wireless__Incorporated_Sierra_Wireless_WP7607_VN91720016071042 \
       -i ~/tanowrt/build/tanowrt-glibc/deploy/images/mangoh-green-wp7607/tanowrt-image-full-mangoh-green-wp7607.wp76xx.spk
   

6. Wait until the flashing is complete.

7. Power off mangOH Green board.

8. Turn SW401-7 (TP1_BOOT) DIP switch back to OFF state.

9. Power on mangOH Green board.

10. Flashed system will be booting.

1.7 Booting and Running

1. Power on board.

2. TanoWrt will be booting from internal NAND.

3. Log in to system using default credentials.

Note

We recommend to upgrade your WP76xx modem firmware to release 16 from here.

1.8 Serial Console

At startup, the bootloader and Linux kernel log messages are outputed to the serial port UART2 (RS232 DB9 connector CN700 on board).

The default serial console settings for mangOH Green with WP7607 for bootloader and kernel are described in the table below.

Parameter	Value
Baudrate	115200
Data bits	8
Stop bits	1
Parity	none
Flow control	none

1.9 Default Network Configuration

By default configured and enabled only eth0 interface with static IPv4 address 192.168.10.1 with enabled DHCP server on it.

1.10 Web User Interface

The WebUI can be accessed via any Ethernet port bridged to LAN network (1 or 2) or via USB RNDIS connection through HTTP(s) protocol. You must see something like this in browser:

Fig. 1.49 LuCI WebUI Login Page

Fig. 1.50 LuCI WebUI Overview Page

1.11 Firmware Upgrade

Attention

Default for TanoWrt firmware upgrade method is not supported for mangOH Green with WP7607 target.

mangOH Green with WP7607 has its own upgrade system.

1.12 Limitations

This layer has very little support for the modem hardware. Using this layer you can only set up a PPP connection using the internal modem AT command port. This is all the capabilities of this layer for using modem hardware.

For support more sophisticated features of the modem hardware, an additional meta-tanowrt-hsl-swi-extras layer is required. Extra meta-tanowrt-hsl-swi-extras layer is a TanoWrt hardware support layer (HSL) for the Sierra Wireless modules contains recipes for proprietary/commercial software. Extra meta-tanowrt-hsl-swi-extras layer provides support for the following extra features:

• Partial or full firmware upgrade via WebUI

  

• Control and monitor via WebUI or/and ubus

  

• Modem data connection (supported LTE/UMTS/GSM modes)

• Support for GNSS subsystem (WebUI and ubus)

• Receiving and sending SMS over WebUI or/and ubus with notifications (full UCS2 alphabet support)

• Legato Framework

• and much more…

Sources of meta-tanowrt-hsl-swi-extras layer cannot be published publicly due to Qualcomm Inc. and Sierra Wireless Inc. proprietary licenses restrictions but can be provided commercially. Please contact Tano Systems LLC for details.

1.13 Additional Information

Here are sections with various additional information about the mangOH Green with WP7607 and the operation of TanoWrt on it.

• 1.13.1 Setting Up a Modem Data Connection

1.14 References

1. https://mangoh.io/mangoh-green

2. https://www.sierrawireless.com/products-and-solutions/embedded-solutions/products/wp7607/

3. https://www.sierrawireless.com/products-and-solutions/embedded-solutions/products/wp7607-1/