cfsghost/makerboard

Utility and emulator for development boards

MakerBoard

MakerBoard is utility and emulation for development boards, it supports MediaTek LinkIt Smart 7688 and MediaTek LinkIt Smart 7688 Duo currently.

This project supported by MakerCup Community, visit LinkIt-7688 Channel for more discussions.

Installation

MakerBoard can only be running on Linux. It depends on qemu and utilities which you need to install first.

For Debian/Ubuntu:

sudo apt-get install qemu-user-static squashfs-tools

Known issue: QEMU on Ubuntu 14.4 has a critical bug that it doesn't recognize ELF format. Trying to upgrade QEMU to 2.1+ version to solve this problem.

To make sure you have Node.js already, then install MakerBoard globally via NPM:

npm install makerboard -g

Usage

The makerboard utility can be used once you installed it.

Create an Emulation

Create a folder and prepare an emulation environment in it:

makerboard create my7688

If you want to create emulation environment by using own rootfs image, you can execute with option -i:

makerboard create my7688 -i /opt/foo/rootfs.squashfs

Run an Emulation Environment

With run command, we can run and enter to specific emulation environment:

makerboard run my7688

License

Licensed under the MIT License

Authors

Copyright(c) 2015 Fred Chien <[email protected]>

makerboard's Issues

npm ERR! Error: CERT_UNTRUSTED

when installing by " npm install -g makerboard", i got this error info:

npm http GET https://registry.npmjs.org/makerboard
npm http GET https://registry.npmjs.org/makerboard
npm http GET https://registry.npmjs.org/makerboard
npm ERR! Error: CERT_UNTRUSTED
npm ERR! at SecurePair. (tls.js:1370:32)
npm ERR! at SecurePair.EventEmitter.emit (events.js:92:17)
npm ERR! at SecurePair.maybeInitFinished (tls.js:982:10)
npm ERR! at CleartextStream.read [as _read] (tls.js:469:13)
npm ERR! at CleartextStream.Readable.read (_stream_readable.js:320:10)
npm ERR! at EncryptedStream.write [as _write] (tls.js:366:25)
npm ERR! at doWrite (_stream_writable.js:223:10)
npm ERR! at writeOrBuffer (_stream_writable.js:213:5)
npm ERR! at EncryptedStream.Writable.write (_stream_writable.js:180:11)
npm ERR! at write (_stream_readable.js:583:24)
npm ERR! If you need help, you may report this log at:
npm ERR! http://github.com/isaacs/npm/issues
npm ERR! or email it to:
npm ERR! [email protected]

npm ERR! System Linux 3.19.0-25-generic
npm ERR! command "/usr/bin/nodejs" "/usr/bin/npm" "install" "-g" "makerboard"
npm ERR! cwd /home/qwer
npm ERR! node -v v0.10.25
npm ERR! npm -v 1.3.10
npm ERR!
npm ERR! Additional logging details can be found in:
npm ERR! /home/qwer/npm-debug.log
npm ERR! not ok code 0

How to run?

Always get QUIT! message when run.

Failed to run create command

Hi,

I encountered this error when running command:
makerboard create my7688
And here's the error stack:

fs.js:844
  return binding.stat(pathModule._makeLong(path));
                 ^

Error: ENOENT: no such file or directory, stat '/usr/lib/node_modules/makerboard/data'
    at Error (native)
    at Object.fs.statSync (fs.js:844:18)
    at ClientRequest.<anonymous> (/usr/lib/node_modules/makerboard/lib/downloader.js:31:18)
    at ClientRequest.g (events.js:260:16)
    at emitOne (events.js:77:13)
    at ClientRequest.emit (events.js:169:7)
    at HTTPParser.parserOnIncomingClient [as onIncoming] (_http_client.js:430:21)
    at HTTPParser.parserOnHeadersComplete (_http_common.js:103:23)
    at TLSSocket.socketOnData (_http_client.js:320:20)
    at emitOne (events.js:77:13)

I am using elementary os freya (ubuntu 14.04) and have npm v3.10, node v4.4.7, and qemu utility installed.

Thanks

Error in "makerboard create my7688"

We ran install instruction step by step. After we ran "makerboard create my7688", the screen shown

/usr/local/lib/node_modules/makerboard/lib/container.js:256
co(function *() {
^
SyntaxError: Unexpected token *
at Module._compile (module.js:439:25)
at Object.Module._extensions..js (module.js:474:10)
at Module.load (module.js:356:32)
at Function.Module._load (module.js:312:12)
at Module.require (module.js:364:17)
at require (module.js:380:17)
at Object. (/usr/local/lib/node_modules/makerboard/lib/makerboard.js:4:13)
at Module._compile (module.js:456:26)
at Object.Module._extensions..js (module.js:474:10)
at Module.load (module.js:356:32)

qemu: uncaught target signal 4 (Illegal instruction) - core dumped

how to solve this issue when running an Emulation Environment?

Doesn't work on Ubuntu 14.4

QEMU has a known bug that it doesn't recognize ELF format for MIPS. This bug will cause makerboard failed to switch to emulation environment.

Note that this bug was fixed already in August 2014. Trying to upgrade QEMU to 2.1 version to solve this bug.