From patchwork Wed Apr 23 09:53:59 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Taras Kondratiuk X-Patchwork-Id: 28865 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-yh0-f71.google.com (mail-yh0-f71.google.com [209.85.213.71]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id 4753D20534 for ; Wed, 23 Apr 2014 09:55:08 +0000 (UTC) Received: by mail-yh0-f71.google.com with SMTP id a41sf2927209yho.6 for ; Wed, 23 Apr 2014 02:55:08 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:from:to:date:message-id:in-reply-to :references:subject:precedence:list-id:list-unsubscribe:list-archive :list-post:list-help:list-subscribe:mime-version:errors-to:sender :x-original-sender:x-original-authentication-results:mailing-list :content-type:content-transfer-encoding; bh=BEL30FSm8FiIk9Fj8BthyKLG9kQgels+oqrpy4OL6as=; b=hR5iQpeVPKcbI5XeEoFMxq8Y/2hjHVlTVGm91IG+jkJKhFbmA4nQR5z6bI9v1jeKUU IZVi4H8zhf0cO7JXBekkoNjLl1SXPkzEI2ZqWJ1VOYoC2quflkfH0+yqM1wA3jC42Q3Z CpGMQzpLD7xdYATcqZ35ujkTQTFjRQ/kr4/gI4wGcHUVRMM+6+kLl7xV7ilVpQDi9J+4 fjJXNIAH62rMKNOVJK3LYsOlf65l+Fx/WkkcKgkPYrx0hUna4hx9O/R+AATcPaGDCcah N2bSstSoWg5fJCxvV0M7kzKokjnbqnU7v547wIxgNfSBn64nvT5y9QRTm6Y9aFzibuhD vv0Q== X-Gm-Message-State: ALoCoQmfEg85rBrsfjXontsWQK0TYoCMJ+sNbobUHpIX4qBPmYGqr1zVJVqRACiNtdM3YqX2sHAt X-Received: by 10.58.86.39 with SMTP id m7mr25903790vez.26.1398246908533; Wed, 23 Apr 2014 02:55:08 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.140.30.163 with SMTP id d32ls483238qgd.44.gmail; Wed, 23 Apr 2014 02:55:08 -0700 (PDT) X-Received: by 10.221.74.200 with SMTP id yx8mr41177358vcb.3.1398246908365; Wed, 23 Apr 2014 02:55:08 -0700 (PDT) Received: from mail-vc0-f178.google.com (mail-vc0-f178.google.com [209.85.220.178]) by mx.google.com with ESMTPS id sn5si79937vdc.11.2014.04.23.02.55.08 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 23 Apr 2014 02:55:08 -0700 (PDT) Received-SPF: none (google.com: patch+caf_=patchwork-forward=linaro.org@linaro.org does not designate permitted sender hosts) client-ip=209.85.220.178; Received: by mail-vc0-f178.google.com with SMTP id hu19so880441vcb.9 for ; Wed, 23 Apr 2014 02:55:08 -0700 (PDT) X-Received: by 10.52.123.39 with SMTP id lx7mr34603145vdb.22.1398246908192; Wed, 23 Apr 2014 02:55:08 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.220.221.72 with SMTP id ib8csp90731vcb; Wed, 23 Apr 2014 02:55:07 -0700 (PDT) X-Received: by 10.140.83.232 with SMTP id j95mr58437941qgd.42.1398246907812; Wed, 23 Apr 2014 02:55:07 -0700 (PDT) Received: from ip-10-141-164-156.ec2.internal (lists.linaro.org. [54.225.227.206]) by mx.google.com with ESMTPS id u12si180361qge.194.2014.04.23.02.55.07 for (version=TLSv1 cipher=RC4-SHA bits=128/128); Wed, 23 Apr 2014 02:55:07 -0700 (PDT) Received-SPF: none (google.com: lng-odp-bounces@lists.linaro.org does not designate permitted sender hosts) client-ip=54.225.227.206; Received: from localhost ([127.0.0.1] helo=ip-10-141-164-156.ec2.internal) by ip-10-141-164-156.ec2.internal with esmtp (Exim 4.76) (envelope-from ) id 1Wctt8-0005Bx-88; Wed, 23 Apr 2014 09:54:46 +0000 Received: from mail-ee0-f54.google.com ([74.125.83.54]) by ip-10-141-164-156.ec2.internal with esmtp (Exim 4.76) (envelope-from ) id 1WctsX-00058S-GA for lng-odp@lists.linaro.org; Wed, 23 Apr 2014 09:54:09 +0000 Received: by mail-ee0-f54.google.com with SMTP id d49so568912eek.27 for ; Wed, 23 Apr 2014 02:54:24 -0700 (PDT) X-Received: by 10.14.22.69 with SMTP id s45mr61631126ees.56.1398246864364; Wed, 23 Apr 2014 02:54:24 -0700 (PDT) Received: from uglx0153363.synapse.com ([195.238.92.128]) by mx.google.com with ESMTPSA id o4sm4757906eef.20.2014.04.23.02.54.22 for (version=TLSv1.1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Wed, 23 Apr 2014 02:54:23 -0700 (PDT) From: Taras Kondratiuk To: lng-odp@lists.linaro.org Date: Wed, 23 Apr 2014 12:53:59 +0300 Message-Id: <1398246839-15554-10-git-send-email-taras.kondratiuk@linaro.org> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1398246839-15554-1-git-send-email-taras.kondratiuk@linaro.org> References: <1398246839-15554-1-git-send-email-taras.kondratiuk@linaro.org> Subject: [lng-odp] [PATCH v3 9/9] Keystone2: Add README file X-BeenThere: lng-odp@lists.linaro.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: , List-Help: , List-Subscribe: , MIME-Version: 1.0 Errors-To: lng-odp-bounces@lists.linaro.org Sender: lng-odp-bounces@lists.linaro.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: taras.kondratiuk@linaro.org X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: patch+caf_=patchwork-forward=linaro.org@linaro.org does not designate permitted sender hosts) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 Signed-off-by: Taras Kondratiuk --- platform/linux-keystone2/README | 41 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 platform/linux-keystone2/README diff --git a/platform/linux-keystone2/README b/platform/linux-keystone2/README new file mode 100644 index 0000000..01b61e2 --- /dev/null +++ b/platform/linux-keystone2/README @@ -0,0 +1,41 @@ +1. Intro + +OpenDataPlane implementation for TI Keystone2 SoC's. Current version supports +HW buffer, queues and Packet IO management. This drop does not target high +performance. It is rather proof of ODP API functionality. It still uses +linux-generic's SW scheduler. + +2. Prerequisites + + 2.1 Linux kernel + +Sources: git://git.ti.com/keystone-linux/linux.git master +config: keystone2_defconfig +DTB: k2hk-evm.dtb + +Current implementation relies on kernel to enable and configure network +interfaces. Implementation does not support Packet and Security accelerators +now so they should be disable in kernel config: + +# CONFIG_TI_KEYSTONE_NET_SA is not set +# CONFIG_TI_KEYSTONE_QOS is not set +# CONFIG_TI_KEYSTONE_PA is not set + + 2.2 OpenEM libs and kernel module + +Keystone ODP uses OpenEM libraries as low level drivers. +Before any ODP application started an OpenEM kernel module (em_mod.ko) +should be inserted. + +Sources: git://git.linaro.org/people/taras.kondratiuk/keystone2-odp/openem.git for_odp +Check README file in OpenEM root directory for build instructions. + +3. Keystone2 ODP build + +Keystone implementation uses partial linking (ld -r) to link external +static libraries into libodp. During partial linking ld searches for libraries +only in path specified explicitly (via -L), but not in standard paths. I'm not +sure whether it is gcc bug or feature, but until fix is found a path should be +passed explicitly. If helper libraries installed into /usr/lib, then: + +make PLATFORM=linux-keystone2 LD='ld -L/usr/lib'