Novena Main Page

From Studio Kousagi Wiki
Jump to: navigation, search

Novena is an open hardware and F/OSS-friendly computing platform.

If you are interested in buying one, you may pre-order one at crowd supply.

Real-time updates and announcements can be tracked by following @novenakosagi on twitter.

Alpha evaluators: Please visit Using Novena PVT1 for more info.

Contents

Hardware

novena_pvt1e_top_thumb.jpg
More photos: Novena PVT Hardware Photos

Mainboard

Features:

Items marked with an asterisk (*) require a closed-source firmware blob, but the system is functional and bootable without the blob.

Keep an eye on bunnie's blog for updates and notes. You can also discuss at the forum.

Power characteristics

Novena ought to be able to enter a low-power suspend mode, and resume it quickly. Novena power characterization.

Battery board

senoko_dvt1_thumb.jpg
More photos: Novena PVT Hardware Photos

Battery management functions are implemented in an optional daughtercard.

Features:

eDP Adapter

edp_evt2_thumb.jpg
More photos: Novena PVT Hardware Photos

Novena natively supports a dual-channel LVDS interface for LCDs. However, today's LCD panels are migrating to an eDP-style interface. To bridge this gap, there is the eDP adapter board.

Features:

Note to viewers: total power is cell power + backlight power. Cell power is just the power required to flip the LCD elements, not inclusive of backlight.

In addition, there is a custom flex cable that goes between the Novena mainboard and the eDP adapter. It's designed to handle the power requirements of the LCD, as well as manage signal integrity at high data rates.

Hardware Design Source

Please see Novena PVT Design Source for electronic CAD.

Please see Novena Mechanical CAD for mechanical CAD.

Firmware

The SD image that is installed on Novenas that ship is a disk image with a shrunken ext4 partition. To use the disk image, dd it onto an SD card, then resize the third partition to extend to the entire card. The factory imaging process performs these steps:

  1. dd the image to the card
  2. use fdisk to delete the third partition, then recreate it using defaults
  3. use fsck to check the partition
  4. use resize2fs to enlarge the partition

The disk image is available at http://repo.novena.io/novena/images/novena-mmc-disk-r1.img. It has the following sums:

SHA256: 26d368cb4b3aa43e411703f8c659d3e229deacfe75af38c1f82489dd9af80dbb
MD5: 6923a145cbdc75b420408fc2d09ba4f8
RSA: -----BEGIN PGP SIGNATURE-----
     Version: GnuPG v1
     
     iQIcBAABAgAGBQJUl8nFAAoJEKuwFcVr1hraGrIQALG5eMNeIOFdjgO/NLpKowCt
     tup8irrTebgaVW4CacZQa2152XKBHJKu6Um2jCPnP9/WwmjqgKKVi2PjcDj7pb4B
     Ng4eM4fWcMIHQaocPG3eRRYvn78FU4faUBmmoWL67kSf5UzvDE0PKChCKdJxSnM8
     dS2dgGbP4inTO6G3xYXBmd4Pok66Epvv4kETqImNB0HEs2TTym7gB9O8itnHtIP/
     hfKYJaXcr8y5tut+h7UY1/IObGFFvXuCVDKzA9HzaEQ/86wKX3B9u7kOrtz+8+5T
     HOSiRGwyxzffT2fdPyLduMGqqdXwDQvc/U/imKiQOWrmyJ0EfqLN9AV0OqsDofXI
     zNMQu+5MJUdgZN5+IRcKb7C/miOtr/KmKwyR138uGcWxnjtLqbQ552dPknpEgNdI
     14rBi/KYoyhx/op0U2VXbH01goNhFtYSzlZV3gQRy5J578lvn5UlgZCmqtzuWC5r
     s9NPP7U2DxO3Aqpk6TVGFiu2OiAW8xGA+44yjKHueHIuBW7TyJiDgfqgvCH76wGE
     0FRb9c6tg2LOw2r/Rlnpi9Jg30ZPvc5ICX8juv8dwlDGGmdVm8urLaQ2dHPnKnJu
     7YGFyb3OEN47/wTJNMpiDd8sy7pFIVcb/qTZK4W7qmLc8HPEIl4Kjz32j+4z61z0
     zJGnfwjEfimlOp1WgVay
     =KDZm
     -----END PGP SIGNATURE-----


Bootloader

U-boot is the current factory-default bootloader. Please see U-boot PVT Notes.

Most boot files, including the kernel and device tree, are located on the first partition. This partition is formatted VFAT, and is referred to as the "boot partition".

The loader is two-stage. The first stage is about 40k, and is responsible for initializing DDR3 RAM and loading the second stage from disk. The second stage is responsible for initializing the rest of the board, loading Linux, and jumping to it.

The first stage, called SPL (secondary program loader), lives outside of any partition at 1024 bytes from the start of the disk. A copy of the SPL is stored on the boot partition, and is called u-boot.spl. A script is provided to install a new SPL, called novena-install-spl(8).

The second stage is also located on the boot partition, and is called u-boot.img. This file is loaded by the SPL. It contains a baked-in script that loads the correct device tree file, parses the Novena/EEPROM, prunes the device tree as necessary, then jumps to the kernel. If the user button is held down, then the bootloader waits several seconds for the user to press Control-C on the serial console, and if nothing happens then it boots the recovery kernel.

The bootloader loads "zimage" from the boot partition, and pairs it with "novena.dtb". If booting into recovery, it will load "zimage.recovery" and "novena.recovery.dtb".

If the *rootfs_ssd* flag is set in the EEPROM, then the root parameter is set to **PARTUUID=4e6f7653-03**. If the *rootfs_ssd* flag is not set, or if booting into recovery mode, then the root parameter is set to **PARTUUID=4e6f764d-03**. This means that you should set your disk up such that the root partition is partition 3 (i.e. /dev/sda3), and set your disk ID correctly. To set the diskid, run fdisk on the disk, then go into Expert mode ('x'), then Change ID ('i').

Linux OS

Kernel

Novena uses the stock Linux kernel with few patches. Any patches that might be useful to other projects (such as PCIe or ES8328 audio codec) are being submitted upstream.

The 2D/3D/Vector unit requires its own driver, which is available in source form on Github. Different userspace drivers require different kernel modules, so be sure to check out the branch that corresponds with your driver version.

The git repo for the cutting edge linux that we're working on is at:

https://github.com/xobs/novena-linux

Make sure you switch to the desired branch, e.g. 3.14-rc4 etc.

Those doing GPIO hacking with linux may be interested in the Definitive GPIO guide for the i.MX6.

Distro

Debian is the factory-default distribution, but of course anyone can put their favorite distro on the system.

Quickstart gide on building and initializing a bootable Debian image:

The following Debian packages are available:

For more in-depth discussions on Debian and other notes, along with historical methods, please refer to these pages:

Dual Core Variant

Novena's base design works with the i.MX6DL. However, it does require some firmware changes. Notably, the bootloader is significantly different because there is much less SRAM to run from for setting things up. Also, the pinmuxes are different, so that issue has to be addressed in the device tree. See Novena/Dual Core for notes on this configuration.

Legacy

For those who want to cross-compile an OE-based image, please see building novena firmware

Software

Once you get Novena running, there are a few tweaks that you might have to make to the software to get it to run. Not all software likes running on Linux on anything other than x86/x64. Others just require software fixes to work around kernel bugs that we haven't fixed yet.

Please see Novena Software for more information.

Software projects

While Novena tries to be standard, it nevertheless has some platform-specific software projects that are necessary to take advantage of its unique hardware.

novena-eeprom: Command-line editor for the onboard EEPROM

novena-usb-hub: Manage the power status of each of the onboard USB hub's ports

Future software projects

novena-eeprom-gui: Graphical viewer/editor to inspect the onboard EEPROM

senoko-manager: Graphical manager for Senoko battery board

senoko-programmer: Firmware updater for Senoko battery board

User Guides

GPBB User Guide: The on-ramp to hardware hacking on Novena.

Mainboard User Guide

Laptop User Guide

Dekstop User Guide

More Pages

Getting started

Hardware Tech notes

Because I can't remember all those damn command lines

Archives

Shuttleworth Flash Grant

bunnie is a recipient of a 2014 Shuttleworth Flash Grant!

He will be using the grant money to further development of the Novena open hardware platform and to help grow the community around it.

Shuttleworth-Funded-480px.jpg

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox