Infineon ASCLIN Shell UART 1 Bedienungsanleitung

AURIX™ TC2xx Microcontroller Training

V1.0.0

ASCLIN_Shell_UART_1

Shell via UART communication

Please read the Important Notice and Warnings at the end of this document

Scope of work

A Shell is used to parse a command line and call the corresponding

command execution. The ASCLIN module is used to interface with the

Shell through the USB port via UART.

The ASCLIN module is configured for UART communication.

The Shell from iLLDs exploits the ASCLIN module to interpret and manage

commands from the user like “info”, “toggle [x]” or “help”.

Introduction

›The Asynchronous/Synchronous Interface (ASCLIN) module provides

serial communication with external devices. In this example, it is used to

interface with the PC through the USB port via UART communication.

›A Shell is a user interface for parsing commands and accessing services.

Hardware setup

This code example has been

developed for the board

KIT_AURIX_TC297_TFT_BC-Step.

The board should be connected to

the PC through the USB port (1).

Implementation

Configure the ASCLIN module

The configuration of the ASCLIN module is done by initializing an instance of the IfxAsclin_Asc_Config

structure, which contains the following fields:

›baudrate –a structure that allows to set

–baudrate –the communication speed in bit/s

–oversampling –the division ratio of the baud rate for reaching higher frequencies to ensure

oversampling

›bitTiming –a structure that allows to set the sampling mode with

–medianFilter –the number of samples per bit

–samplePointPosition –the first sample point position

›interrupt –a structure that allows to set

–txPriority, rxPriority and erPriority –the interrupt priorities for transmission, reception and error

events

–typeOfService –the service provider responsible for handling the interrupt, which can be any of the

available CPUs, or the DMA

›pins –a structure that allows to set which port pins are used for the communication

›rxBuffer, rxBufferSize,txBuffer, txBufferSize –parameters that allow to configure the buffers that will

hold the incoming/outgoing data

The function IfxAsclin_Asc_initModuleConfig() fills the configuration structure with default values and

IfxAsclin_Asc_initModule() function initializes the module with the user configuration.

Both the functions can be found in the iLLD header IfxAsclin_Asc.h.

Implementation

Configure the Shell

To configure the Shell, it is needed to firstly initialize a Standard Interface and a Standard IO from the iLLDs.

This is done by the functions IfxAsclin_Asc_stdIfDPipeInit(), Ifx_Console_init() and

Ifx_Assert_setStandardIo(), that can be found respectively in the iLLDs headers IfxAsclin_Asc.h,

Ifx_Console.h and Assert.h.

Furthermore, it is needed to define the macros IFX_CFG_ASSERT_STDIO,

IFX_CFG_ASSERT_VERBOSE_LEVEL_DEFAULT and IFX_CFG_ASSERT_INCLUDE to configure the

Ifx_Assert.h header.

This is done in the configuration header Ifx_Cfg.h.

The Shell is configured inside the function initShellInterface() by initializing an instance of the

Ifx_Shell_Config structure with default values through the function Ifx_Shell_initConfig(). Then, the

following parameters are modified:

›standardIo –that allows to set the module used for serial communication

›commandList –that allows to set the list of commands supported by the shell

The command list is an array of structures of the type Ifx_Shell_Command, that contains:

–commandLine –the actual command which will be sent to the shell by the user

–help –a small description of the command that is shown when help command is given

–data –a link to the shell

–call –the function called when the command is given

The Ifx_Shell_init() function initializes the shell with the user configuration.

The functions Ifx_Shell_initConfig() and Ifx_Shell_init() can be found in the iLLD header Ifx_Shell.h, while

the function initShellInterface() is defined in the header UART_ASCLIN_Shell.h.

Implementation

Run the Shell

The Shell is continuously run through the function runShellInterface() called inside the infinite while loop in

the Cpu0_Main.c file.

It continuously reads the incoming data and evaluates them when the carriage return character is entered.

Configure and control the LEDs

The LEDs are toggled by controlling the port pins to which they are connected using methods from the iLLD

headers IfxPort.h.

The LED port pins have to be configured to output push-pull mode using the function

IfxPort_setPinMode().

During program execution, the LEDs are switched on and off using the function IfxPort_setPinState().

Implementation

Configure the Interrupt Service Routine (ISR)

The function implementing the ISR needs to be assigned a priority and a core responsible for its execution.

This is done with the macro IFX_INTERRUPT(isr, vectabNum, priority).

Since the Shell uses the ASCLIN module to interface with the user, three ISR are needed to be configured for

transmission, reception and error events.

Each of the ISR should call the handler for the respective operation (transmit, receive or error) by passing the

ASC handle.

Run & Test

In order to use the shell interface, a serial monitor (e.g. PuTTY, HTerm) is

required. The serial monitor must be configured with the following

parameters to enable the communication between the board and the PC:

›Port: COMx (e.g. COM5, COM port number depends on the setup)

›Baud rate: 115200

›Data bits: 8

›Parity: None

›Stop bits: 1

›Handshaking: None

Run and Test

Firstly, the serial monitor should be opened.After code compilation and

flashing the device, perform the following steps:

›Type “help” to see the list of available commands

›Type “toggle [0/1/2/3/4]” to respectively: turn on all LEDs, toggle LED

D107, toggle LED D108, toggle LED D109 or toggle LED D110

›Check command execution.

Inhaltsverzeichnis

Andere Infineon Steuereinheit Handbücher

Infineon

Infineon Cypress CYBLE-212020-01 Bedienungsanleitung

Infineon

Infineon GPT12 PWM Capture 1 Bedienungsanleitung

Infineon

Infineon AIROC IFW56810 Bedienungsanleitung

Infineon

Infineon AIROC CYW20822-P4TAI040 Bedienungsanleitung

Infineon

Infineon SMU IR Alarm 1 Bedienungsanleitung

Infineon

Infineon Multicore 1 Bedienungsanleitung

Infineon

Infineon SCU Reset Detection 1 Bedienungsanleitung

Infineon

Infineon Easy 1B Bedienungsanleitung

Infineon

Infineon REF MA5332BTLSPS Bedienungsanleitung

Infineon

Infineon HybridPACK 2 Benutzerhandbuch

Infineon

Infineon XMC1000 Bedienungsanleitung

Infineon

Infineon UART VCOM 1 Bedienungsanleitung

Infineon

Infineon REF-AIRCON-C302A-IM564 Bedienungsanleitung

Infineon

Infineon STM Interrupt 1 Bedienungsanleitung

Infineon

Infineon CCU6 PWM Capture 1 Bedienungsanleitung

Infineon

Infineon PressFIT Bedienungsanleitung

Infineon

Infineon SPI CPU 1 Bedienungsanleitung

Infineon

Infineon ASCLIN SPI Master 1 Bedienungsanleitung

Infineon

Infineon Cypress EZ-BLE CYBLE-022001-00 Bedienungsanleitung

Infineon

Infineon FF900R12IE4 Handbuch

Infineon

Infineon AIROC CYW20829B0-P4TAI100 Bedienungsanleitung

Infineon

Infineon TLE9262-3BQX Bedienungsanleitung

Infineon

Infineon TLE9263BQXV33 Bedienungsanleitung

Infineon

Infineon GTM ATOM PWM 1 Bedienungsanleitung

Beliebte Steuereinheit Handbücher anderer Marken

Festo

Festo Compact Performance CP-FB6-E Stücklistenhandbuch

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Bedienungsanleitung

JS Automation

JS Automation MPC3034A Bedienungsanleitung

JAUDT

JAUDT SW GII 6406 Series Kurzanleitung

Spektrum

Spektrum Air Module System Bedienungsanleitung

BOC Edwards

BOC Edwards Q Series Bedienungsanleitung

KHADAS

KHADAS BT Magic Bedienungsanleitung

Etherma

Etherma eNEXHO-IL Bedienungsanleitung

PMFoundations

PMFoundations Attenuverter Bedienungsanleitung

GEA

GEA VARIVENT Bedienungsanleitung

Walther Systemtechnik

Walther Systemtechnik VMS-05 Bedienungsanleitung

Altronix

Altronix LINQ8PD Montageanleitung

Eaton

Eaton Powerware Series Bedienungsanleitung

WAGO

WAGO 750-407/040-000 Bedienungsanleitung

Sony

Sony CCU-590 Bedienungsanleitung

Graco

Graco 25D614 Bedienungsanleitung

Task Force Tips

Task Force Tips YE-RF-900 Programmierhandbuch

Shini

Shini SPV-U Series Bedienungsanleitung