summaryrefslogtreecommitdiff
path: root/README
blob: 159fffd38dbf0ccde4ad93320bc90466ee3eb4b6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
mLinux - MultiTech Linux for MultiConnect Conduit gateways
============================================================

mLinux is a distribution provided by MultiTech tailored for the 
MultiConnect Conduit products (MTCDT models).

mLinux utilizes OpenEmbedded-Core, Bitbake, which are part of the Yocto Project.

This branch is based on Yocto Thud.  MTCDT3 is based on kernel 4.19.
non-MTCDT3 is based on Linux-AT91 4.9.  mLinux 5.3+.y

For more information about mLinux, see http://www.multitech.net

For more information about the Yocto Project, see http://www.yoctoproject.org
For more information about OpenEmbedded, see http://www.openembedded.org

-------------------------
       BUILDING
-------------------------

Note that mLinux should *not* be built as root and you will need full write 
permissions to the build directory structure.  It is recommended to build 
the software inside your $HOME dir as a normal user.

1. Build from tarball

    tar xzf mLinux-3.0.0.tar.gz
    cd mlinux-3.0.0
    # install needed dependencies, see scripts in install-deps
    # Also switch to the build directory.
    # example: sudo ./install-deps/install-debian-ubuntu-deps.sh
    source oe-init-build-env

    # set your default machine type in conf/local.conf
    # MACHINE="mtcdt"

    # build an image
    bitbake mlinux-base-image

2. Build from git repository

    # clone repo to a dir name of your choice
    git clone git://git.multitech.net/mlinux.git mlinux-3.0.0
    cd mlinux-3.0.0

    # checkout desired branch or tag
    git checkout 3.0.0

    # install needed dependencies, see scripts in install-deps
    # example: sudo ./install-deps/install-debian-ubuntu-deps.sh

    # initialize git submodules and setup dir structure
    ./setup.sh
    # setup.sh generates a random mtadm password, and places the
    # password in build/conf/local.conf and password.txt
    #
    # 
    # To specify a password use an environmental variable,
    # MTADM_PASSWORD
    MTADM_PASSWORD="3g_t1zX0" ./setup.sh 
    #
    # To change the password, remove MTADM_PASSWORD and
    # MTADM_PASSWORD_HASH from conf/local.conf and re-run:
    MTADM_PASSWORD="Y5bG3m_2" ./setup.sh

    # setup environment and switch to build directory
    source oe-init-build-env

    # set your default machine type in conf/local.conf
    # MACHINE="mtcdt"

    # build an image (current working directory is
    # build)
    bitbake mlinux-base-image

-------------------------
        IMAGES
-------------------------

mlinux-base-image: Small image with essential packages -- good starting point for a custom image

mlinux-factory-image: Large image loaded on units by default -- contains full language support (perl, python, java, ruby, nodejs)

-------------------------
    PRE-BUILT IMAGES
-------------------------

http://multitech.net/mlinux/images

-------------------------
       MORE INFO
-------------------------

See the MultiTech Developer website (http://www.multitech.net) for full 
installation and build instructions. In particular, see the "Introduction" and
"Getting Started" pages under the mLinux section.

You can also join the available developer forums to post queries and receive 
updates from MultiTech developers.