II - Tutorial - Simple project on CubeSat Kit » History » Version 9
COLIN, Tony, 12/15/2015 09:03 PM
1 | 1 | COLIN, Tony | h1. II - Tutorial - Simple project on CubeSat Kit |
---|---|---|---|
2 | 1 | COLIN, Tony | |
3 | 1 | COLIN, Tony | {{>toc}} |
4 | 1 | COLIN, Tony | |
5 | 1 | COLIN, Tony | 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. |
6 | 1 | COLIN, Tony | |
7 | 1 | COLIN, Tony | h2. 1. Inventory & Documentation |
8 | 1 | COLIN, Tony | |
9 | 9 | COLIN, Tony | h3. 1.1 Equipment |
10 | 1 | COLIN, Tony | |
11 | 9 | COLIN, Tony | See previous chapter [[I - Equipment]] |
12 | 9 | COLIN, Tony | |
13 | 9 | COLIN, Tony | h3. 1.2 Four essential manuals to well begin |
14 | 9 | COLIN, Tony | |
15 | 9 | COLIN, Tony | |
16 | 9 | COLIN, Tony | |
17 | 9 | COLIN, Tony | h3. 1.3 From previous project : SPUTNIK STRIKES BACK |
18 | 9 | COLIN, Tony | |
19 | 1 | COLIN, Tony | "Equipments":https://sourceforge.isae.fr/projects/project-cubesat/wiki/Equipment_inventory |
20 | 1 | COLIN, Tony | |
21 | 9 | COLIN, Tony | h3. 1.4 From Pumpkin : Cubesat kit overview |
22 | 1 | COLIN, Tony | |
23 | 9 | COLIN, Tony | "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 |
24 | 1 | COLIN, Tony | |
25 | 1 | COLIN, Tony | --- |
26 | 1 | COLIN, Tony | |
27 | 1 | COLIN, Tony | h2. 2. Elementary steps |
28 | 1 | COLIN, Tony | |
29 | 1 | COLIN, Tony | 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 |
30 | 1 | COLIN, Tony | -> Integrated Development Environment to implement code and either simulate it on computer or load it on electronic components |
31 | 1 | COLIN, Tony | |
32 | 1 | COLIN, Tony | 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 |
33 | 1 | COLIN, Tony | -> C compiler for 16 bits PIC processors from Microchip |
34 | 1 | COLIN, Tony | 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 |
35 | 1 | COLIN, Tony | |
36 | 1 | COLIN, Tony | 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 |
37 | 1 | COLIN, Tony | Note : Take care to install it under \Microchip\xc16\v1.25\ (if this version) |
38 | 1 | COLIN, Tony | -> Essential libraries to program dsPIC33 such as <uart.h>, <timer.h> etc. |
39 | 1 | COLIN, Tony | |
40 | 1 | COLIN, Tony | 4 - *Test of connectivity* with ICD3 |
41 | 1 | COLIN, Tony | 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 |
42 | 1 | COLIN, Tony | ii- Test : |
43 | 1 | COLIN, Tony | |
44 | 1 | COLIN, Tony | p=. !Test_Interface.PNG! |
45 | 1 | COLIN, Tony | |
46 | 1 | COLIN, Tony | -> Ready to work with development board |
47 | 1 | COLIN, Tony | |
48 | 1 | COLIN, Tony | 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 |
49 | 1 | COLIN, Tony | -> Contains ... |
50 | 1 | COLIN, Tony | |
51 | 1 | COLIN, Tony | 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 |
52 | 1 | COLIN, Tony | -> Real-Time ... |
53 | 1 | COLIN, Tony | -> Contains ... |
54 | 1 | COLIN, Tony | |
55 | 1 | COLIN, Tony | 7 - Download Pumpkin's processor-specific "software libraries":http://www.pumpkininc.com/library/dspic33/ 1.0.1 and 1.0.2 |
56 | 1 | COLIN, Tony | |
57 | 1 | COLIN, Tony | --- |
58 | 1 | COLIN, Tony | |
59 | 1 | COLIN, Tony | h2. 3. Creation of a simple MPLAB X IDE project |
60 | 1 | COLIN, Tony | |
61 | 1 | COLIN, Tony | 1- *Settings* : |
62 | 1 | COLIN, Tony | i- Projects : Standalone Project |
63 | 1 | COLIN, Tony | ii- Device Family : 16-bits DSCs (dsPIC33) Device : dsPIC33FJ256GP710 |
64 | 1 | COLIN, Tony | iii- Tool : ICD 3 > |
65 | 1 | COLIN, Tony | !Device.png! |
66 | 1 | COLIN, Tony | iv- Compiler : XC16 |
67 | 1 | COLIN, Tony | |
68 | 1 | COLIN, Tony | 2- How to *add* your dedicated files : |
69 | 1 | COLIN, Tony | 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 |
70 | 5 | COLIN, Tony | ii- For Headers see [[II - Tutorial - Simple project on CubeSat Kit#"5. - Building"|5. - Building]] |
71 | 1 | COLIN, Tony | iii- Right-click on Libraries > Add Library/Object File > Choose one library (1 by 1) |
72 | 1 | COLIN, Tony | |
73 | 1 | COLIN, Tony | --- |
74 | 1 | COLIN, Tony | |
75 | 1 | COLIN, Tony | h2. 4. File management |
76 | 1 | COLIN, Tony | |
77 | 1 | COLIN, Tony | For C-Files : C:\Pumpkin\Salvo\Src |
78 | 1 | COLIN, Tony | |
79 | 1 | COLIN, Tony | p=. !Salvo_Src.png! |
80 | 1 | COLIN, Tony | |
81 | 1 | COLIN, Tony | For H-Files : C:\Pumpkin\Salvo\Inc |
82 | 1 | COLIN, Tony | |
83 | 1 | COLIN, Tony | p=. !Salvo_Inc.png! |
84 | 1 | COLIN, Tony | |
85 | 1 | COLIN, Tony | For C-Files : C:\Pumpkin\CubeSatKit\DSPIC33\src |
86 | 1 | COLIN, Tony | |
87 | 1 | COLIN, Tony | p=. !PIC_src.png! |
88 | 1 | COLIN, Tony | |
89 | 1 | COLIN, Tony | For H-Files : C:\Pumpkin\CubeSatKit\DSPIC33\inc |
90 | 1 | COLIN, Tony | |
91 | 1 | COLIN, Tony | p=. !PIC_inc.png! |
92 | 1 | COLIN, Tony | |
93 | 1 | COLIN, Tony | For Libraries : C:\Pumpkin\CubeSatKit\DSPIC33\lib\mcc30-v3 |
94 | 1 | COLIN, Tony | |
95 | 1 | COLIN, Tony | p=. !PIC_lib.png! |
96 | 1 | COLIN, Tony | |
97 | 1 | COLIN, Tony | For peripheral libraries of dsPIC33F : C:\Program Files (x86)\Microchip\xc16\v1.25\support\peripheral_30F_24H_33F |
98 | 1 | COLIN, Tony | |
99 | 1 | COLIN, Tony | p=. !Peripheral_Lib.png! |
100 | 1 | COLIN, Tony | |
101 | 1 | COLIN, Tony | For Pumpkin library for dsPIC33 : C:\Pumpkin\Library\DSPIC33\Inc and C:\Pumpkin\Library\DSPIC33\Src |
102 | 1 | COLIN, Tony | |
103 | 1 | COLIN, Tony | p=. !Pumpkin_Lib_Inc.png! !Pumpkin_Lib_Src.png! |
104 | 1 | COLIN, Tony | |
105 | 1 | COLIN, Tony | For preliminary files from test : C:\Pumpkin\CubeSatKit\Example\dsPIC33\dsPIC33FJ256GP710\CubeSat_Kit_Dev_Board\Test\Test1 |
106 | 1 | COLIN, Tony | |
107 | 1 | COLIN, Tony | p=. !PIC_Test1.png! |
108 | 1 | COLIN, Tony | |
109 | 1 | COLIN, Tony | Add lib : C:\Pumpkin\CubeSatKit\Example\dsPIC33\dsPIC33FJ256GP710\CubeSat_Kit_Dev_Board\Test\Test1\MPLAB_C30\Pro-lib |
110 | 1 | COLIN, Tony | |
111 | 1 | COLIN, Tony | p=. !ProLib.png! |
112 | 1 | COLIN, Tony | |
113 | 1 | COLIN, Tony | For files from test : C:\Pumpkin\CubeSatKit\Example\all\all\CubeSatKit_Dev_Board\Test\Test1 |
114 | 1 | COLIN, Tony | |
115 | 1 | COLIN, Tony | p=. !all_Test1.png! |
116 | 1 | COLIN, Tony | |
117 | 1 | COLIN, Tony | --- |
118 | 1 | COLIN, Tony | |
119 | 1 | COLIN, Tony | h2. 5. Building |
120 | 1 | COLIN, Tony | |
121 | 1 | COLIN, Tony | 1- Add *Header folders* for compiler : |
122 | 1 | COLIN, Tony | Right-click on your project > Properties > XC16 (Global Options) > Common include dirs [...] > Browse... > Select all directories containing headers |
123 | 1 | COLIN, Tony | |
124 | 1 | COLIN, Tony | p=. !Include.png! |
125 | 1 | COLIN, Tony | |
126 | 1 | COLIN, Tony | -> Compiler doesn't know otherwise include<...> in files |
127 | 1 | COLIN, Tony | |
128 | 1 | COLIN, Tony | 2- In order to avoid conflict between files of C:\Pumpkin\Salvo\Src and C:\Pumpkin\Salvo\Src\MCC30 : |
129 | 1 | COLIN, Tony | |
130 | 1 | COLIN, Tony | p=. !Conflict.png! |
131 | 1 | COLIN, Tony | |
132 | 1 | COLIN, Tony | You have to *keep* : |
133 | 7 | COLIN, Tony | * *salvohook_idle.c* of MCC30/ -> Remove it from Src |
134 | 6 | COLIN, Tony | * *salvohook_interrupt_MCC30_IRQ.c* -> Remove from Project all salvohook_interrupt.c |
135 | 6 | COLIN, Tony | * *salvohook_wdt_MCC30_clrwdt.c* -> Remove from Project all salvohook_wdt.c |
136 | 6 | COLIN, Tony | * *salvoportmcc30-sm.s* -> Remove from Project salvoportmcc30-lm.s if present |
137 | 1 | COLIN, Tony | |
138 | 1 | COLIN, Tony | 3- Right-click on your project > Properties > XC16 (Global Options) > Change Output file format from ELF to COFF |
139 | 1 | COLIN, Tony | |
140 | 1 | COLIN, Tony | p=. !Output_File.png! |
141 | 1 | COLIN, Tony | |
142 | 1 | COLIN, Tony | -> All libraries are dedicated to "coff" |
143 | 1 | COLIN, Tony | |
144 | 1 | COLIN, Tony | --- |
145 | 1 | COLIN, Tony | |
146 | 1 | COLIN, Tony | h2. 6. Running |
147 | 1 | COLIN, Tony | |
148 | 1 | COLIN, Tony | 1- Connection to the development board and Run |
149 | 1 | COLIN, Tony | -> You should have the following output : |
150 | 1 | COLIN, Tony | |
151 | 1 | COLIN, Tony | p=. !Build.png! |