SOURCEFORGE » RALF » 2015 Erasure codes for Cubesat missions

h1. II - Tutorial - Simple project on CubeSat Kit

{{>toc}}

The beginning with the CubeSat Kit can be complicated and time wasting, by going from documentation until a working implementation on electronic components, so the following tutorial is proposed in order to progress in a project structure step by step.

h2. 1. Inventory & Documentation

h3. 1.1 Equipment

See previous chapter [[I - Equipment]]

h3. 1.2 Five essential manuals to well begin

(1) attachment:"CubeSatKit Manual.pdf"

(2) attachment:"CubeSat Kit SD Card and EFFS-THIN User Manual.pdf"

(3) attachment:"Salvo User Manual.pdf"

(4) attachment:"dsPIC33FJXXXGPX10 Manual.pdf"

(5) attachment:"Development Board Manual.pdf"

h3. 1.3 From previous project : SPUTNIK STRIKES BACK

"Equipments":https://sourceforge.isae.fr/projects/project-cubesat/wiki/Equipment_inventory

h3. 1.4 From Pumpkin : Cubesat kit overview

"Training material - read this first":https://sourceforge.isae.fr/attachments/download/100/20120220_Pumpkin_CubeSat_Kit_Training.pdf - "Cubesat physical dimensions":https://sourceforge.isae.fr/attachments/download/496/cds_rev13_final.pdf

---

h2. 2. Elementary steps

1 - Download latest release of *MPLAB X IDE* on the "Website":http://www.microchip.com/pagehandler/en-us/family/mplabx/ under Downloads e.g. for Windows (x86/x64)  : MPLAB® X IDE v3.15

-> Integrated Development Environment to implement code and either simulate it on computer or load it on electronic components

2 - Download latest release of *XC16 Compiler* for MPLAB on the "Website":http://www.microchip.com/pagehandler/en_us/devtools/mplabxc/ under Downloads e.g. for Windows (x86/x64)  : MPLAB XC16 Compiler v1.25

-> C compiler for 16 bits PIC processors from Microchip

Notes : It can be installed to run in Free mode and take care to install x16\ under Microchip\ folder otherwise MPLAB won't recognize it

3 - On the same way, download under the same section at Peripheral Libraries 16-bit *dsPIC33 Peripheral Libraries* e.g.  16-bit dsPIC33, PIC24E, PIC24H MCUs: Legacy Peripheral Libraries

Note : Take care to install it under \Microchip\xc16\v1.25\ (if this version)

-> Essential libraries to program dsPIC33 such as <uart.h>, <timer.h> etc.

4 - *Test of connectivity* with ICD3

i- Manually Install Driver " Microchip\MPLAB X IDE\Switcher\64bit\winusb " for ICD3 - "Tutorial here":http://microchip.wikidot.com/mplabx:manually-install-drivers-for-real-ice-or-icd 

ii- Test :

p=. !Test_Interface.PNG!

-> Ready to work with development board

5 - Download necessary files for *CubeSat Kit* on "Cubesat Kit software for dsPIC33 microcontrollers":https://sourceforge.isae.fr/attachments/download/103/cubesatkit-dspic33-1.2.4-rc1.exe from Pumpkin

-> Contains source files, libraries and examples for the dsPIC33 use in the CubeSat Kit

6 - Download necessary files for *Salvo* (dsPIC) on "Salvo OS for dsPIC33 microcontrollers":https://sourceforge.isae.fr/attachments/download/104/salvo-pro-dspic-4.3.0-rc1.exe and "EFFS Thin SD card support":https://sourceforge.isae.fr/attachments/download/105/cubesatkit-effs-thin-dspic33-1.9.3-rc3.exefrom Pumpkin

-> Contains source files, libraries and examples for the use of the Real-Time Operating System (RTOS)

7 - Download Pumpkin's processor-specific "software libraries":http://www.pumpkininc.com/library/dspic33/ 1.0.1 and 1.0.2

---

h2. 3. Creation of a simple MPLAB X IDE project

1- *Settings* :

i- Projects : Standalone Project

ii- Device Family : 16-bits DSCs (dsPIC33)  Device : dsPIC33FJ256GP710

iii- Tool : ICD 3 > 

!Device.png!

iv- Compiler : XC16

2- How to *add* your dedicated files :

i- Right-click on Source Files > Add Existing Items From Folders... > Add Folder... > Select as Type of File : !C_Source.png! and chose your folder

ii- For Headers see [[II - Tutorial - Simple project on CubeSat Kit#"5. - Building"|5. - Building]]

iii- Right-click on Libraries > Add Library/Object File > Choose one library (1 by 1)

---

h2. 4. File management

For C-Files :  C:\Pumpkin\Salvo\Src

p=. !Salvo_Src.png!

For H-Files :  C:\Pumpkin\Salvo\Inc

p=. !Salvo_Inc.png!

For C-Files :  C:\Pumpkin\CubeSatKit\DSPIC33\src

p=. !PIC_src.png!

For H-Files :  C:\Pumpkin\CubeSatKit\DSPIC33\inc

p=. !PIC_inc.png!

For Libraries :  C:\Pumpkin\CubeSatKit\DSPIC33\lib\mcc30-v3

p=. !PIC_lib.png!

For peripheral libraries of dsPIC33F : C:\Program Files (x86)\Microchip\xc16\v1.25\support\peripheral_30F_24H_33F

p=. !Peripheral_Lib.png!

For Pumpkin library for dsPIC33 : C:\Pumpkin\Library\DSPIC33\Inc and C:\Pumpkin\Library\DSPIC33\Src

p=. !Pumpkin_Lib_Inc.png! !Pumpkin_Lib_Src.png!

For preliminary files from test : C:\Pumpkin\CubeSatKit\Example\dsPIC33\dsPIC33FJ256GP710\CubeSat_Kit_Dev_Board\Test\Test1

p=. !PIC_Test1.png!

Add lib : C:\Pumpkin\CubeSatKit\Example\dsPIC33\dsPIC33FJ256GP710\CubeSat_Kit_Dev_Board\Test\Test1\MPLAB_C30\Pro-lib

p=. !ProLib.png!

For files from test : C:\Pumpkin\CubeSatKit\Example\all\all\CubeSatKit_Dev_Board\Test\Test1

p=. !all_Test1.png!

---

h2. 5. Building

1- Add *Header folders* for compiler :

Right-click on your project > Properties > XC16 (Global Options) > Common include dirs [...] > Browse... > Select all directories containing headers

p=. !Include.png!

-> Compiler doesn't know otherwise include<...> in files

2- In order to avoid conflict between files of C:\Pumpkin\Salvo\Src and C:\Pumpkin\Salvo\Src\MCC30 :

p=. !Conflict.png!

You have to *keep* :

*  *salvohook_idle.c* of MCC30/ -> Remove it from Src 

*  *salvohook_interrupt_MCC30_IRQ.c* -> Remove from Project all salvohook_interrupt.c

*  *salvohook_wdt_MCC30_clrwdt.c* -> Remove from Project all salvohook_wdt.c

*  *salvoportmcc30-sm.s* -> Remove from Project salvoportmcc30-lm.s if present

3- Right-click on your project > Properties > XC16 (Global Options) > Change Output file format from ELF to COFF

p=. !Output_File.png!

-> All libraries are dedicated to "coff"

---

h2. 6. Running

1- Connection to the development board and Run

-> You should have the following output :

p=. !Build.png!