Elatec TWN4 User Manual

Elatec TWN4 User Manual

Appblaster config cards
Hide thumbs Also See for TWN4:

Advertisement

TWN4
AppBlaster Config Cards User Guide
DocRev6, July 7, 2017
Elatec GmbH

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the TWN4 and is the answer not in the manual?

Questions and answers

Summary of Contents for Elatec TWN4

  • Page 1 TWN4 AppBlaster Config Cards User Guide DocRev6, July 7, 2017 Elatec GmbH...
  • Page 2: Table Of Contents

    TWN4 CONFIG Card ........
  • Page 3: Overview

    1 Overview 1 Overview You received the AppBlaster as part of the developer pack for TWN4, which is distributed as a zip file. AppBlaster is a program, which allows to configure and program TWN4 for a specific application. There are three ways to prepare TWN4 for operation: 1.
  • Page 4: System Requirements

    2 System Requirements 2 System Requirements There are the minimum system requirements for a serious use of the TWN4 Developer Pack: • Operating system: Microsoft Windows XP or later, 32 or 64 bit • Microsoft .NET Framework 3.5 • Processor (CPU): 2 GHz •...
  • Page 5: Installation

    3 Installation 3 Installation You received AppBlaster as part of the developer pack for TWN4, which is distributed as a zip file. In order to install the package, please follow these steps: • Create an empty directory on your hard disk •...
  • Page 6: Starting Appblaster

    4 Starting AppBlaster 4 Starting AppBlaster In order to start AppBlaster, move to base directory of the installed TWN4 development pack and execute program AppBlaster.exe. The start dialog appears: The start dialog offers three choices. In addition, an existing project can be loaded from disk via selection in the menu.
  • Page 7: Programming Firmware Image

    5 Programming Firmware Image If you got a compiled firmware image, there is the possibility to program such files from within AppBlaster into a TWN4 device. In order to do this, click button "Program Firmware Image" in the start dialog. Another dialog opens: Follow these steps: 1.
  • Page 8: Configurable Project

    6 Configurable Project 6 Configurable Project In order to create a configurable project, click button "Configurable Project" in the start dialog. Another dialog appears, the project dialog. This project dialog is separated into several sections, which allow user input and do output from the pro- gram: •...
  • Page 9: Step 1: Add Transponder Types

    6 Configurable Project 6.1 Step 1: Add Transponder Types In your application, one or more types of transponders might be involved. Here is the path through the dialog to add one type of transponder: Following (sub-)steps: 1. Select "Transponder Types" from "Action Items". 2.
  • Page 10: Remove Transponder Types

    6 Configurable Project 6.1.1 Remove Transponder Types If a transponder type was added unintentionally, it can be removed. 1. Select "Transponder Types" from "Action Items". 2. In the list box "Active Transponder Types" select transponder type to be removed. 3. Finally, click button "Remove" to remove the transponder type in question. Page 10 of 33...
  • Page 11: Step 1A: Specify Data Source

    6 Configurable Project 6.2 Step 1a: Specify Data Source The data source specifies the place on a transponder, where data in question is stored. Depending on the type of transponder such storage places are called UID, sector, block, segment, page, file or something similar.
  • Page 12: Step 1B: Specify Bit Manipulation

    6 Configurable Project 6.3 Step 1b: Specify Bit Manipulation 6.4 Step 1c: Specify Output Format Page 12 of 33...
  • Page 13: Step 2: Specify Type Of Usb

    6 Configurable Project 6.5 Step 2: Specify Type of USB TWN4 can be programmed to act as several different type of USB. Select action item "Type of USB (Template)" in order to select appropriate operating mode. 1. Select appropriate template in the list box "Available Templates". Currently, there are six templates available: For TWN4 Core, TWN4 Nano and TWN4 Mini, either USB CDC (virtual COM port) and USB keyboard.
  • Page 14: Step 3: Specify Prefix/Suffix (Optional)

    6 Configurable Project 6.6 Step 3: Specify Prefix/Suffix (Optional) AppBlaster now allows to specify a prefix and/or suffix for the output data. There are several special characters available, which might be helpful for the specific project. By default, there is no prefix sent and "Enter"...
  • Page 15: Step 4: Signalling/Behaviour (Optional)

    6 Configurable Project 6.7 Step 4: Signalling/Behaviour (Optional) During operation of TWN4, there are several types of events, where action can take place. These events • Startup When TWN4 is turned on or performs a reset, the event occurs. • Found Card/Transponder When a transponder enters the RF field of TWN4, the event occurs.
  • Page 16: Step 5: Specify Options (Optional)

    6 Configurable Project 6.8 Step 5: Specify Options (Optional) In this section some special requirements for the application can be set up. Page 16 of 33...
  • Page 17: Step 6: Specify Version Information (Recommended)

    • The name of the firmware image file itself. • Information contained on the label of TWN4. • Version information returned by the application running on TWN4. This is applicable for firmware, which allows request for the firmware version and is achieved via the system function GetVersionString •...
  • Page 18: Step 7: Create Image

    6 Configurable Project 6.10 Step 7: Create Image Before a configuration can be tested, the firmware image must be created. In order to create the firmware image, click button "Create Image". If the project never was saved before, the project will be created in the sub directory "Apps". Otherwise, it will be created, where the project file resides.
  • Page 19: Step 8: Program Image

    6 Configurable Project 6.11 Step 8: Program Image If the firmware image was created successfully it can be programmed into TWN4. In order to program firmware image, click button "Program Image". Page 19 of 33...
  • Page 20: Step 9: Save Project (Recommended)

    6 Configurable Project 6.12 Step 9: Save Project (Recommended) After finishing work, you may save entire information in a project file. Compared to the production image, the project file allows to modify settings of the configuration later, the production image does not. As a suggestion, AppBlaster will choose the name for the project file identical to the name of the production image.
  • Page 21: Source Code Project

    • There is a requirement to change entire behaviour of TWN4. This could be e.g. implementing some kind of host based communication, modifying behaviour of beeper, LEDs or doing input/output via other interfaces of TWN4.
  • Page 22: Step 1: Specify Type Of Usb

    7 Source Code Project 7.1 Step 1: Specify Type of USB TWN4 can be programmed to act as several different type of USB. Select action item "Type of USB (Template)" in order to select appropriate operating mode. 7.2 Step 2: Specify Source Code Module Click button "Select Source"...
  • Page 23: Step 5: Program Image

    7 Source Code Project 7.5 Step 5: Program Image If the firmware image was created successfully it can be programmed into TWN4. In order to program firmware image, click button "Program Image". 7.6 Step 6: Save Project (Recommended) After finishing work, you may save entire information in a project file. Compared to the production image, the project file allows to modify settings of the configuration later, the production image does not.
  • Page 24: Twn4 Config / Configuration Cards

    With AppBlaster V3, a new method is introduced, how TWN4 can be configured: The well-known way is to program a firmware image into TWN4 via host interface. The newly introduced way is to configure TWN4 via the RF interface just by swiping a configuration card. This system is called TWN4 CONFIG.
  • Page 25: Requirements

    • TWN4 must be configured to accept TWN4 CONFIG Cards • A TWN4 CONFIG Card is needed (see description below) • A TWN4 CONFIG Programmer is needed to program a configuration onto a TWN4 CONFIG Card (see description below) • AppBlaster V3 or later...
  • Page 26: Twn4 Config Card

    Notes: • TWN4 CONFIG Cards can be purchased pre-formatted and ready-to-use • In order to store configurations on a TWN4 CONFIG Card, a TWN4 CONFIG Programmer is needed 8.4 TWN4 CONFIG Programmer In order to program a configuration card, a TWN4 CONFIG Programmer is needed. A TWN4 CONFIG Pro- grammer can be purchased separately or as part of a TWN4 CONFIG Kit.
  • Page 27: Creating A Configuration Card

    Creating a configuration card is similar to dealing with a normal project (configurable or source code). The result of a project is an image file which contains the firmware and the App. Instead of programming a image directly into a TWN4, the App section of the image file is programmed onto the configuration card.
  • Page 28: Step 3: Program A Twn4 Config Card

    Image"). As soon as the firmware image is created following dialog appears: The dialog asks the user to now present a configuration card to the TWN4 card programmer. A progress bar illustrates remaining time to follow this request. If no card is presented or the user clicks the button "Cancel", the operation is cancelled.
  • Page 29: Configuring Twn4 With A Configuration Card

    8 TWN4 CONFIG / Configuration Cards 8.6 Configuring TWN4 with a Configuration Card The instructions on how to use a configuration are printed on the card itself: Here are a some more details about this process: 1. Ensure reader is powered on and ready state Comment: The ready state is typically reached immediately after reader was connected to the host or powered on.
  • Page 30: Reading Information From The Card

    8 TWN4 CONFIG / Configuration Cards 8.7 Reading Information from the Card While reading the configuration from a configuration card is only possible by TWN4, there is an addi- tional section on the configuration card, which stores some general information. This information is public accessible and can be read by a click on button "Read Card Info"...
  • Page 31: Creation Of Apps With Make

    • AppBlaster is a solution, which is away from well-known programming environments such as Eclipse. The tools for creation of an App from a command line are part of the TWN4 developer pack. AppBlaster is a graphical user interface (GUI) for the tool chain which resides in the subdirectory .
  • Page 32: Setting Up Appblaster

    files, which are part of the compilation process. • "Connection - Port": Use USB as long as TWN4 is connected via USB to the host (even virtual COM port). If you are using TWN4 RS232, please select appropriate COM port here.
  • Page 33: Disclaimer

    11 Disclaimer 11 Disclaimer Elatec reserves the right to change any information or data in this document without prior notice. The distribution and the update of this document is not controlled. Elatec declines all responsibility for the use of product with any other specifications but the ones mentioned above. Any additional requirement for a specific custom application has to be validated by the customer himself at his own responsibility.

Table of Contents

Save PDF