= Gateworks Malibu Family
{{{
#!html
}}}
[[PageOutline]]
The Gateworks Malibu product family utilizes the Marvell CN913x SoC (System On Chip) offering a large variety of peripherals with a focus on Networking and I/O. See [http://www.gateworks.com/product here] for a product comparison matrix.
= Links
'''Please note: This is a subset of information for Malibu, however, please visit our [wiki:WikiStart Main Wiki] for all other information'''
== GW3089 GBlade ARM Server Blade
Please see the GBlade page: [wiki:malibu/gw3089gblade]
== Software
* [#software Software Section] - Bootloader, Boot Firmware, Operating Systems, Kernel, etc
== Peripheral Support
* Connector Pinouts - see [http://www.gateworks.com/usermanuals Hardware User Manual]
* [wiki:alternateconnectors Connector and Cable Information]
* [wiki:gettingstarted Serial Console Access]
* [wiki:USB USB Support]
* [wiki:SPI SPI Support]
* [wiki:I2C I2C Support]
* [wiki:gpio/#gpiolib GPIO Control]
* [wiki:gpio/#led_class LED Control]
* [wiki:gps GPS Support]
* [wiki:canbus CAN Bus Support]
* [wiki:minipciexpressmodules PCIe Accessory Cards]
* [wiki:MMC MultiMediaCard (microSD/eMMC) Information]
* [wiki:gsc Gateworks System Controller (GSC)] - Temperature, voltage, RTC, GPIO, Digital IO, I/O, pushbutton, etc
== Other Info
* [http://www.gateworks.com/product#malibu Product Info]
* [http://shop.gateworks.com Where to Buy]
* [wiki:linux/devicetree Linux Kernel Device-Tree info]
* [wiki:eol End of Life - EOL Dates ]
== User Manuals
* [http://www.gateworks.com/usermanuals All Gateworks User Manuals]
== Entire Raw Index of Malibu Wiki Pages
[[TitleIndex(malibu)]]
[=#software]
= Malibu Software
Malibu Software is comprised of many pieces, including the following:
* GSC (Gateworks System Controller) Firmware
* Boot Firmware (ARM Trusted Firmware, DDR controller Firmware, U-Boot Bootloader)
* Operating System (including kernel / rootfs)
An Ubuntu based OS is pre-installed on all Malibu boards before they ship.
Please view the following links for the appropriate software section:
* [wiki:malibu/bsp#images Pre-built Software Images]
* [wiki:malibu/bsp Building & Compiling BSP (Board Support Package) Images] - This includes all the boot firmware & operating System
* [wiki:/malibu/firmware Malibu Software Installation page]
* [wiki:malibu/boot Malibu Boot Firmware (up to and including the Bootloader)]
* [wiki:gsc#GSCVersionHistory GSC Firmware]
* [#linux Malibu Mainline Linux kernel support]
* [#third_party_linux Booting Third Party Linux Distro's]
* [#jtag Malibu JTAG Programming]
* [wiki:ubuntu/#hello-world.c Native Compile Hello World Example]
* [wiki:buildroot Buildroot Linux]
[=#ubuntu]
=== Ubuntu
Gateworks offers a pre-built Ubuntu root filesystem using the latest Gateworks kernel as well as instructions on how to build your own Ubuntu based distribution.
* [wiki:/malibu/ubuntu Malibu Ubuntu Wiki and Software]
Malibu pre-built Ubuntu root filesytem image:
- '''Recommended for developers trying to heavily leverage opensource software packages or libraries that are not supported by the other BSP's. This is the most user-friendly for developers new to Embedded Linux but will not produce a very trimmed down filesystem image.'''
- The Gateworks Ubuntu focual image can boot to login in about 26 seconds (removing the U-Boot bootdelay) and takes about 1.5GiB of FLASH storage. Several seconds of that time is spent waiting for the network interfaces to come up which can be disabled. Much of the required space is taken up by various packages we pre-install however it is difficult to get Ubuntu pruned down below 1GiB or booting much faster.
- Able to use mainline kernel.
- Supports all Malibu features.
- Documentation provided to use Ubuntu pre-built packages and debootstrap to create a root filesystem in minutes
- Native compilation: no SDK or cross-toolchain needed
[=#buildroot]
=== Buildroot
Gateworks provides documentation on building your own compact and customized Linux distribution using [wiki:buildroot Buildroot]:
- intended for custom applications (low flash and memory footprint)
- a standard buildroot image can boot to login in about 8 seconds (removing the U-Boot bootdelay) and can take less than 32MiB of FLASH storage (both of which can be reduced by turning off the console output and reducing the kernel features)
- Fairly up-to-date and/or vanilla kernel support
- Wide variety of packages
- Console-based build system
- exportable Toolchain available to build apps on a development host outside of the buildroot environment
[=#third_party_linux]
= Third Party Linux Distros =
While Gateworks cannot fully support all Linux distros, it is relatively simple to overlay a Gateworks Malibu kernel onto any non-Gateworks third party Linux distro rootfs image.
The following links will describe what is needed:
1. Linux kernel supporting Malibu: [wiki:linux/kernel]
2. Root Filesystem: [#rootfs see below]
3. Bootable media: [wiki:linux/blockdev]
[=#rootfs]
=== Root filesystem Sources
There are several sources of pre-built root filesystems that are compatible with Malibu. As Malibu uses an ARM 64bit based SoC, you need to use something that is compatible with an ARMv8 instruction set. Many pre-built distributions will reference 'arm64' which means 'ARM 64-bit' which is appropriate for the CN913x SoC.