| 65 | | RCS_file:_/usr1/CVS/rtems/testsuites/samples/hello/init.c,v |
| 66 | | retrieving_revision_1.15 |
| 67 | | diff_-u_-r1.15_init.c |
| 68 | | ---_init.c 11_Jan_2008_22:50:10_-0000 1.15 |
| 69 | | +++_init.c 20_Jan_2009_21:13:09_-0000 |
| 70 | | @@_-29,8_+29,9_@@ |
| 71 | | ___rtems_task_argument_ignored |
| 72 | | _) |
| 73 | | _{ |
| 74 | | -__printf(_"\n\n***_HELLO_WORLD_TEST_***\n"_); |
| 75 | | -__printf(_"Hello_World\n"_); |
| 76 | | -__printf(_"***_END_OF_HELLO_WORLD_TEST_***\n"_); |
| 77 | | +__printf(_"\n\n***_GSOC_HELLO_WORLD_TEST_***\n"_); |
| 78 | | +__printf(_"This_is_Joel's_Hello_World\n"_); |
| 79 | | +__printf(_"Welcome_to_RTEMS_and_Google_Summer_of_Code_2009\n"_); |
| 80 | | +__printf(_"***_END_OF_GSOC_HELLO_WORLD_TEST_***\n"_); |
| 81 | | ___exit(_0_); |
| 82 | | _} |
| | 65 | RCS file: /usr1/CVS/rtems/testsuites/samples/hello/init.c,v |
| | 66 | retrieving revision 1.15 |
| | 67 | diff -u -r1.15 init.c |
| | 68 | --- init.c 11 Jan 2008 22:50:10 -0000 1.15 |
| | 69 | +++ init.c 20 Jan 2009 21:13:09 -0000 |
| | 70 | @@ -29,8 +29,9 @@ |
| | 71 | rtems_task_argument ignored |
| | 72 | ) |
| | 73 | { |
| | 74 | - printf( "\n\n*** HELLO WORLD TEST ***\n" ); |
| | 75 | - printf( "Hello World\n" ); |
| | 76 | - printf( "*** END OF HELLO WORLD TEST ***\n" ); |
| | 77 | + printf( "\n\n*** GSOC HELLO WORLD TEST ***\n" ); |
| | 78 | + printf( "This is Joel's Hello World\n" ); |
| | 79 | + printf( "Welcome to RTEMS and Google Summer of Code 2009\n" ); |
| | 80 | + printf( "*** END OF GSOC HELLO WORLD TEST ***\n" ); |
| | 81 | exit( 0 ); |
| | 82 | } |
| 87 | | [wiki: ]TOC| right}} |
| 88 | | |
| 89 | | GSoC 2008 was the first time the RTEMS Project participated in the Google Summer of Code. After talking to mentors from other projects, we noticed that we all suffered from a "getting started" issue. You are more likely to have a successful project for any organization in GSoC if you are able to build their code, run their examples and make minor modifications. The quicker you cross this hurdle, the sooner you will be doing "real" work. |
| 90 | | |
| 91 | | Please join the RTEMS Mailing List and speak up. Ask questions. Help correct any deficiency in code or documentation you spot. The ultimate goal of GSoC is not money, it is getting students to participate in the open source community. We don't want this to be a one shot thing. |
| 92 | | = Configure a Development Computer = |
| 93 | | |
| 94 | | |
| 95 | | You will be best served by using a GNU/Linux distribution for which we provide RPMs. The core RTEMS developers use Fedora and we are best able to support you when we are all on the same development host operating system. As of January 20 2008, most core RTEMS developers have moved to Fedora 10. We will ALWAYS be on a version that is supported by the distribution. |
| 96 | | |
| 97 | | This step involves the following steps. |
| 98 | | |
| 99 | | * Install or update GNU/Linux distribution as needed. |
| 100 | | |
| 101 | | * Install RTEMS Tools. See [wiki:TBR/UserManual/RTEMS_Development_Hosts RTEMS Development Hosts] for information but remember we encourage you to use Fedore and thus you will follow the APT/Yum instructions. |
| 102 | | |
| 103 | | As you will be compiling code, it is recommended to have a reasonably fast machine. |
| 104 | | = =Configure and Build RTEMS for SPARC/SIS== |
| 105 | | |
| 106 | | |
| 107 | | * Check out RTEMS from CVS. See [wiki:TBR/Delete/RTEMS_CVS_Repository RTEMS CVS Repository for information. |
| 108 | | |
| 109 | | * Bootstrap RTEMS (covered in Wiki page referenced above). |
| 110 | | |
| 111 | | * Build RTEMS for the SPARC/sis BSP. [[Image(Start]_shows_how_to_do_this. |
| 112 | | |
| 113 | | * _Run_hello_world_example_in_source_tree._ |
| 114 | | |
| 115 | | * _Install_RTEMS. |
| 116 | | |
| 117 | | * _Build_hello_world_included_in_the_class-examples_CVS_module. |
| 118 | | |
| 119 | | * _Run_hello_world_example_in_the_class-examples_CVS_module._ |
| 120 | | |
| 121 | | The_sparc-rtems4.10-gdb_session_with_the_unmodified_hello_world_will_look_something_like_the_following: |
| 122 | | |
| 123 | | SPARC-SIS-HelloWorld.png)]] |
| 124 | | |
| 125 | | Note_that_this_image_is_careful_not_to_show_you_how_to_configure_or_build_the_executable_being_run. |
| 126 | | |
| 127 | | ==Configure_and_Build_RTEMS_for_"Preferred"_BSP== |
| 128 | | |
| 129 | | |
| 130 | | The_preferred_BSP_depends_on_your_project_but_your_first_choice_should_be_a_BSP_that_runs_on_a_simulator_included_in_gdb.__SPARC/sis_is_a_good_candidate_because_it_is_easy_to_work_with.__If_your_project_requires_a_BSP_to_support_TCP/IP_of_something_else_not_supported_by_SPARC/sis,_then_still_first_try_a_simple_environment_like_SPARC/sis_and_then_move_on_to_the_one_that_will_support_your_project.__Discuss_your_project_requirements_on_the_RTEMS_mailing_list_and_let_the_community_help_point_you_in_the_right_direction. |
| 131 | | |
| 132 | | If_SPARC/sis_is_not_the_right_test_platform_for_your_project_then_you_will_need_to_ensure_you_know_how_to_run_hello_world_on_your_preferred_BSP. |
| 133 | | |
| 134 | | ==Prove_You_Can_Work_On_RTEMS== |
| 135 | | |
| 136 | | |
| 137 | | <center> |
| 138 | | SEND_DIFF_AND_SCREEN_CAPTURE_AS_VERIFICATION. |
| 139 | | </center> |
| 140 | | |
| 141 | | Modify_the_hello_world_example_in_the_class-examples_CVS_module_to_include_your_name.__Something_like_"Hello_Fred!"._Then_send_us_enough_to_prove_to_us_that_you_did_this.__We_want_to_know_you_can_work_with_RTEMS.__Ask_on_the_mailing_list_about_how_to_submit_the_proof.__We_want_you_to_be_open_and_active. |
| 142 | | |
| 143 | | Send_a_"cvs_diff"_of_your_changes.__This_will_look_something_like_this: |
| 144 | | |
| 145 | | {{{ |
| 146 | | Index:_init.c |
| 147 | | =================================================================== |
| 148 | | |
| 149 | | RCS_file:_/usr1/CVS/rtems/testsuites/samples/hello/init.c,v |
| 150 | | retrieving_revision_1.15 |
| 151 | | diff_-u_-r1.15_init.c |
| 152 | | ---_init.c 11_Jan_2008_22:50:10_-0000 1.15 |
| 153 | | +++_init.c 20_Jan_2009_21:13:09_-0000 |
| 154 | | @@_-29,8_+29,9_@@ |
| 155 | | ___rtems_task_argument_ignored |
| 156 | | _) |
| 157 | | _{ |
| 158 | | -__printf(_"\n\n***_HELLO_WORLD_TEST_***\n"_); |
| 159 | | -__printf(_"Hello_World\n"_); |
| 160 | | -__printf(_"***_END_OF_HELLO_WORLD_TEST_***\n"_); |
| 161 | | +__printf(_"\n\n***_GSOC_HELLO_WORLD_TEST_***\n"_); |
| 162 | | +__printf(_"This_is_Joel's_Hello_World\n"_); |
| 163 | | +__printf(_"Welcome_to_RTEMS_and_Google_Summer_of_Code_2009\n"_); |
| 164 | | +__printf(_"***_END_OF_GSOC_HELLO_WORLD_TEST_***\n"_); |
| 165 | | ___exit(_0_); |
| 166 | | _} |
| 167 | | }}} |
| 168 | | |
| 169 | | * _Take_a_"snapshot"_of_your_modified_hello_world_and_send_us_the_png._On_GNU/Linux,_you_should_be_able_to_press_the_"Prnt_Scrn"_button_or_use_the_"xwd"_command.__This_is_a_snapshot_that_[[Image(oelSherrill_took_after_running_the_hello_world_program_with_the_above_changes. |
| 170 | | |
| 171 | | [[Image:SPARC-SIS-HelloWorld-Modded.png)]] |
| | 87 | [[Image(SPARC-SIS-HelloWorld-Modded.png)]] |
![[RTEMS Logo]](/images/logo.png){kind=logo}
