Skip to content
Projects
Groups
Snippets
Help
Loading...
Sign in
Toggle navigation
W
White Rabbit Switch - Software
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
86
Issues
86
List
Board
Labels
Milestones
Merge Requests
4
Merge Requests
4
CI / CD
CI / CD
Pipelines
Schedules
Wiki
Wiki
image/svg+xml
Discourse
Discourse
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Commits
Issue Boards
Open sidebar
Projects
White Rabbit Switch - Software
Commits
c09776e7
Commit
c09776e7
authored
Dec 20, 2012
by
Alessandro Rubini
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
doc: final bits for release (and explain MAC issues)
Signed-off-by:
Alessandro Rubini
<
rubini@gnudd.com
>
parent
e3720418
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
28 additions
and
18 deletions
+28
-18
wrs-build.in
doc/wrs-build.in
+28
-18
No files found.
doc/wrs-build.in
View file @
c09776e7
...
@@ -35,7 +35,7 @@
...
@@ -35,7 +35,7 @@
@setchapternewpage off
@setchapternewpage off
@set update-month
Octo
ber 2012
@set update-month
Decem
ber 2012
@finalout
@finalout
...
@@ -400,8 +400,8 @@ This is the same naming policy of the kernel and other packages.
...
@@ -400,8 +400,8 @@ This is the same naming policy of the kernel and other packages.
The prefix is @code{wrs-firmware-}; the information about the current status are
The prefix is @code{wrs-firmware-}; the information about the current status are
retrived by using the git commmand @code{git describe --always --dirty}.
retrived by using the git commmand @code{git describe --always --dirty}.
For example, if you are building the tag @code{wr-switch-sw-v3.
0
}, your package
For example, if you are building the tag @code{wr-switch-sw-v3.
1
}, your package
name will be @code{wrs-firmware-wr-switch-sw-v3.
0
.tar.gz}. If you are building
name will be @code{wrs-firmware-wr-switch-sw-v3.
1
.tar.gz}. If you are building
on some personal commit the name includes some extra information to describe
on some personal commit the name includes some extra information to describe
your commit: number of commits form the last tag (if any), SHA1 code of the
your commit: number of commits form the last tag (if any), SHA1 code of the
commit. If you have uncommited changed, the suffix @code{-dirty} is there too.
commit. If you have uncommited changed, the suffix @code{-dirty} is there too.
...
@@ -572,6 +572,13 @@ MAC address to sequentially assign a MAC address for every switch ports.
...
@@ -572,6 +572,13 @@ MAC address to sequentially assign a MAC address for every switch ports.
-
m2
02
:
34
:
34
:
34
:
34
:
00
-
m2
02
:
34
:
34
:
34
:
34
:
00
@
end
example
@
end
example
Please
remember
that
bits
0
and
1
of
the
first
byte
are
special
:
if
the
first
byte
is
odd
,
the
MAC
address
is
reserved
for
multicast
transmission
(
the
script
doesn
't check, and the kernel will refuse to
enact such address). Bit 1 is set for ``locally assigned'' numbers:
while official MAC addresses have bit 1 clear, if you choose your
unofficial addresses you should set the bit.
If you don'
t
configure
a
MAC
address
,
a
warning
will
be
displayed
and
If you don'
t
configure
a
MAC
address
,
a
warning
will
be
displayed
and
you
can
abort
the
procedure
.
If
you
don
't abort the flashing
you
can
abort
the
procedure
.
If
you
don
't abort the flashing
procedure, the script will use default MAC addresses. Default MAC addresses
procedure, the script will use default MAC addresses. Default MAC addresses
...
@@ -715,9 +722,14 @@ If your system maps the Atmel ROM to a different device name, please
...
@@ -715,9 +722,14 @@ If your system maps the Atmel ROM to a different device name, please
pass
the
name
on
the
command
line
.
The
script
wants
a
full
pathname
pass
the
name
on
the
command
line
.
The
script
wants
a
full
pathname
starting
with
@
code
{/}.
starting
with
@
code
{/}.
If you want to flash your own @i{at91boot.bin}, @i{barebox.bin}, @i{kernel}
If
you
want
to
flash
the
@
i
{
at91boot
.
bin
},
@
i
{
barebox
.
bin
},
@
i
{
kernel
}
or @i{file-system} you can just place them in the @file{$WRS_OUTPUT_DIR/images}
or
@
i
{
file
-
system
}
that
you
just
built
,
you
can
just
call
the
script
directory and call the script with @code{-b|--build} option.
from
the
build
directory
and
use
the
@
code
{-
b
}
option
.
The
official
binaries
for
installation
of
version
3.1
of
this
package
are
available
in
the
@
i
{
files
}
tab
of
@
t
{
ohwr
.
org
}.
The
complete
link
is
:@*
@
url
{
www
.
ohwr
.
org
/
attachments
/
download
/
1770
/
wr
-
switch
-
sw
-
v3
.1
-
2012
-
12
-
20
-
binaries
.
tar
.
gz
}
.
You
can
select
a
mode
using
the
@
code
{-
m
|--
mode
}
flag
to
choose
You
can
select
a
mode
using
the
@
code
{-
m
|--
mode
}
flag
to
choose
to
write
in
dataflash
(
df
),
nandflash
(
nf
),
both
(
default
)
or
ddr
memories
to
write
in
dataflash
(
df
),
nandflash
(
nf
),
both
(
default
)
or
ddr
memories
...
@@ -731,9 +743,7 @@ install different binaries on these memories:
...
@@ -731,9 +743,7 @@ install different binaries on these memories:
You
can
also
erase
the
dataflash
memory
before
writing
your
binaries
;
to
do
this
You
can
also
erase
the
dataflash
memory
before
writing
your
binaries
;
to
do
this
add
the
option
@
code
{-
e
}.
Note
that
the
script
always
erases
nandflash
before
add
the
option
@
code
{-
e
}.
Note
that
the
script
always
erases
nandflash
before
writing on it.
writing
to
it
.
Finally,
The
script
performs
the
following
steps
:
The
script
performs
the
following
steps
:
...
@@ -955,7 +965,7 @@ evaluation board without even changing the board name):
...
@@ -955,7 +965,7 @@ evaluation board without even changing the board name):
@end example
@end example
The script @i{wrs_build_at91boot} uncompresses, patches and builds, leaving
The script @i{wrs_build_at91boot} uncompresses, patches and builds, leaving
@
code
{
images
/
at91bootstrap
.
bin
}
after
it
is
over
.
This
file
is
@code{images/
@-at91bootstrap.bin} after it is over.
This file is
the one to be loaded in the hardware.
the one to be loaded in the hardware.
For simplicity, a known-working binary is part of the @i{binaries}
For simplicity, a known-working binary is part of the @i{binaries}
directory of this package as @code{at91bootstrap.bin}, the same name used
directory of this package as @code{at91bootstrap.bin}, the same name used
...
@@ -1009,8 +1019,8 @@ configuration are described in @ref{Booting with Barebox}.
...
@@ -1009,8 +1019,8 @@ configuration are described in @ref{Booting with Barebox}.
Building
@
i
{
barebox
}
relies
on
a
@
i
{
Kconfig
}
setup
,
and
the
Building
@
i
{
barebox
}
relies
on
a
@
i
{
Kconfig
}
setup
,
and
the
configuration
file
we
use
is
configuration
file
we
use
is
@file{patches/barebox/wrs3_defconfig}. Again, this is copied over and
@
file
{
patches
/
barebox
/
@-
wrs3_defconfig
}.
Again
,
this
is
copied
over
and
not patched in (see the simple @file{build/scripts/wrs_build_barebox}
not
patched
in
(
see
the
simple
@
file
{
build
/
scripts
/
@-
wrs_build_barebox
}
for
details
).
for
details
).
After
patching
and
copying
over
the
files
,
the
following
commands
After
patching
and
copying
over
the
files
,
the
following
commands
...
@@ -1226,7 +1236,7 @@ the filesystem for the switch, also making the archives and the
...
@@ -1226,7 +1236,7 @@ the filesystem for the switch, also making the archives and the
@
i
{
jffs2
}
image
file
.
@
i
{
jffs2
}
image
file
.
The
step
of
setting
up
the
complete
filesystem
is
performed
by
The
step
of
setting
up
the
complete
filesystem
is
performed
by
@file{build/scripts/wrs_build_wraprootfs}. The script
@
file
{
build
/
scripts
/
@-
wrs_build_wraprootfs
}.
The
script
does
not
leave
a
directory
tree
on
disk
because
that
would
require
does
not
leave
a
directory
tree
on
disk
because
that
would
require
administrator
privileges
.
We
think
it
is
best
not
to
call
@
i
{
sudo
}
from
administrator
privileges
.
We
think
it
is
best
not
to
call
@
i
{
sudo
}
from
within
build
scripts
,
to
respect
our
users
' security concerns.
within
build
scripts
,
to
respect
our
users
' security concerns.
...
@@ -1631,8 +1641,8 @@ An archive with all the pieces you'll need for this upgrade (and maybe
...
@@ -1631,8 +1641,8 @@ An archive with all the pieces you'll need for this upgrade (and maybe
a little more than that) can be downloaded from the @i{files} section
a little more than that) can be downloaded from the @i{files} section
of the @i{White Rabbit} project on @code{ohwr.org}. (However, the
of the @i{White Rabbit} project on @code{ohwr.org}. (However, the
archive doesn'
t
include
the
filesystem
image
,
which
is
big
and
didn
't
archive doesn'
t
include
the
filesystem
image
,
which
is
big
and
didn
't
change
from
release
3.0
).
The
direct
link
is
change from release 3.0). The direct link is
:@*
@
url
{
http
://
www
.
ohwr
.
org
/
attachments
/
download
/
1648
/
reflash
-
2012
-
10
-
09.
tar
.
gz
}
@url{www.ohwr.org/attachments/download/1648/reflash-2012-10-09.tar.gz}
@sp 1
@sp 1
...
@@ -1744,9 +1754,9 @@ suboptimal, while some procedures may be tricky and need more explanation.
...
@@ -1744,9 +1754,9 @@ suboptimal, while some procedures may be tricky and need more explanation.
We are collecting all those issues in the @i{wiki} page of the
We are collecting all those issues in the @i{wiki} page of the
project, to avoid frequent updates to this manual to just collect
project, to avoid frequent updates to this manual to just collect
those
details
.
So
please
visit
those details.
So please visit
@
url
{
http
://
www
.
ohwr
.
org
/
projects
/
wr
-
switch
-
sw
/
wiki
/
Bugs
}
and
@url{www.ohwr.org/projects/wr-switch-sw/wiki/Bugs} and
@
url
{
http
://
www
.
ohwr
.
org
/
projects
/
wr
-
switch
-
sw
/
wiki
/
Troubleshooting
}
@url{www.ohwr.org/projects/wr-switch-sw/wiki/Troubleshooting}
if you have any problem with this package, but feel free to reach us
if you have any problem with this package, but feel free to reach us
on the mailing list if you don'
t
find
help
there
.
on the mailing list if you don'
t
find
help
there
.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment