From patchwork Mon Jul 8 19:17:03 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: "Schilling, Benjamin" X-Patchwork-Id: 13726992 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3811AC3DA41 for ; Mon, 8 Jul 2024 19:17:13 +0000 (UTC) Received: from EUR05-VI1-obe.outbound.protection.outlook.com (EUR05-VI1-obe.outbound.protection.outlook.com [40.107.21.79]) by mx.groups.io with SMTP id smtpd.web11.2155.1720466232086625094 for ; Mon, 08 Jul 2024 12:17:12 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@siemens.com header.s=selector2 header.b=XhxZjNrm; spf=pass (domain: siemens.com, ip: 40.107.21.79, mailfrom: schilling.benjamin@siemens.com) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=F4UNxewSxj13lLEMcWokV26PJ7XDAlspVmOjuIN1D2+OWd42yzrInBH/zS0EchuEwxNifUncXkLEj7FaulA8wl7p2cqtpKD3Q/d6nB5uTqR+t8TirxURSspZM63hBVznT44OkGMmGh7ywB2PfJVQoV1qWo9elMQot4/Tc0VDA/ZrRqX41Ww+rkb4Tj11ujPP1Pvgc8t4VNGg2+ZDuNsYTvOD/T3/54I6gZmHfOVgCX6Ia9hn99CAzTtr4JGXGz8n292MwCpKku/+u61RxRgtkhln+33YdSOJsL2Ay43OmYK4BSout278xukv2U35w3Pp8t6woDUEgVbPEW++IyHRZg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=oD8jDe533WS/9QTnyTWVXMMlUSqWQqZimW/oGCgbWlE=; b=M97D3uQa4e0Qjs8PFUjUsp3n+LFDZ0fQyWM9ijBHOEx/D2qXP2GzPQ1y532r0Z+4M2x+aJeUUvnRBXLVV75BbpFPaNpG01QdVqXdui4KVxiKR8XkgVSTAnDM7td+AKAO0p/YKjctAsTmubD+2ecTOYIwrx/5dz4y3f2TP1Jfdwj3P1IjhGe9Tv3cDhHMg2CHlGn2NWQE9UHWp6N3AnSPNpE+lW6KFDhJs2Uo24p71/P40C52zlaOQn7LFptOPFfRzZm3XbQ5lmXfSkE9QSTpUlXoFboRCCUkCtteH2mth0oKeFc9px9dxSWZzcCX75rUUFTm+JIY5T/FGzfznAPd2A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=siemens.com; dmarc=pass action=none header.from=siemens.com; dkim=pass header.d=siemens.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=siemens.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=oD8jDe533WS/9QTnyTWVXMMlUSqWQqZimW/oGCgbWlE=; b=XhxZjNrmadH5Xq5drP2zT6DTA2h9DLCNWbun2aP+DOruoN7Wm05fHaG6Wm/i+5WaOw8lDhi2TJ9Wix7M70SxCF0FCduMYe6rWfw6cbNRyVGV13JTyy/HTUGPg3/Oy5XToUK3rrHkwBrkUgrjLh/YPHfZeHi2yUW0MGqH5uteX0m9Lt2LSmKzQuvbf7Kn5TSkq77ZZpOOuB0EAmInI0AtiLJ3UZoJVaK58tvakPJsbK3JAQUcgqu9llTUvxSpnfN+xq2vRxFEX3sJxNSyv7fL3qfk1IQNIc0G5+w0hFOAIyPV4rfGUpnc47iHFJmRex3cBJIKE2fYYtETb4Uf4ECnEg== Received: from GVXPR10MB5837.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:150:6d::17) by DB9PR10MB7409.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:10:462::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7741.35; Mon, 8 Jul 2024 19:17:04 +0000 Received: from GVXPR10MB5837.EURPRD10.PROD.OUTLOOK.COM ([fe80::8e3f:ee20:5b20:8a7b]) by GVXPR10MB5837.EURPRD10.PROD.OUTLOOK.COM ([fe80::8e3f:ee20:5b20:8a7b%6]) with mapi id 15.20.7741.033; Mon, 8 Jul 2024 19:17:03 +0000 From: "Schilling, Benjamin" To: "cip-dev@lists.cip-project.org" Subject: [PATCH] README.m-com-x86.md: Add hardware details Thread-Topic: [PATCH] README.m-com-x86.md: Add hardware details Thread-Index: AQHa0WoMtLneHGC5O0mPJoBUkEeQPQ== Date: Mon, 8 Jul 2024 19:17:03 +0000 Message-ID: Accept-Language: de-DE, en-US Content-Language: de-DE X-MS-Has-Attach: X-MS-TNEF-Correlator: msip_labels: MSIP_Label_9d258917-277f-42cd-a3cd-14c4e9ee58bc_Enabled=True;MSIP_Label_9d258917-277f-42cd-a3cd-14c4e9ee58bc_SiteId=38ae3bcd-9579-4fd4-adda-b42e1495d55a;MSIP_Label_9d258917-277f-42cd-a3cd-14c4e9ee58bc_SetDate=2024-07-08T19:07:17.1778584Z;MSIP_Label_9d258917-277f-42cd-a3cd-14c4e9ee58bc_ContentBits=0;MSIP_Label_9d258917-277f-42cd-a3cd-14c4e9ee58bc_Method=Standard authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=siemens.com; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: GVXPR10MB5837:EE_|DB9PR10MB7409:EE_ x-ms-office365-filtering-correlation-id: 6d520350-3b3f-4de3-0b1e-08dc9f828cee x-ms-exchange-atpmessageproperties: SA x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0;ARA:13230040|376014|1800799024|366016|38070700018; x-microsoft-antispam-message-info: =?iso-8859-1?q?ht+Zj07WWxF6cQGkfOw9G4cb8w?= =?iso-8859-1?q?jDWu3owozUt95IqVcAZudnGvvuIx6jV0ddupF774z1+RcJwvKIi8CDP8NaNF?= =?iso-8859-1?q?jhRDL98OsyZl5zgO/7+plj1d2a/+LBCi8GFcjrkvj59eTimX1SnNAbx+Z34W?= =?iso-8859-1?q?kWQVrmHeN9rm2IEc9ZQMN4tanj6nFHUBwOmRzJgg4Lb1SSlzWmzmbw8+5vjP?= =?iso-8859-1?q?HHpoRT17fZ0TfX/qbJEU90Vf2BVTS6VC5LqBz2WhdzJOD7evfLcpABKC1Ywz?= =?iso-8859-1?q?2eU8yeuoMAbFmlYQnv6aerZX6kg+6kaFxV9DTbf13L2ap42P3i3/KosFEDjh?= =?iso-8859-1?q?TGozUftNlMcgBTJk3N7uwiiiZJ6nYzIhdhX+5ARkCVjsXgsKfRj2sWDDnNJq?= =?iso-8859-1?q?RtmIU/ryMlKVndC5bYQgR4er/UIxXNRcu7jtkaOhsxi50nUPwTCLsK1enfNj?= =?iso-8859-1?q?dvIhk/CdaJrvY5souzk/4LqVqyxMTDlyjLz6sXBd3yJzv0WUX2yDWfX+mNuC?= =?iso-8859-1?q?yagQYWg5UZWnkZt5IL+hkcpec/RXAAle2M/iP5mCwAyCkfU//VrJhsiY5dKi?= =?iso-8859-1?q?wvCXB0SQyhRbQzZ0ZBx6enbacvDOtqjpUv4oS6hKbUZjyhcfX/wItvd52Pve?= =?iso-8859-1?q?gXkZ+XHYA9c/sqMjqXePpfVQ8rkqasdCTQYR4SXNvZnlRM5y3Ovzvl08Fk85?= =?iso-8859-1?q?3qgHSJNooHFd97RlXSuQs3XsncX8tBrRirDVlM6NUnX0N763QTXKEyEWxfzP?= =?iso-8859-1?q?xVuP5UzIe9O0ofk0NLCiHbg12IMHOrGZqpsPXbO3Fd5z5SxPcOzkjAY5h7eh?= =?iso-8859-1?q?wWEvZNkvWDQFj32r0gPoYbWnunU7OjZmTMtq+hoOaw9MbpFxUQVFOCZUbyPR?= =?iso-8859-1?q?9FS9meZeZBSZCi1GBiilrVrsHxbS7c0CDB89LX98M+MOneC3JGu1xZkvs4De?= =?iso-8859-1?q?TEMzusldnk17jbbRy47P/0+2RlyhS9hG7566LLwgMWYT2KEPF/BgZ9f8K74G?= =?iso-8859-1?q?rkf+kV8skPXhbeuZNZsSi63HQ62djZSSu/ijRuyuYl52D1c1bGG3BjBnAMoS?= =?iso-8859-1?q?GwfLVvVxZAeO5wbiMumQ43FReNLzEviCnsDWT5g9D1MtS3l9w0J1Hs8l/9Qf?= =?iso-8859-1?q?NkVSMdromgmthb7K8mrPR5SrGP3Od7J8uTeW2HDpC2rTyhfjfbKWre4EJ3Pb?= =?iso-8859-1?q?JIdwO+TnXj/yzBIvl8sIHHxm4EyPhUOz55NET+duCaCPBcAcpSuQ/agPBzmJ?= =?iso-8859-1?q?/+RdAPIEdFa8xUiYDZoKjdUdExJPrM792qZuKlyuaOwcrE8S6qDCr9d2RVJe?= =?iso-8859-1?q?Q0nLdrk/Vr5ZY5fMilyP4BWk6Hm82zSL3qPFxnQrgnhpZ9h0o2fJP5jnrF+V?= =?iso-8859-1?q?GGbFpbNv45LBmWD74AnEtr/rYr1MSNEeqP+ao1pHSmGLHAgIPz3ZTpDFAUcu?= =?iso-8859-1?q?ejGMgc2QH/HwoIQdSp4PtIgg=3D=3D?= x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:GVXPR10MB5837.EURPRD10.PROD.OUTLOOK.COM;PTR:;CAT:NONE;SFS:(13230040)(376014)(1800799024)(366016)(38070700018);DIR:OUT;SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?iso-8859-1?q?T6A1GLKe30W/BqxVMPbABJe?= =?iso-8859-1?q?NctxcWp2B3osgptrpOIoV7EGXfG4QvPetoW3hHNtSVQTrhJo0NnciRzg1Zhq?= =?iso-8859-1?q?a68JV2QyUsoi1vKwGKsHL3gYuRwA3oCHuuXH21oQ2uouRlfcdr0USZxIPiz5?= =?iso-8859-1?q?S3G9zNMpqvUS4NoPdH+Hd5IclmM224r8oj6rdZlRjsh5uiBiZ120OMklZtCK?= =?iso-8859-1?q?ak8pS7tJXXSIBpjebYg/WMvnsZh8CxdDRohuLkhHkmdpF3MirkPn829dwiDl?= =?iso-8859-1?q?cJ0zSRQ2rRpRuvOSfXid3dNoQWlvJMPrnHRkLJkXnQhkuYqEZcGwWhuXcLYC?= =?iso-8859-1?q?bf18QWzoW725QqgsWuD+H4OA/fwnpsJNZTV6tlvW4+u/y7wr0htoo6XUbQXP?= =?iso-8859-1?q?KuZyE+myHb1XIqWjkS8mNf1IPHgzx90T/DZVpUyY1/CMSQG30vMPTWHII07Z?= =?iso-8859-1?q?z7yAFY43EtYnx2G9LhEBTK2iKMvz8MMlzuu4qbnkvKRv5dJkoQl9q/eR/ZSC?= =?iso-8859-1?q?947FLtKW/0Qhe7pHVah0WdmEFzSQedi+yfK5jnL2AUjGsVkWTiTaDeFdEren?= =?iso-8859-1?q?0+uYbBvzvY5ky1uW2B8aApetDxDIA2Ljtg/84sHITXDNs3nFYyCPb4ktaObU?= =?iso-8859-1?q?OD5Udfss19ucfm9h+GUjOh5KRdA7xyt/GPcFeIetNtt5ekuldTTkpKQY/fHB?= =?iso-8859-1?q?VqP68g+6oPDNbzLnztu4vpZlhW0UTuFcAKxNhyMiTVM/RYj+moSB5jhakKML?= =?iso-8859-1?q?NYi3txcw+RTkVA4urbQB3YMG1mAUprRdHPY2072IPHwtr596+JKfL48yx27+?= =?iso-8859-1?q?7oh5NhuQT63DgwDeRwefadsDfaHWb2fBsI9ceDPyuhbSQIL9rcqOosR0EjgD?= =?iso-8859-1?q?kYVn7uFv1RnmWhU0nnwnFxHqo+oUZtd9ErOI8rf0CRU/mYbzEabqed3uG7uC?= =?iso-8859-1?q?/9mjZKWyry3LXJDEVko+5zXRGI3ehBl07iCjVm8MfgWXhVrCKDuaxZok2Mcz?= =?iso-8859-1?q?kZ1WP61KfdQLBktW7PzmMQWyySzCqvbIxlRAMYp9QUySLye94LWnvjDhKi8P?= =?iso-8859-1?q?sDvu8COSgMtY8mYGEuu1lQ3jN1X/D17Wh2Np0Z2HgZLwTfXtxYVbY18qPsLu?= =?iso-8859-1?q?RDLhtWJFTgUZKh0lO8DKbkby8rzw1sfgPeAIwjGGTB9NmZxGABQw33kD1vFG?= =?iso-8859-1?q?dqg3ai53+fFLS5llCZTN0CiibpHQcL8XWb6KWTBAv0ZghwoGOaHsiZcVC8cs?= =?iso-8859-1?q?alrB6JamLZ04xquJrPnHTmC9oh9M5eAiMFHcpjLgaJ807X8o/bcjqtcMA4Ja?= =?iso-8859-1?q?g2XPOq6u7MFNY0+pQ/C5RvWn55V8gQRDvQlhv3jmwr8hBMMI5+QqhjISsBiZ?= =?iso-8859-1?q?YJkG7BZ4ctDWaxo6kqB3bAlzAG+jHiA5h2E6K9qwOltD4H9J2DA0i0xM9vVw?= =?iso-8859-1?q?H+cixMArlNK5qaq4yhFmGAR064fksw4/LY3KPAaSRkfPoTV47UvxX3FBc2J3?= =?iso-8859-1?q?tr3sKDkV9y2c3OoVaFyMSgLk3zIKqnVrpjiPXxEwBc4pkaxTEwp9iN0MMEYz?= =?iso-8859-1?q?XnErmtgX4F/6GBws+ygVe+cH1mq7C1JlUGnmLjSiEqoi5XyBB4i/xa55FG5K?= =?iso-8859-1?q?vX1oWnTaqO3H+Bd9iHucT4mEHYAXfKAiFNeaQEHowODvEvEosOmNfhpb20q0?= =?iso-8859-1?q?=3D?= MIME-Version: 1.0 X-OriginatorOrg: siemens.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: GVXPR10MB5837.EURPRD10.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-Network-Message-Id: 6d520350-3b3f-4de3-0b1e-08dc9f828cee X-MS-Exchange-CrossTenant-originalarrivaltime: 08 Jul 2024 19:17:03.8146 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 38ae3bcd-9579-4fd4-adda-b42e1495d55a X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 2u2MCcpEgbj4BAXD+N74L2NBAR8hy6uYPy0yL2/dVf6KbD1OAom1+PurMCu94hUJKcPgv2Iw7+OyuwAgO2nd4AioSlz4jYw38TePLFbnlT0= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB9PR10MB7409 List-Id: X-Webhook-Received: from li982-79.members.linode.com [45.33.32.79] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 08 Jul 2024 19:17:13 -0000 X-Groupsio-URL: https://lists.cip-project.org/g/cip-dev/message/16437 From 4e6b957569e0a4dd617cc1f4fd716c769681f6dc Mon Sep 17 00:00:00 2001 From: Benjamin Schilling Date: Mon, 8 Jul 2024 21:00:14 +0200 Subject: [PATCH] README.m-com-x86.md: Add hardware details Signed-off-by: Benjamin Schilling --- doc/boards/README.m-com-x86.md | 131 ++++++++++++++++++++++++++++++++- 1 file changed, 130 insertions(+), 1 deletion(-) [ 0.008368] Secure boot enabled ``` + +## Internal interfaces + +The M-COM contains an internal serial port that can be used to access the devices kernel console for debug purposes. + +To access it, the backside of the device has to be unscrewed. +Afterwards it can be connected using a Mini-USB cable. +Make sure to have the appropriate FTDI driver installed. + +## Software Interfaces + +The following chapter describes interfaces accessible from software level. + +### Controlling the watchdogs + +The M-COM RT x86 contains two watchdogs: + +- Custom Hardware Watchdog +- UEFI watchdog of efibootguard + +The UEFI watchdog is controlled via efibootguard variables. +It can be configured for both partition sets using `bg_setenv -p -w `. +To confirm the new watchdog configuration use `bg_setenv -c`. +To disable the watchdog set the timeout to 0. +The watchdog is fed via `/dev/wdog`. + +The custom watchdog is controlled via I2C. +The following scripts can be used to control it. + +Enable watchdog: +```bash +#!/bin/bash + +# i2cset + +# i2cbus = 2 +# chip-address = 0x3c +# data-address = 0x00 (Status Register) +# value = 0x8000 +# mode = w + +# enable watchdog +i2cset -y 2 -m 0x8000 0x3c 0x00 0x8000 w +``` + +Disable watchdog: +```bash +#!/bin/bash + +# i2cset + +# i2cbus = 2 +# chip-address = 0x3c +# data-address = 0x00 (Status Register) +# value = 0x0000 +# mode = w + +# disable watchdog +i2cset -y 2 -m 0x8000 0x3c 0x00 0x0000 w +``` \ No newline at end of file -- 2.45.2 diff --git a/doc/boards/README.m-com-x86.md b/doc/boards/README.m-com-x86.md index cbd74ad..d677b76 100644 --- a/doc/boards/README.m-com-x86.md +++ b/doc/boards/README.m-com-x86.md @@ -1,4 +1,73 @@ -# ISAR CIP Core: Instructions for M-COM RT X86 V1 +ISAR CIP Core: Instructions for the Siemens Mobility GmbH M-COM RT X86 V1 + +## About the M-COM RT X86 V1 + +The M-COM RT X86 V1 is an industrial grade PC. +It is designed to be installed on-board of trains and can be used for communication and processing purposes or as a security gateway. + +## Hardware Specifications + +- Intel Atom E3950 CPU +- 8GB DDR3 DRAM soldered, ECC +- Trusted Platform Module V2.0 +- 3 Gigabit Ethernet ports (M12 X-coded) +- 1 USB 3.0 on front +- -40°C to +70°C, fanless +- EN 50155 compliant (railways) +- 16 GB eMMC storage +- Input voltage range: 24 - 110 V DC EN50155 + +### Power Plug Pinout + +M12 B-coded Plug + +| Column 1 | Column 2 | +| -------- | --------------------------- | +| 24-110V | Edge triggered power on | +| GND | Not connected | + +#### Powering the device + +The device must be connected to a powersupply providing 24V to 110V output voltage at the "+" and "-" pins. +The "switch" pin is used for edge triggered power on. +It can be hardwired to the power supply 24V to 110V to trigger power on of the device. + +### LED Matrix: + +| Column 1 | Column 2 | Column 3 | Column 4 | +| -------------- | -------------- | -------------- | ------------- | +| Power STBY | Power ON | WD-Trigger | Error 1 | +| ETH0 Link/Data | ETH1 Link/Data | ETH2 Link/Data | RS232/RS422 | +| Module1 | Module1 | F1 | M.2 Used/Data | + +Power STBY (Yellow): +- Standby: on +- Powering down: flashing + +Power ON (Green): +- Operation: on +- Powering up: flashing + +WD-Trigger (Yellow): +- Trigger pulses: flashing per pulse + +Error 1 (Red): +- WD-Permanent-Reset: flashing 4 Hz +- WD-Disabled: flashing 2 Hz + +ETHx (Yellow/Green): +- Link: on +- Data transfer: flashing + +Module1 (Yellow/Green): +- Module-specific + +F1 (Yellow): +- Controlled via Software + +M.2 (Green): +- Module installed:on +- Data transfer: flashing ## Build the CIP Core image @@ -100,3 +169,63 @@ After boot, check the dmesg for Secure Boot status like below: root@demo:~# dmesg | grep Secure