Continuing the STM8 Expedition

Encoder Interface

In applications like motor control, it is often required to know how much a motor has rotated, how fast it is rotating and in which direction. It is possible to deduce these feedback data with interrupts, timers and even with tricky GPIO coding. However, using methods employing GPIOs, interrupts and timers will add some resource overhead and will also add up extra coding efforts. STM8s have in-built encoder decoding interface that can be used in such scenarios without extra coding or hardware addition.

Rotary Click Binary Clock

The applications of encoder decoding interface are not only limited to acquiring motor feedbacks. The encoder interface can also be used to interface rotary encoders, linear actuators, digital volume control, etc. Here in this example, I demonstrated this encoder interface with a rotary encoder.

Hardware Connection

enc

 

Code Example

#include "STM8S.h"
#include "lcd.h"


#define LED_Port                               GPIOD
#define LED_Pin                                GPIO_PIN_0


unsigned char bl_state;
unsigned char data_value;


void clock_setup(void);
void GPIO_setup(void);
void TIM1_setup(void);
void lcd_print(unsigned char x_pos, unsigned char y_pos, unsigned int value);


void main()
{     
       unsigned int present_value = 0x0000;
       unsigned int previous_value = 0x0001;

       clock_setup();
       GPIO_setup();
       TIM1_setup();

       LCD_init(); 
       LCD_clear_home();

       LCD_goto(1, 0);
       LCD_putstr("STM8S QEI Test");
       LCD_goto(0, 1);
       LCD_putstr("Value:");

       while(TRUE)
       {
              present_value = TIM1_GetCounter();
              if(present_value != previous_value)
              {
                     lcd_print(12, 1, present_value);
                     GPIO_WriteReverse(LED_Port, LED_Pin);
              }

              previous_value = present_value;
       };
}


void clock_setup(void)
{
       CLK_DeInit();

       CLK_HSECmd(DISABLE);
       CLK_LSICmd(DISABLE);
       CLK_HSICmd(ENABLE);
       while(CLK_GetFlagStatus(CLK_FLAG_HSIRDY) == FALSE);

       CLK_ClockSwitchCmd(ENABLE);
       CLK_HSIPrescalerConfig(CLK_PRESCALER_HSIDIV4);                                         CLK_SYSCLKConfig(CLK_PRESCALER_CPUDIV1);

       CLK_ClockSwitchConfig(CLK_SWITCHMODE_AUTO, CLK_SOURCE_HSI, DISABLE,
                             CLK_CURRENTCLOCKSTATE_ENABLE);

       CLK_PeripheralClockConfig(CLK_PERIPHERAL_I2C, ENABLE);
       CLK_PeripheralClockConfig(CLK_PERIPHERAL_TIMER1, ENABLE);
       CLK_PeripheralClockConfig(CLK_PERIPHERAL_SPI, DISABLE);
       CLK_PeripheralClockConfig(CLK_PERIPHERAL_ADC, DISABLE);
       CLK_PeripheralClockConfig(CLK_PERIPHERAL_AWU, DISABLE);
       CLK_PeripheralClockConfig(CLK_PERIPHERAL_UART1, DISABLE);
       CLK_PeripheralClockConfig(CLK_PERIPHERAL_TIMER2, DISABLE);
       CLK_PeripheralClockConfig(CLK_PERIPHERAL_TIMER4, DISABLE);
}


void GPIO_setup(void)
{
       GPIO_DeInit(GPIOC);
       GPIO_Init(GPIOC,
                 ((GPIO_Pin_TypeDef)(GPIO_PIN_1 | GPIO_PIN_2)),
                 GPIO_MODE_IN_PU_NO_IT);

       GPIO_DeInit(GPIOD);
       GPIO_Init(LED_Port, LED_Pin, GPIO_MODE_OUT_OD_HIZ_FAST);
}


void TIM1_setup(void)
{
       TIM1_DeInit();

       TIM1_TimeBaseInit(10, TIM1_COUNTERMODE_UP, 1000, 1);

       TIM1_EncoderInterfaceConfig(TIM1_ENCODERMODE_TI12,
                                  TIM1_ICPOLARITY_FALLING,
                                  TIM1_ICPOLARITY_FALLING);

       TIM1_Cmd(ENABLE);
}


void lcd_print(unsigned char x_pos, unsigned char y_pos, unsigned int value)
{
       char tmp[5] = {0x20, 0x20, 0x20, 0x20, '\0'} ;

       tmp[0] = ((value / 1000) + 0x30);
       tmp[1] = (((value / 100) % 10) + 0x30);
       tmp[2] = (((value / 10) % 10) + 0x30);
       tmp[3] = ((value % 10) + 0x30);

       LCD_goto(x_pos, y_pos);
       LCD_putstr(tmp);  
}

 

Explanation

A rotary/quadrature encoder gives two outputs that are slightly out of phase:

rotary

Thus, to interface such an encoder, we will need two timer inputs. TI12 are those inputs. TI12 are mapped to TIM1_CH1 and TIM1_CH2 respectively. These inputs need to be pulled up unless external pull-up resistors are used.

GPIO_DeInit(GPIOC);
GPIO_Init(GPIOC,
          ((GPIO_Pin_TypeDef)(GPIO_PIN_1 | GPIO_PIN_2)),
          GPIO_MODE_IN_PU_NO_IT);
 
The peripheral and CPU clocks are set as follows:
 
CLK_HSIPrescalerConfig(CLK_PRESCALER_HSIDIV4);
CLK_SYSCLKConfig(CLK_PRESCALER_CPUDIV1);

CLK_ClockSwitchConfig(CLK_SWITCHMODE_AUTO, CLK_SOURCE_HSI, DISABLE,
                       CLK_CURRENTCLOCKSTATE_ENABLE);

CLK_PeripheralClockConfig(CLK_PERIPHERAL_I2C, ENABLE);
CLK_PeripheralClockConfig(CLK_PERIPHERAL_TIMER1, ENABLE);

Since TIM1’s encoder interface is used, TIM1 peripheral clock is enabled and the I2C clock is enabled for the I2C LCD module.

Then, the main thing to explain here is the way the timer is set for encoder interface:

void TIM1_setup(void)
{
       TIM1_DeInit();

       TIM1_TimeBaseInit(10, TIM1_COUNTERMODE_UP, 1000, 1);

       TIM1_EncoderInterfaceConfig(TIM1_ENCODERMODE_TI12,
                                  TIM1_ICPOLARITY_FALLING,
                                  TIM1_ICPOLARITY_FALLING);

       TIM1_Cmd(ENABLE);
}

The 1000 in the time base setup is maximum encoder interface count, i.e. the encoder interface’s output will span from 0 to 1000.

Encoder modes

Since we are using two inputs, the encoder interface is setup according to the third option shown above.

To get current encoder count, TIM1’s counter is read as follows:

present_value = TIM1_GetCounter();

 

Demo

Encoder Interface (1) Encoder Interface (2)

Pages: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

Related Posts

86 comments

  • hi
    i copied all the above (UART interrupt) code as directed (without any changing). only i added stm8s_delay.h.
    but this error occurs

    #error clnk Debug\mgstm_1007.lkf:86 Debug\stm8_interrupt_vector.o: symbol f_NonHandledInterrupt multiply defined (Debug\stm8s_it.o)

    please guide
    regards

  • Example with an encoder. The counter only counts up, regardless of the direction of rotation of the encoder. Where could be the problem?

  • How to fight trash data on ADC inputs? Even when I don’t connect any voltage source it shows some data.

  • Hello, the interrupt handling is different from what the datasheet says. To clear the flag just read the SR and DR registers. In addition, if the 4 LSB of SR reports an error, there may not be an interruption, it is necessary to monitor these errors as well, and clean the register, as the datasheet says, I noticed this using an STM8S003F3, I don’t know if this happens with other models.

  • why are the lines

    ADC1_ScanModeCmd(ENABLE);
    ADC1_StartConversion();

    written inside the while loop? Shouldn’t we set them once?

  • I’m programming in IAR and just have noticed that the file stm8_interrupt_vector.c is missing. I found it under …\STM8S_StdPeriph_Lib\Project\STM8S_StdPeriph_Template\STVD\Cosmic and included it into my workspace. But during the making it gives out a bunch of errors. I could I solve this?

  • I enjoyed the tutorial. Thank you. Just one question: is it fine that my counter is incrementing in 2 instead of 1 while I turn the encoder?

  • Sir can i use this code for ILI9488 SPI TFT display of 320(RGB) x 480 Resolution?

  • Hello sir i am Chavda hiren

    this timer is STVD is ok
    But i Need This Timer a IAR IDE
    Can you Plz Sir

    void TIM2_setup(void)
    {
    TIM2_DeInit();
    TIM2_TimeBaseInit(TIM2_PRESCALER_32, 1250);
    TIM2_OC1Init(TIM2_OCMODE_PWM2, TIM2_OUTPUTSTATE_ENABLE, 1000,TIM2_OCPOLARITY_LOW);
    TIM2_OC2Init(TIM2_OCMODE_PWM2, TIM2_OUTPUTSTATE_ENABLE, 1000, TIM2_OCPOLARITY_LOW);
    TIM2_SetCompare1(100);
    TIM2_SetCompare2(100);
    TIM2_Cmd(ENABLE);
    }

    Thank you

  • Shahryiar,
    I am working with your code related to ST7735 TFT Display. When compiling COSMIC compiler is giving me an error for ST7735.c file and the error is as follows:

    st7735.c:389(11) missing prototype

    On line 389 of the ST7735.c is “swap(&y1, &y2);”
    My question is where is the function defined for “swap”?

    Thanks in advance
    Adil

  • naveed ahmed siddiqui

    Dear sir i have problem to use ram size of stm8s003k3
    how can i use 1024 byte for serial received
    please replay me i am waiting

  • Hi Shawon Shahryiar,

    You mentioned this *”IAP can also be used for upgrading application firmware Over-The-Air (OTA)”* in this blog at the beginning, what does this mean?

    And I know that STM32 is also not a wireless MCU but there are some solutions to upgrade firmware using ESP8266 and Bluetooth module through UART.

    ( https://www.st.com/en/embedded-software/stsw-stm8006.html ) I found this above source code as example of implementation of bootloader, please help me with this.

    ( https://www.st.com/en/embedded-software/stsw-stm8062.html ) and also this as a customised bootloader,

    ( https://community.st.com/s/case/5003W00000Eqj8TQAR/information-for-ota-feature-in-stm8s003fpf6 ). I raised a question in ST community about this and they told it is possible to use UBC(User Boot Code) area to update firmware. Please check and help me, may be it helps everyone.

    Thanks

    Junaid

  • 1. Do wfi() and halt() have the same power savings?

    2. If halt() is called, can the microcontroller still be woken up by an interrupt?

  • Hi Shawon

    Thank you for these excellent tutorials.

    I was just wondering why you use two output channels on TIM2? Do you connect them in parallel?

  • Hello all embedded people, my application is to read pwm on a pin for rise edge or fall edge (ANYEDGE) and produce a pwm signal with different duty cycle on another pin (without any button pressed).

    Can anyone explain me how to use this example for my application? please help me 🙂

  • Thanks for useful tutorials
    How can I store/initialize byte data into EEPROM at the time of programming?

    Regards

  • Gostei muito bom.

  • Hello Shawon,
    Thank you for your great tutorials.

    Could you please help me with NEC IR decoding using stm8s.

  • I want to use multichannel adc interrupt for eg (channel 2 ,3,4 of ADC1 ) but when i do this i got value from a single channel in all three buffer value. what i should do for correct data?? please suggest

  • hi again
    an other problem! 🙁
    i want to use multi channel “scan mode” only for 2 channel(CH2,CH3) and i used other adc pins for gpio purposes.
    but… when adc runs and turns on, gpio pins become noisy!!!
    whats problem?
    thanks

  • hi shawon
    i want to read “ADC1_GetBufferValue(0)” in timer interrupt… but it returns 0 !!!! (in the main.c it’s ok)
    how can i do it?

  • First I want to say thank you for your useful tutorial.
    then I have a question:
    I need to store one byte data either on EEPROM or FLash memory. the problem is I need to write it into the memory every 5 minutes.
    The datasheet says that the EEPROM can work for 100K cycles of erase/write, and that’s not enough for a long-time use of the device.
    I want to know how many times (cycles) we can erase/write to an address on Flash memory.
    thanks a lot

  • Hi
    This is an excellent series of tutorial. I appreciate your efforts. I’m using the similar multi-channel ADC to read data from channel 3 and 7. But the problem that I have is, the ADC value doesn’t seem to update automatically, I need to reset it in order to get the updated data. Is there anything I’m missing in the ADC1 configuration that causes it? Thanks

  • This code is very helpful, that you for showing it. There doesn’t seem to be a lot of documentation or resources for these processors, but their price makes them very attractive.

    In my application, I use AIN2 and AIN3 since the pins for the other channels are required for other functionality. I am wondering if there is a way to just read those channels individually when I need to without having to scan channels 0-3 each time and without having to call a reconfiguration routine to switch between channels 2 and 3?

  • Hi. I’m using the STVD IDE with Cosmic with an STM8TL52F4 MCU with the ‘Minimize Code Size’ compiler option selected. Under Debug instrument->ICD MCU configuration->Options, I set the DATASIZE_bit6 Value to 1 (the other DATASIZE bits are 0) and made no other changes there. As I understand it, that should reserve a 1024 byte window near the end of EEPROM for my permanent (power-up to power-up) settings info starting at address 0x0800. I’m able to UNLOCK, write and read that area and LOCK it again without problems. However, with each debug session, I find that the area is always overwritten. How do I prevent that and keep that area secure? And I’m curious what it’s being overwritten WITH? I’m doing just as this demo suggests.

  • Hi Shawon. How to take more than one measurement with interrupt. Example AIN5 and AIN6 measurement with interrupt ?

  • I use Eclipse & sdcc .
    void timer1_CAP_isr (void) __interrupt (12) {
    I have the following error.
    Unused declaration of function ‘timer1_CAP_isr’
    But the interruption doesn’t work

    • The code is written with STVD and the compiler is Cosmic C. Surely it won’t work with other compilers but the concept would work. Thanks.

      • Hi Sharon,

        Is the delay necessary for the programming action?

        I used roughly the same method(but I did not add a delay but only a EOP flag check) and did a action check after programming it works fine at start but as soon as I restart the thing and the code reads old data from the same eeprom address like the programming action never occurred.

  • Shawon,

    Your inspirational blog has gotten me started with STM32 and STM8s micros. You have done a marvelous job in explaining each aspect of the hardware in each of these micros and the example code is well written. Thank you so much for taking the time to put this together for all to use.

    Thank you,
    Adil Khan

  • Hello… Can you suggest me an evaluation kit/development kit for STM8S105S4T6C micro-controller? I need this controller for BLDC Motor control

  • Hi Shawon Shahryiar,

    I am using stm8s003f3 discovery board. In my project, I am using ADC1 multiple channels 0,1,2,3. In these four channels, I am using 0,1,3 as a normal ADC read and channel 2 as an interrupt based.
    I am facing a problem that if configure ADC channel 0,1,3 and read value then ADC interrupts not occurred.
    But if I comment multiple channels read then interrupt occurred.

    Can you tell me why it is like that and can I read adc1 multi-channel with interrupt-based?

    like
    Channel0,1,3 read normal ADC from 3 potentiometers and only channel 2 as an interrupt based.

    • In my write up I stated “In scan mode, the ADC automatically scans a sequence of channels from channel 0 to channel n, keeping the results of AD conversion in data buffer registers. At the end of conversion, the results are ready to be read.” and so in your case it is not like 0 > 1 > 2 > 3…. 2 is missing in the scan sequence and so it will probably not work….

      • Hi Hi, Shawon Shahryiar,

        Might be this is possible but my question is different.
        My question is:- Can I use multichannel ADC with scan mode and ADC interrupt based at the same time with the diffrent channels?
        Example:- Channel 0,1 as a scan mode and channel 2 as an ADC interrupt based simultaneously?

    • Hey i am also using same controller and using single ADC pin but adc value is fluctuating continuously without any input.can u please tell me why this is happening and what is the solution.

  • Normally I don’t learn article on blogs, however
    I wish to say that this write-up very pressured me to check out and do it!
    Your writing taste has been surprised me. Thank you, very nice article.

  • Ϝirst ᧐f aⅼl I would ⅼike tօ say awesome blog!
    Ι had а quick question tһɑt I’ɗ ⅼike to aѕk
    іf yoᥙ don’t mind. Ӏ was curious to knoᴡ how you center yourself ɑnd clear yοur thoսghts prior to writing.
    Ӏ’ѵе had difficulty clearing mү mind in getting mу ideas out tһere.
    I tгuly do tɑke pleasure in writing howeᴠer
    іt just ѕeems lіke tһe first 10 to 15 minutes tend to be lost simply ϳust trʏing to figure օut һow to begin. Any ideas or hints?
    Kudos!

    • Well firstly, to me the concepts of all microcontrollers in world is same and so provided that you have some degree of knowledge of internal peripherals, you can unlock anyone of them by systematically trying out each peripheral on your own…. Secondly, how to start is up to you…. When I compose a blog and plan what I would be focusing on, I take things as such that my audience is in front of me and would likely to ask me the very basics…. I try to write things in simplest possible language and with minimum word count while highlighting what is most important…. A blog on any microcontroller should focus on every aspect and not just a few topics…. Lastly, planning and persistently going by the plan to achieve a vision will surely bring out a good result…. Just don’t lose focus and don’t let yourself be pressurized by too many unknown variables….

  • It’s not my first time to ѵisіt thіѕ web page, i am visiting this webѕite
    dailly and obtain pleasɑnt information from herе
    all the time.

  • I visited multiple blogs except tһe audio quality f᧐r audio songs existing аt this web paɡe iѕ tгuly superb.

  • Dear Shawon,
    Thank you for your useful website and articles.
    I have taken a look at ADC1_Init definition and I found it uses ADC1_ConversionConfig to set channels and conversion mode. So it seems using ADC1_Init once with all needed channels is enough. Am I right?
    Thank you very much.

  • Hello,
    I am learning stm8s, but i have a project in my mind, i am making Pong game with two encoders and PCD8544 LCD. Your tutorials are great and it’s very big source of knowledge for me, and i have a question about this article:
    Is it possible to use two encoder this way? Or can it be done in the other way? I have stm8s103f3p6, and i know it has 4 interrupt pins, so I thought about using these for two encoders, but then i saw your article about QEI

  • Hello Friend!!
    Your stuff is great !!!
    Would you have an example 433 mhz rf signal capture with flash code writing?

  • Ola amigo !!!
    Seu material é excelente!
    Você teria algum exemplo de captura de sinal rf 433 mhz com gravação na flash?

  • Hello friends, pleasant paragraph ɑnd good urging commented ɑt tһiѕ ρlace,
    I ɑm truⅼy enjoying ƅy tһese.

  • Hi,
    Thats great work
    Do you have steps for to work ST7735 TFT IN 8 BIT 8080 mode

  • I don’t even understand how I ended up right here, however
    I believed this publish used to be good. I don’t know who you are however definitely
    you’re going to a well-known blogger should you aren’t already.
    Cheers!

  • Sankalp Rai Gambhir

    Thanks Shawon, your blogs are indeed very helpful. Keep Growing.

  • why are you sending the received data back through TX pin?

  • Hi SHAWON SHAHRYIAR

    I am wondering how to get a Max31855 to talk to a STM8s via SPI.

    JP

    • What’s to wonder about it? It is a simple SPI communication and SPI for STM8 is no different from the SPI of other MCUs…. The following lines are taken from the device’s datasheet and the write up there states how to communicate with it:

      “Drive CS low to output the first bit on the SO pin. A complete serial-interface read of the cold-junction compensated thermocouple temperature requires 14 clock cycles. Thirty-two clock cycles are required to read both the thermocouple and reference junction temperatures (Table 2 and Table 3.) The first bit, D31, is the thermocouple temperature sign bit, and is presented to the SO pin within tDV of the falling edge of CS. Bits D[30:18] contain the converted temperature in the order of MSB to LSB, and are presented to the SO pin within tD0 of the falling edge of SCK. Bit D16 is normally low and goes high when the thermocouple input is open or shorted to GND or VCC. The reference junction temperature data begins with D15. CS can be taken high at any point while clocking out con-version data. If T+ and T- are unconnected, the thermocouple temperature sign bit (D31) is 0, and the remainder of the thermocouple temperature value (D[30:18]) is 1.”

Leave a Reply

Your email address will not be published. Required fields are marked *