summaryrefslogtreecommitdiff
path: root/README
blob: 21b13b1ceb316a16528ad800bbb134816da629b1 (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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
This is the branch for mLinux >= 6.0.0

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.

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

This branch is based on Yocto Thud.  Atmel devices use kernel Linux-AT91 4.9.

It is no longer safe to assume MTCDT for the MACHINE type.  All builds
now require the external variable MACHINE to be set.

Building MTCDTIP2 requires:

MACHINE=mtcap


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

All version between 5.1 and 5.3.0a inclusive have
cellular issues with modems becoming disabled
due to COPS=2 set more or less permanently
on rare occassions.

Version 5.3.0a through 5.3.0c have issues with git
trying to access unreachable repositories.  The
recommended version after 5.0.x is 5.3.0d.

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
    #
    #
    # The specified password is ignored for commissioning images.
    # 
    # 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-commissioning-image: Large image loaded on units by default -- contains full language support (perl, python)
mlinux-mtcap-commissioning-image: MTCAP image

-------------------------
    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.