Change in osmo-ccid-firmware[master]: add README file

This is merely a historical archive of years 2008-2021, before the migration to mailman3.

A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.

Harald Welte gerrit-no-reply at lists.osmocom.org
Thu Feb 7 16:18:29 UTC 2019


Harald Welte has submitted this change and it was merged. ( https://gerrit.osmocom.org/12859 )

Change subject: add README file
......................................................................

add README file

Change-Id: I9286493e4e2d20f00a33e7b565adde10198f179a
---
A sysmoOCTSIM/README.md
1 file changed, 46 insertions(+), 0 deletions(-)

Approvals:
  Jenkins Builder: Verified
  Harald Welte: Looks good to me, approved



diff --git a/sysmoOCTSIM/README.md b/sysmoOCTSIM/README.md
new file mode 100644
index 0000000..1927255
--- /dev/null
+++ b/sysmoOCTSIM/README.md
@@ -0,0 +1,46 @@
+The sysmocom sysmoOCTSIM is a USB CCID device with eight smart card slots.
+This is the open source firmware for this device.
+
+Hardware
+========
+
+The sysmocom sysmoOCTSIM hardware is proprietary.
+
+It has the following specifications:
+
+- 8 smart cards slots for 2FF cards (e.g. normal SIM format)
+- each slot is driven individually (e.g. they are not multiplexed)
+- each card can be operated in class A (5.0 V), B (3.0 V), or C (1.8 V)
+- the ISO/IEC 7816-4 T=0 communication protocol is used
+- each card can be clock up to 20 MHz (e.g. maximum allowed by the standard)
+
+For more detailed specification refer to the USB description of the device.
+
+Firmware
+========
+
+Compiling
+---------
+
+GNU make and the arm-none-eabi-gcc compiler are required to build the firmware.
+
+The compile the firmware, run the following commands:
+
+```
+cd sysmoOCTSIM/gcc
+make
+```
+
+The `sysmoOCTSIM/gcc/AtmelStart.bin` file is the resulting firmware for the device.
+
+Flashing
+--------
+
+The device comes pre-flash with a USB DFU bootloader (e.g. [osmo-asf4-dfu](https://git.osmocom.org/osmo-asf4-dfu/)).
+To start the USB DFU bootloader, press on the button on the front right of the panel while powering up the device.
+
+Use the [dfu-util](http://dfu-util.sourceforge.net/) utility to flash the firmware onto the device:
+
+```
+dfu-util --device 1d50:6141 --download sysmoOCTSIM/gcc/AtmelStart.bin
+```

-- 
To view, visit https://gerrit.osmocom.org/12859
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings

Gerrit-Project: osmo-ccid-firmware
Gerrit-Branch: master
Gerrit-MessageType: merged
Gerrit-Change-Id: I9286493e4e2d20f00a33e7b565adde10198f179a
Gerrit-Change-Number: 12859
Gerrit-PatchSet: 1
Gerrit-Owner: Kévin Redon <kredon at sysmocom.de>
Gerrit-Reviewer: Harald Welte <laforge at gnumonks.org>
Gerrit-Reviewer: Jenkins Builder (1000002)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osmocom.org/pipermail/gerrit-log/attachments/20190207/aaad299d/attachment.htm>


More information about the gerrit-log mailing list