TWIMO SDK Software Development Kit User s guide
Table des matières / Table of contents Introduction - Français 4 1. Support matériel 4 1.1. Alimentation 4 1.2. Accès au module TWIMO 4 1.3. Sélection mode de fonctionnement 5 1.4. Reset 5 1.5. Connecteur Antenne 5 1.6. Liaison RS232 5 1.7. Mise au point du firmware du module 5 1.8. Schéma SDK 5 2. Quick Start 6 3. Firmware Bootloading 7 4. Annexes 10 Introduction - English 13 1. Equipment description 13 1.1. Power supply 13 1.2. TWIMO module access 13 1.3. Operating mode selection 14 1.4. Reset 14 1.5. Antenna connector 14 1.6. RS232 Link 14 1.7. Development of the module s firmware 14 1.8. SDK schematic 14 2. Quick Start 15 3. Firmware Bootloading 16 4. Appendixes 19
FR FRANCAIS 3
Introduction - Français L objet de ce document est de décrire le support matériel utilisé pour le développement d application logiciel sur base matériel TWIMO. FR 1. Support matériel Zone à wrapper avec ligne Vcc et ligne GND Connecteur sonde debug Reset hard Jumper Module TWIMO Connecteur antenne SMA Boutons Poussoirs LEDs Switchs Alimentation SDK Switch de sélection du mode de fonctionnement Accès RS232 Accès aux I/Os du module TWIMO Zone à wrapper avec ligne Vcc et ligne GND 1.1. Alimentation L Alimentation du SDK se fait sous 3.5V afin d obtenir une tension de 3.3 v (tension nominale de fonctionnement du module TWIMO) aux bornes du module. L alimentation peut se faire soit à travers les cosses ou bien le bornier. Le Jumper permet de réaliser une mesure de la consommation du module TWIMO en y insérant un ampèremètre en série. 1.2. Accès au module TWIMO Les pastilles de part et d autre du module permettent d accéder aux I/O du module. Un set de boutons poussoirs, de switch interrupteur et de LED est a disposition afin de permettre au développeur de simuler des actions externes, d effectuer du debug etc. 4
1.3. Sélection mode de fonctionnement Le Switch de sélection du mode de fonctionnement permet de choisir entre le mode «normal» (position OFF du Switch) qui correspond au mode de mise au point du firmware à partir de la sonde de debug et le mode «bootload» (position ON du Switch) qui correspond au mode dans lequel l utilisateur peut venir flasher un binaire a travers la liaison série (cf. chapitre 3). Ce switch est directement connecté à la pin 9 du module (pin BOOT). FR 1.4. Reset La touche Reset est directement connectée à la pin 7 du module (pin RESET). 1.5. Connecteur Antenne Un connecteur antenne SMA est présent sur la carte afin de permettre a un utilisateur de connecter une antenne. 1.6. Liaison RS232 Le connecteur DB9 (couplé à un driver de ligne Maxim présent sur la carte) permet d interfacer le module avec un PC ou tout autre dispositif série. Au niveau du module TWIMO, l accès à la liaison série (TX et RX, et éventuellement RTS et CTS) se fait sur le périphérique USART1 du µc. 1.7. Mise au point du firmware du module Le connecteur H20 permet de connecter une sonde de debug du type JLINK au SDK. En réalité seulement 5 signaux sont utilisés pour le debug (Reset, Vcc, Gnd, SWDIO et SWCLK). 1.8. Schéma SDK Voir schéma électrique du SDK en Annexe! Important : voici la liste des composants apparaissant sur le schéma mais n étant pas câblés sur la carte : MOD1 G1 SW11-SW12 J1-J5-J3-J4-J7 U1-U3-U4 R1-R14-R7-R11-R12-R20-R8-R9-R10-R4-R5-R6-R13-R15-R21-R22 C21-C22-C40-C41-C42-C43-C44-C45-C23-C36-C37-C38-C24-C39 5
2. Quick Start Le SDK est fourni sans module TWIMO. FR L utilisateur doit donc tout d abord souder le module TWIMO sur le footrpint prévu à cet effet. Ensuite, l utilisateur doit souder 2 fils depuis des plages situés sur la surface du module vers des trous au niveau du SDK comme indiqué sur la photo ci-dessous : Ces 2 fils permettent de relier les I/Os de debug du µc (SWDIO et SWCLK) au connecteur de debug situé sur la carte SDK. Avant tout usage, l utilisateur doit ensuite s assurer que le switch de sélection du mode de fonctionnement est sur la bonne position en fonction de ce qu il souhaite faire (cf. 1.3). L utilisateur peut ensuite alimenter le SDK sous 3.5 v. 6
3. Firmware Bootloading Pour entrer en mode bootload, l utilisateur doit mettre le switch de sélection du mode de fonctionnement sur ON. Le telechargement du firmware s effectue à travers la liaison série (USART1 sur le µc). FR Voici décrit ci-dessous la procédure à suivre : Lancer l application de STM Flash Loader : NB: de façon à réduire le temps nécessaire au flashage, l utilisateur peut augmenter le «Baud rate» à 115000. 7
Cliquer sur «next» FR Cliquer sur «next» 8
Cliquer sur «next» FR NB: L utilisateur peut aussi sélectionner «Global Erase» afin de s assurer que la flash est effacée avant programmation et sélectionner «Verify After Download» afin d effectuer une vérification après flashage. Cliquer sur «next». Cliquer sur finish quand le flashage est terminé. 9
4. Annexes FR 10
FR 11
GB ENGLISH 12
Introduction - English The purpose of this document is to describe the hardware support used for software application development based on TWIMO modules range. 1. Equipment description GB Wrapping zone with Vcc and GND lines Debug probe connector Reset hard Jumper TWIMO module Antenna SMA connector Buttons LEDs Switchs SDK Power Supply Switch for operating mode selection RS232 access Access to TWIMO module I/Os Wrapping zone with Vcc and GND lines 1.1. Power supply The power supply of the SDK is done under 3.5V to obtain a voltage of 3.3 V (nominal operating voltage of the module TWIMO) across the module bounds. Power can be done either through the terminals or the screw terminals. The Jumper allows to mesure the TWIMO module consumption by inserting an ampermeter in series. 1.2. TWIMO module access Pads on either side of the module provide access to the I/Os. A set of push buttons, switches and LEDs is available to allow the developer to simulate external actions, to perform the debug etc... 13
1.3. Operating mode selection The operating selection switch allows to choose between the «normal» mode (OFF position) that corresponds to the mode of development of the firmware using the debug probe, and «bootloader» mode (ON position) that corresponds to the mode in which the user can come to flash a binary through the serial link (see Chapter 3). This switch is directly connected to pin 9 of the module (BOOT pin). GB 1.4. Reset The reset button is connected directly to pin 7 of the module (RESET pin) 1.5. Antenna connector A SMA connector is available to allow the user to connect an antenna. 1.6. RS232 Link The DB9 connector (coupled to a line driver Maxim on the card) allow to interface the module with a PC or another serial device. On the TWIMO module side, access to the serial (TX and RX, and possibly RTS and CTS) is done through the device s microcontroller USART1 peripheral. 1.7. Development of the module s firmware The H20 connector allows to connect a debug probe (JLINK type) to the SDK only. Five signals are used to debug (Reset, Vcc, Gnd, SWDIO et SWCLK). 1.8. SDK schematic See SDK wiring diagram in appendix! Important : here is the list of components shown in the diagram but not wired on the PCB: MOD1 G1 SW11-SW12 J1-J5-J3-J4-J7 U1-U3-U4 R1-R14-R7-R11-R12-R20-R8-R9-R10-R4-R5-R6-R13-R15-R21-R22 C21-C22-C40-C41-C42-C43-C44-C45-C23-C36-C37-C38-C24-C39 14
2. Quick Start The SDK is provided free TWIMO module. The user must first solder the TWIMO module on footrpint for this purpose. Then, the user must solder two wires from two bands located on the surface of the module, to the holes in the SDK, as shown in the picture below: GB This two wires allow to connect the debug I/Os of the microcontroller (SWDIO and SWCLK) to the debug connector located on the SDK PCB. Before using, the user must then ensure that the switch for selecting the operating mode is tin he correct position according to what the user wants to do (see 1.3). The user can then supply the SDK in 3.5 v. 15
3. Firmware Bootloading To enter bootloader mode, the user must set the switch for operating selection switch in «ON» position, and apply a reset. The firmware download is done through the serial link (USART1 of the microcontroller). Procedure to be followed: GB Launch the application STM «Flash Loader»: NB: in order to reduce the time required to flash, the user can increase the «Baud rate» to 115000. 16
Clic on «next» button GB Clic on «next» button 17
Clic on «next» button GB NB: the user can also select «Global Erasel» to ensure that the flash is erased before programming and select «Verify After Download» to conduct a verification after flashing. Clic on «next» button. Clic on finish button when flashing is over. 18
4. Appendixes GB 19
GB 20