diff --git a/doc/manuals/om2000/README b/doc/manuals/om2000/README
new file mode 100644
index 0000000..08f8cc1
--- /dev/null
+++ b/doc/manuals/om2000/README
@@ -0,0 +1,2 @@
+This is a set of message sequence charts documneting our understanding
+of Ericsson OM2000 at BTS start-up, by looking at protocol traces.
diff --git a/doc/manuals/om2000/om2k-bts.msc b/doc/manuals/om2000/om2k-bts.msc
new file mode 100644
index 0000000..0c64398
--- /dev/null
+++ b/doc/manuals/om2000/om2k-bts.msc
@@ -0,0 +1,24 @@
+msc {
+	trxc [label="TRXC"], tf [label="TF"], is [label="IS"], cf [label="CF"], bsc [label="BSC"];
+	cf => bsc	[label="Fault Report"];
+	cf <=> bsc	[label="Start incl. Negotiation"];
+	cf <=> bsc	[label="Operational Info"];
+
+	is <=> bsc	[label="Connect"];
+	is <=> bsc	[label="Reset"];
+	is <=> bsc	[label="Start"];
+	is <=> bsc	[label="Config"];
+	is <=> bsc	[label="Enable"];
+	is <=> bsc	[label="Operational Info"];
+
+	trxc <=> bsc	[label="TRXC + dependent objects"];
+
+	cf <=> bsc	[label="Calendar Time"];
+
+	tf <=> bsc	[label="Conncet"];
+	tf <=> bsc	[label="Reset"];
+	tf <=> bsc	[label="Start"];
+	tf <=> bsc	[label="Config"];
+	tf <=> bsc	[label="Enable"];
+	tf <=> bsc	[label="Operational Info"];
+}
diff --git a/doc/manuals/om2000/om2k-mo-cf.msc b/doc/manuals/om2000/om2k-mo-cf.msc
new file mode 100644
index 0000000..f10e519
--- /dev/null
+++ b/doc/manuals/om2000/om2k-mo-cf.msc
@@ -0,0 +1,19 @@
+msc {
+	bts [label="BTS"], bsc [label="BSC"];
+	# this is for the Central Function Object
+	---		[label="Initial state after initializing OML TEI"];
+
+	bts <= bsc	[label="Start Request"];
+	bts => bsc	[label="Reset Request Accept"];
+
+	bts => bsc	[label="Negotiation Request"];
+	bts <= bsc	[label="Negotiation Request ACK"];
+
+	bts => bsc	[label="Start Result (Started)"];
+	bts <= bsc	[label="Start Result ACK"];
+
+	bts <= bsc	[label="Operational Info (Operational)"];
+	bts => bsc	[label="Operational Info Accept"];
+
+	# continue with IS, TRXC, TF
+}
diff --git a/doc/manuals/om2000/om2k-mo-is.msc b/doc/manuals/om2000/om2k-mo-is.msc
new file mode 100644
index 0000000..20acdd8
--- /dev/null
+++ b/doc/manuals/om2000/om2k-mo-is.msc
@@ -0,0 +1,29 @@
+msc {
+	bts [label="BTS"], bsc [label="BSC"];
+	# this is for the Interface Switch Object
+	---		[label="Initial state after initializing CF"];
+
+	bts <= bsc	[label="Connect Command"];
+	bts => bsc	[label="Connect Complete"];
+
+	bts <= bsc	[label="Reset Command"];
+	bts => bsc	[label="Reset Complete"];
+
+	bts <= bsc	[label="Start Request"];
+	bts => bsc	[label="Start Request Accept"];
+	bts => bsc	[label="Start Result (Disabled)"];
+	bts <= bsc	[label="Start Result ACK"];
+
+	bts <= bsc	[label="IS Configuration Request"];
+	bts => bsc	[label="IS Configuration Request Accept"];
+	bts => bsc	[label="IS Configuration Result (According to Req)"];
+	bts <= bsc	[label="IS Configuration Result ACK"];
+
+	bts <= bsc	[label="Enable Request"];
+	bts => bsc	[label="Enable Request Accept"];
+	bts => bsc	[label="Enable Result (Enabled)"];
+	bts <= bsc	[label="Enable Result ACK"];
+
+	bts <= bsc	[label="Operational Info (Operational)"];
+	bts => bsc	[label="Operational Info Accept"];
+}
diff --git a/doc/manuals/om2000/om2k-mo-rx.msc b/doc/manuals/om2000/om2k-mo-rx.msc
new file mode 100644
index 0000000..4fe1365
--- /dev/null
+++ b/doc/manuals/om2000/om2k-mo-rx.msc
@@ -0,0 +1,31 @@
+msc {
+	bts [label="BTS"], bsc [label="BSC"];
+	# this is for the TRX Receiver Object
+	---		[label="Initial state after initializing TRXC"];
+
+	bts <= bsc	[label="Connect Command"];
+	bts => bsc	[label="Connect Complete"];
+
+	bts <= bsc	[label="Reset Command"];
+	bts => bsc	[label="Reset Complete"];
+
+	bts <= bsc	[label="Start Request"];
+	bts => bsc	[label="Start Request Accept"];
+	bts => bsc	[label="Start Result (Disabled)"];
+	bts <= bsc	[label="Start Result ACK"];
+
+	bts <= bsc	[label="Start Request"];
+	bts => bsc	[label="Reset Request Accept"];
+	bts => bsc	[label="Start Result (Disabled)"];
+	bts <= bsc	[label="Start Result ACK"];
+
+	bts <= bsc	[label="RX Configuration Request"];
+	bts => bsc	[label="RX Configuration Request Accept"];
+	bts => bsc	[label="RX Configuration Result"];
+	bts <= bsc	[label="RX Configuration Result ACK"];
+
+	bts <= bsc	[label="Enable Request"];
+	bts => bsc	[label="Enable Request Accept"];
+	bts => bsc	[label="Enable Result (Enabled)"];
+	bts <= bsc	[label="Enable Result ACK"];
+}
diff --git a/doc/manuals/om2000/om2k-mo-tf.msc b/doc/manuals/om2000/om2k-mo-tf.msc
new file mode 100644
index 0000000..ae1cdfd
--- /dev/null
+++ b/doc/manuals/om2000/om2k-mo-tf.msc
@@ -0,0 +1,29 @@
+msc {
+	bts [label="BTS"], bsc [label="BSC"];
+	# this is for the Timing Funcition Object
+	---		[label="Initial state after initializing CF"];
+
+	bts <= bsc	[label="Connect Command"];
+	bts => bsc	[label="Connect Complete"];
+
+	bts <= bsc	[label="Reset Command"];
+	bts => bsc	[label="Reset Complete"];
+
+	bts <= bsc	[label="Start Request"];
+	bts => bsc	[label="Reset Request Accept"];
+	bts => bsc	[label="Start Result (Disabled)"];
+	bts <= bsc	[label="Start Result ACK"];
+
+	bts <= bsc	[label="TF Configuration Request"];
+	bts => bsc	[label="TF Configuration Request Accept"];
+	bts => bsc	[label="TF Configuration Result (According to Req)"];
+	bts <= bsc	[label="TF Configuration Result ACK"];
+
+	bts <= bsc	[label="Enable Request"];
+	bts => bsc	[label="Enable Request Accept"];
+	bts => bsc	[label="Enable Result (Enabled)"];
+	bts <= bsc	[label="Enable Result ACK"];
+
+	bts <= bsc	[label="Operational Info (Operational)"];
+	bts => bsc	[label="Operational Info Accept"];
+}
diff --git a/doc/manuals/om2000/om2k-mo-trxc.msc b/doc/manuals/om2000/om2k-mo-trxc.msc
new file mode 100644
index 0000000..56fb639
--- /dev/null
+++ b/doc/manuals/om2000/om2k-mo-trxc.msc
@@ -0,0 +1,16 @@
+msc {
+	bts [label="BTS"], bsc [label="BSC"];
+	# this is for the TRX Controller Object
+	---		[label="Initial state after initializing IS"];
+
+	bts <= bsc	[label="Reset Command"];
+	bts => bsc	[label="Reset Complete"];
+
+	bts <= bsc	[label="Start Request"];
+	bts => bsc	[label="Reset Request Accept"];
+	bts => bsc	[label="Start Result (Started)"];
+	bts <= bsc	[label="Start Result ACK"];
+
+	bts <= bsc	[label="Operational Info (Operational)"];
+	bts => bsc	[label="Operational Info Accept"];
+}
diff --git a/doc/manuals/om2000/om2k-mo-ts.msc b/doc/manuals/om2000/om2k-mo-ts.msc
new file mode 100644
index 0000000..6557de0
--- /dev/null
+++ b/doc/manuals/om2000/om2k-mo-ts.msc
@@ -0,0 +1,28 @@
+msc {
+	bts [label="BTS"], bsc [label="BSC"];
+	# this is for the Timeslot Object
+	---		[label="Initial state after initializing RX"];
+
+	bts <= bsc	[label="Connect Command"];
+	bts => bsc	[label="Connect Complete"];
+
+	bts <= bsc	[label="Reset Command"];
+	bts => bsc	[label="Reset Complete"];
+
+	bts <= bsc	[label="Start Request"];
+	bts => bsc	[label="Reset Request Accept"];
+	bts => bsc	[label="Start Result (Disabled)"];
+	bts <= bsc	[label="Start Result ACK"];
+
+	bts <= bsc	[label="TS Configuration Request"];
+	bts => bsc	[label="TS Configuration Request Accept"];
+	bts => bsc	[label="TS Configuration Result"];
+	bts <= bsc	[label="TS Configuration Result ACK"];
+
+	bts <= bsc	[label="Enable Request"];
+	bts => bsc	[label="Enable Request Accept"];
+	bts => bsc	[label="Enable Result (Enabled)"];
+	bts <= bsc	[label="Enable Result ACK"];
+
+	# continue with BCCH filling after all TS
+}
diff --git a/doc/manuals/om2000/om2k-mo-tx.msc b/doc/manuals/om2000/om2k-mo-tx.msc
new file mode 100644
index 0000000..f822951
--- /dev/null
+++ b/doc/manuals/om2000/om2k-mo-tx.msc
@@ -0,0 +1,26 @@
+msc {
+	bts [label="BTS"], bsc [label="BSC"];
+	# this is for the TRX Transmitter Object
+	---		[label="Initial state after initializing TRXC"];
+
+	bts <= bsc	[label="Connect Command"];
+	bts => bsc	[label="Connect Complete"];
+
+	bts <= bsc	[label="Reset Command"];
+	bts => bsc	[label="Reset Complete"];
+
+	bts <= bsc	[label="Start Request"];
+	bts => bsc	[label="Reset Request Accept"];
+	bts => bsc	[label="Start Result (Disabled)"];
+	bts <= bsc	[label="Start Result ACK"];
+
+	bts <= bsc	[label="TX Configuration Request"];
+	bts => bsc	[label="TX Configuration Request Accept"];
+	bts => bsc	[label="TX Configuration Result"];
+	bts <= bsc	[label="TX Configuration Result ACK"];
+
+	bts <= bsc	[label="Enable Request"];
+	bts => bsc	[label="Enable Request Accept"];
+	bts => bsc	[label="Enable Result (Enabled)"];
+	bts <= bsc	[label="Enable Result ACK"];
+}
diff --git a/doc/manuals/om2000/om2k-trx.msc b/doc/manuals/om2000/om2k-trx.msc
new file mode 100644
index 0000000..21e61d8
--- /dev/null
+++ b/doc/manuals/om2000/om2k-trx.msc
@@ -0,0 +1,33 @@
+msc {
+	hscale=2;
+	ts [label="TS"], rx [label="RX"], tx [label="TX"], trxc [label="TRXC"], bsc [label="BSC"];
+
+	trxc =>	bsc	[label="Fault Report"];
+
+	trxc <=> bsc	[label="Reset"];
+	trxc <=> bsc	[label="Start"];
+	trxc <=> bsc	[label="Operational Info"];
+
+	---		[label="Do we wait for TF here?"];
+
+	tx <=> bsc	[label="Connect"];
+	tx <=> bsc	[label="Reset"];
+	tx <=> bsc	[label="Start"];
+	tx <=> bsc	[label="Config"];
+	tx <=> bsc	[label="Enable"];
+
+	rx <=> bsc	[label="Connect"];
+	rx <=> bsc	[label="Reset"];
+	rx <=> bsc	[label="Start"];
+	rx <=> bsc	[label="Config"];
+	rx <=> bsc	[label="Enable"];
+
+	ts <=> bsc	[label="Connect"];
+	ts <=> bsc	[label="Reset"];
+	ts <=> bsc	[label="Start"];
+	ts <=> bsc	[label="Config"];
+	ts <=> bsc	[label="Enable"];
+
+	trxc <=> bsc	[label="BCCH INFO"];
+	trxc <=> bsc	[label="Other RSL procedures"];
+}