laforge has submitted this change. ( https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26948 )
Change subject: icE1usb doc: Link to wiki page about iso USB issues
......................................................................
icE1usb doc: Link to wiki page about iso USB issues
Change-Id: Id5f555519d5e320570017178613c752591db4a2f
---
M doc/manuals/chapters/firmware.adoc
1 file changed, 2 insertions(+), 1 deletion(-)
Approvals:
laforge: Looks good to me, approved
Jenkins Builder: Verified
diff --git a/doc/manuals/chapters/firmware.adoc b/doc/manuals/chapters/firmware.adoc
index 1b440bd..5ae5fb1 100644
--- a/doc/manuals/chapters/firmware.adoc
+++ b/doc/manuals/chapters/firmware.adoc
@@ -185,7 +185,8 @@
activation of both icE1usb ports simultaneously. The XHCI controller
firmware erroneously claims that there is insufficient bus bandwidth.
However, the same icE1usb hardware/firmware works perfectly fine with
-OHCI, UHCI and EHCI host controllers.
+OHCI, UHCI and EHCI host controllers. See
+https://osmocom.org/projects/e1-t1-adapter/wiki/Isochronous_USB_Issues for a user-maintained list of USB hosts / controllers and whether or not they work with two E1 ports.
As most modern [PC] hardware has XHCI host controllers, you need to
choose your hardware carefully if concurrent operation of both icE1usb
--
To view, visit https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26948
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-e1-hardware
Gerrit-Branch: master
Gerrit-Change-Id: Id5f555519d5e320570017178613c752591db4a2f
Gerrit-Change-Number: 26948
Gerrit-PatchSet: 2
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: merged
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26949 )
Change subject: icE1usb doc: Add pictures of front and back side
......................................................................
Patch Set 1: Code-Review+2
--
To view, visit https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26949
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-e1-hardware
Gerrit-Branch: master
Gerrit-Change-Id: Ifc382c762119b397dd9a6b484ebc9a237897fba9
Gerrit-Change-Number: 26949
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-Comment-Date: Tue, 18 Jan 2022 20:22:54 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26948 )
Change subject: icE1usb doc: Link to wiki page about iso USB issues
......................................................................
Patch Set 1: Code-Review+2
--
To view, visit https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26948
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-e1-hardware
Gerrit-Branch: master
Gerrit-Change-Id: Id5f555519d5e320570017178613c752591db4a2f
Gerrit-Change-Number: 26948
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-Comment-Date: Tue, 18 Jan 2022 19:58:23 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26949 )
Change subject: icE1usb doc: Add pictures of front and back side
......................................................................
icE1usb doc: Add pictures of front and back side
Closes: OS#5406
Change-Id: Ifc382c762119b397dd9a6b484ebc9a237897fba9
---
M doc/manuals/chapters/hardware.adoc
A doc/manuals/images/icE1usb-e1_side.jpg
A doc/manuals/images/icE1usb-usb_side.jpg
3 files changed, 19 insertions(+), 1 deletion(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-e1-hardware refs/changes/49/26949/1
diff --git a/doc/manuals/chapters/hardware.adoc b/doc/manuals/chapters/hardware.adoc
index 8055e64..0e129c2 100644
--- a/doc/manuals/chapters/hardware.adoc
+++ b/doc/manuals/chapters/hardware.adoc
@@ -19,7 +19,14 @@
PDF rendered schematics are available at https://git.osmocom.org/osmo-e1-hardware/plain/hardware/icE1usb/r1.0/icE1us…
-=== Connectors
+=== Connectors on E1 side
+
+image::images/icE1usb-e1_side.jpg[width=400,title="E1 side of icE1usb"]
+
+From left to right, there are the following connectors:
+
+* X5A: Primary E1 Port
+* X5B: Secondary E1 Port
==== X5A and X5B: E1 Interface Connectors
@@ -57,6 +64,17 @@
different pin-out. Particularly, you cannot use an Ethernet cross-over
cable as an E1 cross-over!
+=== Connectors on USB side
+
+image::images/icE1usb-usb_side.jpg[width=400,title="USB side of icE1usb"]
+
+From left to right, there are the following connectors:
+
+* X1: GPS Antenna Connector
+* X2: Serial Console Connector
+* X4: USB Connector
+* X3: GPIO / Extension Connector
+
==== X4: USB Connector
The USB connector is a USB Type C connector. However, it only carries
diff --git a/doc/manuals/images/icE1usb-e1_side.jpg b/doc/manuals/images/icE1usb-e1_side.jpg
new file mode 100644
index 0000000..5bd274d
--- /dev/null
+++ b/doc/manuals/images/icE1usb-e1_side.jpg
Binary files differ
diff --git a/doc/manuals/images/icE1usb-usb_side.jpg b/doc/manuals/images/icE1usb-usb_side.jpg
new file mode 100644
index 0000000..5d833d6
--- /dev/null
+++ b/doc/manuals/images/icE1usb-usb_side.jpg
Binary files differ
--
To view, visit https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26949
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-e1-hardware
Gerrit-Branch: master
Gerrit-Change-Id: Ifc382c762119b397dd9a6b484ebc9a237897fba9
Gerrit-Change-Number: 26949
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26948 )
Change subject: icE1usb doc: Link to wiki page about iso USB issues
......................................................................
icE1usb doc: Link to wiki page about iso USB issues
Change-Id: Id5f555519d5e320570017178613c752591db4a2f
---
M doc/manuals/chapters/firmware.adoc
1 file changed, 2 insertions(+), 1 deletion(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-e1-hardware refs/changes/48/26948/1
diff --git a/doc/manuals/chapters/firmware.adoc b/doc/manuals/chapters/firmware.adoc
index 1b440bd..5ae5fb1 100644
--- a/doc/manuals/chapters/firmware.adoc
+++ b/doc/manuals/chapters/firmware.adoc
@@ -185,7 +185,8 @@
activation of both icE1usb ports simultaneously. The XHCI controller
firmware erroneously claims that there is insufficient bus bandwidth.
However, the same icE1usb hardware/firmware works perfectly fine with
-OHCI, UHCI and EHCI host controllers.
+OHCI, UHCI and EHCI host controllers. See
+https://osmocom.org/projects/e1-t1-adapter/wiki/Isochronous_USB_Issues for a user-maintained list of USB hosts / controllers and whether or not they work with two E1 ports.
As most modern [PC] hardware has XHCI host controllers, you need to
choose your hardware carefully if concurrent operation of both icE1usb
--
To view, visit https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26948
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-e1-hardware
Gerrit-Branch: master
Gerrit-Change-Id: Id5f555519d5e320570017178613c752591db4a2f
Gerrit-Change-Number: 26948
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
Attention is currently required from: dexter.
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/libosmocore/+/16355 )
Change subject: osmo_fsm: Ensure all state and event names are valid identifiers
......................................................................
Patch Set 7:
(1 comment)
File src/fsm.c:
https://gerrit.osmocom.org/c/libosmocore/+/16355/comment/1f3d90b6_861c25bb
PS7, Line 296: "state name '%s'\n", states[i].name);
> I think this is problematic. osmo_fsm_register() may be called before the log is set up. […]
I think we should rather make sure that our logging subsystem does something useful (and not assert) if log output is generated before the log subsystem configuration is initialized. This has been hurting us over and over again.
--
To view, visit https://gerrit.osmocom.org/c/libosmocore/+/16355
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmocore
Gerrit-Branch: master
Gerrit-Change-Id: If98587eff3c48a66ed2e5cc1f01a12accab5a3e7
Gerrit-Change-Number: 16355
Gerrit-PatchSet: 7
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: pespin <pespin(a)sysmocom.de>
Gerrit-CC: dexter <pmaier(a)sysmocom.de>
Gerrit-Attention: dexter <pmaier(a)sysmocom.de>
Gerrit-Comment-Date: Tue, 18 Jan 2022 14:55:30 +0000
Gerrit-HasComments: Yes
Gerrit-Has-Labels: No
Comment-In-Reply-To: dexter <pmaier(a)sysmocom.de>
Gerrit-MessageType: comment
Attention is currently required from: laforge.
dexter has posted comments on this change. ( https://gerrit.osmocom.org/c/libosmocore/+/16355 )
Change subject: osmo_fsm: Ensure all state and event names are valid identifiers
......................................................................
Patch Set 7:
(2 comments)
Patchset:
PS7:
I think this is a good idea, but there are indeed a lot of applications that have problems. Especially event names like XXXX.ind or XXXX.req are used quite often. I would suggest to replace the dot with a '-'.
File src/fsm.c:
https://gerrit.osmocom.org/c/libosmocore/+/16355/comment/61fc3595_0879039d
PS7, Line 296: "state name '%s'\n", states[i].name);
I think this is problematic. osmo_fsm_register() may be called before the log is set up. Maybe we should consider using printf here?
--
To view, visit https://gerrit.osmocom.org/c/libosmocore/+/16355
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmocore
Gerrit-Branch: master
Gerrit-Change-Id: If98587eff3c48a66ed2e5cc1f01a12accab5a3e7
Gerrit-Change-Number: 16355
Gerrit-PatchSet: 7
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: pespin <pespin(a)sysmocom.de>
Gerrit-CC: dexter <pmaier(a)sysmocom.de>
Gerrit-Attention: laforge <laforge(a)osmocom.org>
Gerrit-Comment-Date: Tue, 18 Jan 2022 11:21:47 +0000
Gerrit-HasComments: Yes
Gerrit-Has-Labels: No
Gerrit-MessageType: comment
dexter has uploaded this change for review. ( https://gerrit.osmocom.org/c/libosmocore/+/26919 )
Change subject: gsm23003: fix docstring for osmo_plmn_from_bcd()
......................................................................
gsm23003: fix docstring for osmo_plmn_from_bcd()
The parameters described in the docstrings for osmo_plmn_from_bcd() do not match the actual parameter list.
Change-Id: Ic0999dbe096a98418db7482bd110e20497d8e4a5
---
M src/gsm/gsm23003.c
1 file changed, 5 insertions(+), 7 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/libosmocore refs/changes/19/26919/1
diff --git a/src/gsm/gsm23003.c b/src/gsm/gsm23003.c
index 71d44fb..b893873 100644
--- a/src/gsm/gsm23003.c
+++ b/src/gsm/gsm23003.c
@@ -445,14 +445,12 @@
}
}
-/* Convert given 3-byte BCD buffer to integers and write results to *mcc and
- * *mnc. The first three BCD digits result in the MCC and the remaining ones in
- * the MNC. Return mnc_3_digits as false if the MNC's most significant digit is encoded as 0xF, true
- * otherwise; i.e. true if MNC > 99 or if it is represented with leading zeros instead of 0xF.
+/* Convert given 3-byte BCD buffer to integers and write results to plmn->mcc and plmn->mnc. The first three BCD digits
+ * result in the MCC and the remaining ones in the MNC. Set plmn->mnc_3_digits as false if the MNC's most significant
+ * digit is encoded as 0xF, true otherwise; i.e. true if MNC > 99 or if it is represented with leading zeros instead of
+ * 0xF.
* \param[in] bcd_src 3-byte BCD buffer containing MCC+MNC representations.
- * \param[out] mcc MCC result buffer, or NULL.
- * \param[out] mnc MNC result buffer, or NULL.
- * \param[out] mnc_3_digits Result buffer for 3-digit flag, or NULL.
+ * \param[out] plmn user provided memory to store the result.
*/
void osmo_plmn_from_bcd(const uint8_t *bcd_src, struct osmo_plmn_id *plmn)
{
--
To view, visit https://gerrit.osmocom.org/c/libosmocore/+/26919
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: libosmocore
Gerrit-Branch: master
Gerrit-Change-Id: Ic0999dbe096a98418db7482bd110e20497d8e4a5
Gerrit-Change-Number: 26919
Gerrit-PatchSet: 1
Gerrit-Owner: dexter <pmaier(a)sysmocom.de>
Gerrit-MessageType: newchange
Attention is currently required from: osmith.
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-ci/+/26944 )
Change subject: Revert "remove linter jobs for osmo-e1d and osmo-e1-firmware"
......................................................................
Patch Set 1: Code-Review+2
--
To view, visit https://gerrit.osmocom.org/c/osmo-ci/+/26944
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-ci
Gerrit-Branch: master
Gerrit-Change-Id: Ib79a20658bfae64d9b718e53e6a9393708a4e694
Gerrit-Change-Number: 26944
Gerrit-PatchSet: 1
Gerrit-Owner: osmith <osmith(a)sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-Attention: osmith <osmith(a)sysmocom.de>
Gerrit-Comment-Date: Tue, 18 Jan 2022 09:07:25 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
Attention is currently required from: osmith.
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/osmo-e1-recorder/+/26946 )
Change subject: checkpatch.conf: new file
......................................................................
Patch Set 1: Code-Review-2
(1 comment)
Patchset:
PS1:
this was actually an error on my side. osmo-e1-recorder is a normal osmocom project with no exceptions.
--
To view, visit https://gerrit.osmocom.org/c/osmo-e1-recorder/+/26946
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-e1-recorder
Gerrit-Branch: master
Gerrit-Change-Id: I8b6f5f0b1dd980003a4ae2feaee78fc62debbc9c
Gerrit-Change-Number: 26946
Gerrit-PatchSet: 1
Gerrit-Owner: osmith <osmith(a)sysmocom.de>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-Attention: osmith <osmith(a)sysmocom.de>
Gerrit-Comment-Date: Tue, 18 Jan 2022 09:06:48 +0000
Gerrit-HasComments: Yes
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
osmith has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26927 )
Change subject: checkpatch.conf: new file
......................................................................
checkpatch.conf: new file
Disable spacing and open brace checks, as this repository follows a
different code style.
If needed, the checkpatch file can be extended with other checks:
* get the check name from the linter output, e.g. SPACING in:
firmware/ice40-riscv/icE1usb/fw_app.c:155: ERROR:SPACING: spaces required around that '=' (ctx:VxV)
* add a new "--ignore NAME" line to the file
Related: https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26841
Related: OS#5399
Change-Id: I4d2cf2eb698b8f4e54f04e62e4dbbc37146daf88
---
A .checkpatch.conf
1 file changed, 2 insertions(+), 0 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-e1-hardware refs/changes/27/26927/1
diff --git a/.checkpatch.conf b/.checkpatch.conf
new file mode 100644
index 0000000..20c0832
--- /dev/null
+++ b/.checkpatch.conf
@@ -0,0 +1,2 @@
+--ignore OPEN_BRACE
+--ignore SPACING
--
To view, visit https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26927
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-e1-hardware
Gerrit-Branch: master
Gerrit-Change-Id: I4d2cf2eb698b8f4e54f04e62e4dbbc37146daf88
Gerrit-Change-Number: 26927
Gerrit-PatchSet: 1
Gerrit-Owner: osmith <osmith(a)sysmocom.de>
Gerrit-MessageType: newchange
laforge has posted comments on this change. ( https://gerrit.osmocom.org/c/docker-playground/+/26942 )
Change subject: gerrit: upgrade to 3.3.9 based container
......................................................................
Patch Set 1: Verified+1 Code-Review+2
--
To view, visit https://gerrit.osmocom.org/c/docker-playground/+/26942
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: docker-playground
Gerrit-Branch: master
Gerrit-Change-Id: Iabb36f0754773dc2e8a5be7d44979b85034e2d01
Gerrit-Change-Number: 26942
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-Comment-Date: Mon, 17 Jan 2022 17:27:51 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: Yes
Gerrit-MessageType: comment
laforge has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26926 )
Change subject: icE1usb: update manual to reflect firmware 0.2 (GPS-DO, 2 ports)
......................................................................
icE1usb: update manual to reflect firmware 0.2 (GPS-DO, 2 ports)
Change-Id: I9dac5b9479af37270dc13e334a278f91f260c7ce
---
M doc/manuals/chapters/firmware.adoc
M doc/manuals/chapters/hardware.adoc
M doc/manuals/chapters/host-software.adoc
M doc/manuals/icE1usb-usermanual-docinfo.xml
4 files changed, 93 insertions(+), 7 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmo-e1-hardware refs/changes/26/26926/1
diff --git a/doc/manuals/chapters/firmware.adoc b/doc/manuals/chapters/firmware.adoc
index 12c5710..1b440bd 100644
--- a/doc/manuals/chapters/firmware.adoc
+++ b/doc/manuals/chapters/firmware.adoc
@@ -145,3 +145,70 @@
=== Use of the Multi-Color RGB LED
FIXME: describe how it is used.
+
+
+=== Firmware <-> USB Host Interface
+
+The icE1usb firmware provides a USB 1.1 full-speed (FS) device with
+
+* one configuration
+* 5 interfaces
+** E1 port 0
+** E1 port 1
+** CDC-ACM (control + data)
+** DFU (device firmware upgrade)
+
+The interfaces have self-explanatory string descriptors like
+
+----
+ iInterface 6 E1 port 0
+ iInterface 8 E1 port 1
+ iInterface 9 GPS (CDC control)
+ iInterface 10 GPS (CDC data)
+ iInterface 11 DFU runtime
+----
+
+==== E1 ports
+
+There are two physical E1 ports in the icE1usb. Each is exposed via its own USB _interface_.
+
+Each port (USB _interface_) contains two _altsettings_:
+
+* one altsetting with no data endpoints (E1 disabled, this is the default)
+* one altsetting with isochronous IN/OUT endpoints (E1 enabled)
+
+In order to activate one E1 port, the driver must perform a USB standard
+request to activate the _enabled_ altsetting.
+
+NOTE:: Please note that on many XHCI host controllers there seem to be
+implementation flaws in the XHCI host controller firmware preventing the
+activation of both icE1usb ports simultaneously. The XHCI controller
+firmware erroneously claims that there is insufficient bus bandwidth.
+However, the same icE1usb hardware/firmware works perfectly fine with
+OHCI, UHCI and EHCI host controllers.
+
+As most modern [PC] hardware has XHCI host controllers, you need to
+choose your hardware carefully if concurrent operation of both icE1usb
+ports is required in your application.
+
+==== CDC-ACM with GPS NMEA
+
+There's a CDC-ACM (virtual com port) interface available in the icE1usb.
+This will be supported by the standard `cdc_acm` driver of your
+operating system, and will expose a `/dev/ttyACMx` device on Linux.
+
+The port provides read-only access to the GPS receiver on-board the
+icE1usb. You can use this to
+
+* determine the GPS fix (and hence 1PPS frequency reference)
+ availability
+* obtain the GPS position of the device
+
+NOTE:: Write access to the GPS receiver is not permitted as the icE1usb
+firmware needs to control the GPS receiver for frequency reference
+purposes.
+
+==== DFU (Device Firmware Upgrade)
+
+There's a DFU interface available in order to update the icE1usb
+gateware and firmware. For more information, see [[firmware]] above.
diff --git a/doc/manuals/chapters/hardware.adoc b/doc/manuals/chapters/hardware.adoc
index 4b2f694..8055e64 100644
--- a/doc/manuals/chapters/hardware.adoc
+++ b/doc/manuals/chapters/hardware.adoc
@@ -7,8 +7,8 @@
It's main building blocks are:
* an iCE40 FPGA
-* Two E1 line interface (transformers, biasing networks and ESD protection) footnote:[Only one E1 line supported by firmware so far]
-* a GPS receiver module with 1PPS output to the FPGA footnote:[GPS-DO supported by firmware yet]
+* Two E1 line interface (transformers, biasing networks and ESD protection) footnote:[Second interface requires firmware >= 0.2 and OHCI/OHCI/EHCI host controller]
+* a GPS receiver module with 1PPS output to the FPGA footnote:[Requires firmware >= 0.2]
=== Schematics
diff --git a/doc/manuals/chapters/host-software.adoc b/doc/manuals/chapters/host-software.adoc
index 356c897..4c8578e 100644
--- a/doc/manuals/chapters/host-software.adoc
+++ b/doc/manuals/chapters/host-software.adoc
@@ -3,13 +3,19 @@
Host Software is software running on the USB host computer to which the
icE1usb is attached.
-At the time of this writing, the only software implementing icE1usb
-support is `osmo-e1d`.
+At the time of this writing, there are two options for icE1usb driver interfaces:
+`osmo-e1d` and `DAHDI`.
=== `osmo-e1d`
-`osmo-e1d` utilizes `libusb` to talk to the icE1usb hardware and offers
-a unix domain socket based interface to application software.
+`osmo-e1d` is a pure user-space driver, not requiring any specific Linux kernel,
+kernel patches or out-of-tree kernel modules. It utilizes `libusb` to
+talk to the icE1usb hardware and offers a unix domain socket based
+interface to application software.
+
+In theory, `osmo-e1d` should work on any operating system with libusb
+support for isochronous transfers. However, official support is limited
+to GNU/Linux at this point.
Software such as `osmo-bsc` and `osmo-mgw` can interface `osmo-e1d` via
the `libosmo-abis` support for `osmo-e1d`.
@@ -23,6 +29,11 @@
popular driver for a variety of POTS/PSTN and also TDM interface boards
by originally Zaptel, later Digium and now most recently Sangoma.
+DAHDI is available only for Linux, and is provided as source code for a
+set of out-of-tree kernel modules. You must compile those modules for
+each specific Linux kernel version you are using. Keep this in mind
+when performing kernel upgrades and the like.
+
DAHDI is supported by a wide range of open source PBX / softswitch software,
including Asterisk, FreeSWITCH and yate.
diff --git a/doc/manuals/icE1usb-usermanual-docinfo.xml b/doc/manuals/icE1usb-usermanual-docinfo.xml
index 1c7e7fd..246e014 100644
--- a/doc/manuals/icE1usb-usermanual-docinfo.xml
+++ b/doc/manuals/icE1usb-usermanual-docinfo.xml
@@ -1,5 +1,13 @@
<revhistory>
<revision>
+ <revnumber>2</revnumber>
+ <date>January 17, 2022</date>
+ <authorinitials>HW</authorinitials>
+ <revremark>
+ Update documentation to firmware 0.2 (GPS-DO, second E1 port)
+ </revremark>
+ </revision>
+ <revision>
<revnumber>1</revnumber>
<date>December 13, 2020</date>
<authorinitials>HW</authorinitials>
@@ -24,7 +32,7 @@
</authorgroup>
<copyright>
- <year>2020</year>
+ <year>2020-2022</year>
<holder>sysmocom - s.f.m.c. GmbH</holder>
</copyright>
--
To view, visit https://gerrit.osmocom.org/c/osmo-e1-hardware/+/26926
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmo-e1-hardware
Gerrit-Branch: master
Gerrit-Change-Id: I9dac5b9479af37270dc13e334a278f91f260c7ce
Gerrit-Change-Number: 26926
Gerrit-PatchSet: 1
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-MessageType: newchange
osmith has posted comments on this change. ( https://gerrit.osmocom.org/c/docker-playground/+/20622 )
Change subject: ttcn3-bts-test: use osmo-config-merge to generate config files
......................................................................
Patch Set 6:
> having stale configs downloaded.
what I mean:
* the config gets downloaded once on a developer's machine
* the config changes in osmo-ttcn3-hacks
* now the config does not get downloaded again, since the file already exists
* tests will start failing, developer needs to figure out why
--
To view, visit https://gerrit.osmocom.org/c/docker-playground/+/20622
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: docker-playground
Gerrit-Branch: master
Gerrit-Change-Id: If15461240f3037c142c176fc7da745a1701ae3f8
Gerrit-Change-Number: 20622
Gerrit-PatchSet: 6
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Assignee: fixeria <vyanitskiy(a)sysmocom.de>
Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de>
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: osmith <osmith(a)sysmocom.de>
Gerrit-Reviewer: pespin <pespin(a)sysmocom.de>
Gerrit-Comment-Date: Mon, 17 Jan 2022 10:29:04 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: No
Gerrit-MessageType: comment
osmith has posted comments on this change. ( https://gerrit.osmocom.org/c/docker-playground/+/20622 )
Change subject: ttcn3-bts-test: use osmo-config-merge to generate config files
......................................................................
Patch Set 6:
Should this be marked as WIP? In OS#5377 fixeria wrote: "the configuration file is still not understood correctly"
Regarding the patch, I would try to avoid downloading the files with wget, and rather run the config merge inside docker, where the config files are available in the checked out osmo-ttcn3-hacks.git. Then we would avoid the problem of having stale configs downloaded.
But not sure if it's worth investing time to refactor it at this point, the solution from this patch should work well enough.
--
To view, visit https://gerrit.osmocom.org/c/docker-playground/+/20622
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: docker-playground
Gerrit-Branch: master
Gerrit-Change-Id: If15461240f3037c142c176fc7da745a1701ae3f8
Gerrit-Change-Number: 20622
Gerrit-PatchSet: 6
Gerrit-Owner: laforge <laforge(a)osmocom.org>
Gerrit-Assignee: fixeria <vyanitskiy(a)sysmocom.de>
Gerrit-Reviewer: fixeria <vyanitskiy(a)sysmocom.de>
Gerrit-Reviewer: laforge <laforge(a)osmocom.org>
Gerrit-Reviewer: osmith <osmith(a)sysmocom.de>
Gerrit-Reviewer: pespin <pespin(a)sysmocom.de>
Gerrit-Comment-Date: Mon, 17 Jan 2022 10:27:13 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: No
Gerrit-MessageType: comment