Getting started guides


유비노스 시작 안내서 (윈도우즈)


운영체제 종속적 패키지 설치

Chocolatey 설치

  1. 관리자 권한으로 PowerShell 실행

  2. 다음 명령어 실행
    Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

  3. PowerShell 창 닫기

필요한 패키지 설치

  1. 관리자 권한으로 명령 프롬프트(cmd.exe) 실행

  2. 다음 명령어 실행해 필요한 패키지 설치
    choco feature enable -n allowGlobalConfirmation

    choco install ninja make gperf git dtc-msys2 wget 7zip cmake python3 python311 nodejs-lts qemu

  3. 명령 프롬프트(cmd.exe) 창 닫기

유비노스 소스트리 다운로드 및 개발용 가상환경 생성

유비노스 소스트리 다운로드

  1. 일반 사용자 권한으로 명령 프롬프트(cmd.exe) 실행

  2. 다음 명령을 실행해 작업용 디렉토리 생성 후 해당 디렉토리로 이동
    mkdir C:\MyWorks\ubinos
cd C:\MyWorks\ubinos
  3. 다음 명령어를 실행해 유비노스 소스트리 다운로드
    git clone https://github.com/ubinos/ubiworks.git

개발용 가상환경 생성

  1. 일반 사용자 권한으로 명령 프롬프트(cmd.exe) 실행

  2. 다음 명령을 실행해 유비노스 소스트리 디렉토리로 이동
    cd C:\MyWorks\ubinos\ubiworks
  3. 다음 명령을 실행해 가상 환경을 생성
    C:\Python311\python.exe -m venv venv
  4. 다음 명령을 실행해 가상 환경 활성화
    venv\Scripts\activate
  5. 다음 명령을 실행해 필요한 python package 설치
    pip install -r requirements.txt
  6. 다음 명령을 실행해 필요한 nodejs package 설치
    npm install

VSCode 설치

  1. 웹브라우저로 다음 URL에 접속해, VSCode를 다운로드 및 설치

GNU ARM Embedded Toolchain 설치

  1. 웹브라우저로 다음 URL에 접속해, gcc-arm-none-eabi-10.3-2021.10-win32.exe를 다운로드 및 설치

    Note

    설치 완료 창이 뜨면 “Add path to environment variable”을 반드시 체크 하고 마침 버튼을 눌려야 한다.


VSCode로 유비노스 소스트리 열기

  1. 일반 사용자 권한으로 명령 프롬프트(cmd.exe) 실행 (반드시 기존 프롬프트 창을 닫고 새 프롬르트 창을 열어야 함)

  2. 다음 명령을 실행해 유비노스 소스트리 디렉토리로 이동
    cd C:\MyWorks\ubinos\ubiworks
  3. 다음 명령을 실행해 가상 환경 활성화
    venv\Scripts\activate
  4. 다음 명령을 실행해 VSCode로 유비노스 소스트리 열기
    code .

VSCode로 디버깅하기 위해 필요한 확장 프로그램 설치 및 설정

  1. VSCode에서 “Extensions” View를 선택한 후, 다음 확장 프로그램을 설치

    • C/C++ (by Microsoft)

    • C/C++ Themes (by Microsoft)

    • C/C++ Extension Pack (by Microsoft)

    • Python (by Microsoft)

    • CodeLLDB (by Vadim Chugunov)

    • ARM Assembly (by dan-c-underwood)

    • MemoryView (by mcu-debug)

    • Open (by sandcastle)

    • CMake Tools (by Microsoft)

    • Makefile Tools (by Microsoft)

    • Jupyter (by Microsoft)


VSCode CMake 구성

  1. 다음을 참조해 VSCode로 유비노스 소스트리 열기

  2. VSCode에서 “CMake” View 선택

  3. “CMake: Project Outline” 에서 “Configure All Projects” 실행 (그림 2 참고)

    • VSCode 창 상단에 콤보박스가 나타나면 “Unspecified” 를 선택 (안 나타나도 계속 진행)

_images/figure_002014_ubiworks_vscode_cmake_config.png

그림 2 ubiworks CMake configuration

Ubinos 기본 라이브러리 설치

  1. 다음을 참조해 VSCode로 유비노스 소스트리 열기

  2. VSCode에서 “CMake” View 선택

  3. “CMake: Project Outline” 에서 Ubinos library manager (xlm) 실행 (그림 3 참고)

_images/figure_002015_ubiworks_vscode_executing_ubinos_library_manager.png

그림 3 Excueing Ubinos library manager

  1. “Ubinos library manager” 에서 Ubinos 기본 라이브러리 (ubinos_base, ubinos) 설치 (그림 4 참고)

_images/figure_002016_ubinos_library_manager_install_ubinos_default_libraries.png

그림 4 Installing Ubinos default libraries