Project

General

Profile

Wiki » History » Version 17

Alexis Jeandet, 16/03/2016 04:26 PM

1 1 Alexis Jeandet
h1. SocExplorer Wiki
2 1 Alexis Jeandet
3 1 Alexis Jeandet
{{>toc}}
4 1 Alexis Jeandet
5 1 Alexis Jeandet
Child pages:
6 1 Alexis Jeandet
{{child_pages}}
7 1 Alexis Jeandet
8 3 Alexis Jeandet
"Win32 setup(Experimental)":https://hephaistos.lpp.polytechnique.fr/redmine/attachments/download/234/SocExplorer_win32_setup_r31.exe
9 1 Alexis Jeandet
"Source code":https://hephaistos.lpp.polytechnique.fr/rhodecode/HG_REPOSITORIES/LPP/INSTRUMENTATION/SocExplorer
10 13 Alexis Jeandet
"RPM packages":http://copr.fedoraproject.org/coprs/ajeandet/SocExplorer
11 1 Alexis Jeandet
12 1 Alexis Jeandet
h2. General description
13 1 Alexis Jeandet
14 4 Alexis Jeandet
SocExplorer is an open source generic System On Chip testing software/framework. We write this software for the development and the validation of our instrument, the "Low Frequency Receiver":https://hephaistos.lpp.polytechnique.fr/redmine/projects/solar-orbiter-lfr (LFR) for the Solar Orbiter mission. This instrument is based on an "actel FPGA":http://www.microsemi.com/products/fpga-soc/fpga-and-soc hosting a "LEON3FT":http://www.gaisler.com/index.php/products/processors processor and some peripherals. To make it more collaborative, we use a plugin based system, the main executable is SocExplorer then all the functionality are provided by plugins. Like this everybody can provide his set of plugins to handle a new SOC or just a new peripheral. SocExplorer uses "PythonQt":http://pythonqt.sourceforge.net/ to allow user to automate some tasks such as loading some plugins, configuring them and talking with his device. SocExplorer is provided under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
15 1 Alexis Jeandet
16 1 Alexis Jeandet
h2. To install it
17 1 Alexis Jeandet
18 16 Alexis Jeandet
* If you are running windows you can directly download the setup "here":https://hephaistos.lpp.polytechnique.fr/redmine/attachments/download/234/SocExplorer_win32_setup_r31.exe. (Outdated)
19 1 Alexis Jeandet
_Please note that if you are running Windows you will have some limitations, we spend much less effort on windows support than linux._
20 1 Alexis Jeandet
* If you are a Fedora user you can directly use the copr repository "here":https://copr.fedoraproject.org/coprs/ajeandet/SocExplorer/
21 16 Alexis Jeandet
Or our repository "here":https://hephaistos.lpp.polytechnique.fr/repositories/Fedora/
22 1 Alexis Jeandet
* If you are running Linux you can follow theses [[Linux_setup|steps]].
23 1 Alexis Jeandet
_We have never tried any other Unix like Os such as Mach or BSD, it could compile since it rely on Qt but the installation would break and some plugins won't compile._
24 1 Alexis Jeandet
25 17 Alexis Jeandet
h2. Reporting a bug
26 17 Alexis Jeandet
27 17 Alexis Jeandet
To report bugs, you need to register in our system them you can report bugs "here":https://hephaistos.lpp.polytechnique.fr/redmine/projects/socexplorer/issues/new
28 17 Alexis Jeandet
If you don't want to register you can simply send a "mail":mailto:alexis.jeandet@member.fsf.org 
29 17 Alexis Jeandet
30 1 Alexis Jeandet
h2. Use cases
31 1 Alexis Jeandet
32 1 Alexis Jeandet
h3. Use case 1
33 1 Alexis Jeandet
34 1 Alexis Jeandet
In this case, the [[AHBUARTplugin|AHBUARTplugin]] and the [[Memctrlplugin|memctrlplugin]] are loaded. The ahbuartplugin is called a root plugin because it is at the top of the plugin hierarchy, it makes the connection between SocExplorer and the AMBA bus. Talking through the root plugin, the memctrlplugin allows you to test some memory space at a given address. 
35 1 Alexis Jeandet
!{width: 80%}SocExplorerUseCase1.png(SocExplorer use case 1)!
36 1 Alexis Jeandet
37 1 Alexis Jeandet
h3. Use case 2
38 1 Alexis Jeandet
39 1 Alexis Jeandet
In this use case, the root plugin is the [[RMAPplugin|rmapplugin]], this plugin allows you to talk through either the "GRESB":http://www.gaisler.com/index.php/products/systems/gresb or the stardundee "SpaceWire-USB Brick":http://star-dundee.com/products/spacewire-usb-brick. The second loaded plugin is the [[Genericrwplugin|genericrwplugin]]. This plugin is a simple hexadecimal editor, you can use it to view or edit any space of the SOC memory, see below in the SocExplorer screenshot. 
40 1 Alexis Jeandet
!{width: 80%}SocExplorerUseCase2.png(SocExplorer use case 2)!
41 1 Alexis Jeandet
42 5 Alexis Jeandet
h1. Videos
43 5 Alexis Jeandet
44 8 Alexis Jeandet
This video is quite outdated but gives a good overview of what SocExplorer is able to do.
45 14 Alexis Jeandet
>{{video(https://hephaistos.lpp.polytechnique.fr/data/SocExplorer_Overview.webm)}}
46 1 Alexis Jeandet
47 10 Alexis Jeandet
If the video doesn't load you can directly watch it from "here":ftp://ftp.lpp.polytechnique.fr/jeandet/keep/SocExplorer_Overview.webm
48 10 Alexis Jeandet
49 1 Alexis Jeandet
h1. Screenshots
50 1 Alexis Jeandet
51 12 Alexis Jeandet
table(noborder){width: 90%;text-align: center;}.
52 11 Alexis Jeandet
|!{width: 100%;padding:1em;}https://hephaistos.lpp.polytechnique.fr/redmine/attachments/download/221/SocExplorer1.png(SocExplorer running on Linux)!:https://hephaistos.lpp.polytechnique.fr/redmine/attachments/download/221/SocExplorer1.png|!{width: 100% ;padding:1em;}https://hephaistos.lpp.polytechnique.fr/redmine/attachments/download/353/SocExplorer2.png(SocExplorer loading code on LFR)!:https://hephaistos.lpp.polytechnique.fr/redmine/attachments/download/353/SocExplorer2.png|
53 11 Alexis Jeandet
54 1 Alexis Jeandet
{{lastupdated_at}} by {{lastupdated_by}}