NJIT Student Chapter of ACM: Buzzer Beater

Purpose: Determing order of buzzer beaters pressed via the interrupt controller peripheral of the STM8S103F3

Toolchain

• SPL Library for quick development while having low overhead

• COSMIC CXSTM8 compiler is used to compile, link, and build the code

• COSMIC CXSTM8 compiler and a yearly license can be gotten from this website

• ST-LinkV2 device driver and connector required

  • Terminal commands to properly run the CXSTM8 Compiler with the COSMIC library
    

    • Compile
      cxstm8 -istm8s103f3_spl-master\inc +debug -pxp -no -l +mods0 -pp -i"...\COSMIC\FSE_Compilers\CXSTM8\Hstm8" -clDebug\ -coDebug\ src\main.c lib\spl*.c

      cxstm8 -i"ACM Buzzer Beater\include" -iACM_Buzzer_Beater\external_dependencies +debug -pxp -no -l +mods0 -pp -i"C:\Program Files (x86)\COSMIC\Hstm8" -clDebug\ -coDebug\ src*.c lib\spl*.c lib*.c

    • Link & Build:
      clnk -m Debug\buzzerbeater.map -l"C:\Program Files (x86)\COSMIC\FSE_Compilers\CXSTM8\Lib" -o Debug\buzzerbeater.sm8 Debug\buzzerbeater.lkf

      clnk -m Debug\buzzerbeater.map -l"C:\Project_Files\ACM Buzzer Beater\lib" -l"C:\Project_Files\ACM Buzzer Beater\src" -o Debug\buzzerbeater.sm8 Debug\buzzerbeater.lkf

    • Convert to .elf
      cvdwarf Debug\buzzerbeater.sm8

    • Convert to .s19:
      chex -o Debug\buzzerbeater.s19 Debug\buzzerbeater.sm8

• Map file associated with the microcontroller denoted with extension (.map) is neccesary to link compiled code to create the (.lkf) file neccesary to create .sm8 file

• Linker file can be created with ST Visual Develop, one for this microcontroller is provided

• ST Visual Programmer is currently used program flash data, memory data, and option bytes

• ST-LinkV2 is used as a physical adapter between USB-A and SWIM-Protocol running the ST-LinkV2 device driver

Documentation

• STM8S103F3 Datasheet
• STM8(S/AF) Reference Manual
• Compiler manual comes with download of CXSTM8