Skip to content

Documentations

sunghan-chang edited this page Mar 25, 2022 · 64 revisions

Contents

Porting Guide

Please find it here.

User Guide

Installation

Application

SmartThings (Cloud Connection)

Protocols

Audio

Task Manager

FileSystem

Debug methods

API Reference

Please find it here.

NOTE
On Protected build, it has limitation of using above because of kernel / user separation.
Please find the API lists with Protected build option.

Configuration Description

Please find Configurations Description.

Coding rules

Basically we follow Tizen Coding rules except R04.
We recommend using braces even if it has single statement.
Here is a link.
M means Mandatory, R means Recommendation.

NOTE TizenRT might not follow coding rules for arch, board and external folders which are related to vendor specific and external open source.

Script to apply our C and C++ coding rule

There are two formatter.sh to apply our coding rules at tools folder.
Please find them here.

Commit rules

  1. Don't use past tense on commit title.
    arch/s5j: added i2s peripheral to support audio (X)
    arch/s5j: add i2s peripheral to support audio (O)
    
  2. Please fill where (folder location) and what you modify on commit title.
    If your changes includes several different folders, please specify with commas. But if it includes different changes or it can be splitted by another topic, split them as different commits.
    arch/s5j: add i2s peripheral to support audio (O)
    add i2s peripheral to support audio in arch/s5j (O)
    arch, build: change blah blah (O)
    add i2s peripheral to support audio (X)
    
  3. Please keep short title length.
    It makes git log --oneline beautiful (easy to see).
    framework/st_things : Remove the logic that managed the device with… (X)
    framework/st_things : Remove the device management which uses hash (O)
    
  4. Please add an empty line at second line of commit message to distinguish title and description. This is good to oneline command as well.
    arch/s5j: add i2s peripheral to support audio
    
    Description starts here. 2nd line is empty.
    
  5. Please fill commit description what you do in detail.
  6. Don't mix different kinds of changes like formater and code logic change.
  7. To modify your commit which is in pull request, amend original one.
    Don't make a new commit to do it.
    arch/s5j: add i2s peripheral to support audio <- 1st commit
    arch/s5j: fix i2s <- 2nd commit (X)
    
  8. After making pull request, Don't update yours using git pull.
    Please use git rebase instead of pull.
    pull makes unnecessary commit like Merge branch 'master' into .
    That redundant commit is not helpful to developer and maintainer.

Release Notes