|
Size: 879
Comment: add IIO cleanup small tasks
|
Size: 3316
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = IIO staging cleanup = |
|
| Line 5: | Line 3: |
| == checkpatch.pl cleanups == | = checkpatch.pl cleanups = |
| Line 10: | Line 8: |
| * status: not assigned | * status: assigned to Tapasweni Pathak (irc: tapasweni) |
| Line 12: | Line 10: |
| * status: not assigned | * status: assigned to Vaishali Thakkar (irc: vaishu) |
| Line 14: | Line 12: |
| * status: not assigned | * status: assigned to Roxana Blaj (irc: roxana) |
| Line 17: | Line 15: |
| * Documentation/ * status: assigned to Heena Sirwani (irc: heena) |
|
| Line 18: | Line 18: |
| * status: not assigned | * status: '''clean''' - resolved by Roxana Blaj (irc: roxana) |
| Line 20: | Line 20: |
| * status: '''clean''' | * status: assigned to Heena Sirwani (irc: heena) |
| Line 24: | Line 24: |
| * status: not assigned | * status: assigned to Roberta Dobrescu (irc: roberta) |
| Line 26: | Line 26: |
| * status: not assigned | * status: '''clean''' (there is one line over 80 chars but we won't fix it because it makes code harder to read) |
| Line 28: | Line 28: |
| * status: not assigned | * status: assigned to Darshana Padmadas (irc: darshana) |
| Line 30: | Line 30: |
| * status: '''clean''' | * status: assigned to Roberta Dobrescu (irc: roberta) |
| Line 32: | Line 32: |
| * status: not assigned | * status: assigned to Darshana Padmadas (irc: darshana) |
| Line 34: | Line 34: |
| Please send us an email with the directory you want to work on. Please specify your full name and IRC handle. | A directory (e.g. `accel`) is considered clean in the context of checkpatch.pl if running the following commands results in no warnings or errors: * {{{scripts/checkpatch.pl -f drivers/staging/iio/accel/*.c}}} * {{{scripts/checkpatch.pl -f drivers/staging/iio/accel/*.h}}} * {{{scripts/checkpatch.pl -f drivers/staging/iio/accel/Kconfig}}} Please send us an email with the directory you want to work on. Don't forget to specify your full name and IRC handle. = Experimenting with IIO subsystem = For this we will use two kernel modules found in {{{drivers/staging/iio}}}: * {{{iio_dummy_evgen.ko}}} - generates ''fake'' events interrupts to be used by the {{{iio_dummy}}} example driver * implementation for this module is in {{{iio_dummy_evgen.c}}} * {{{iio_dummy.ko}}} - example IIO driver to demonstrate existing functionality * core implementation can be found in {{{iio_simple_dummy.c}}} * buffer functionality is implemented in {{{iio_simple_dummy_buffer.c}}} * events functionality is implemented in {{{iio_simple_dummy_events.c}}} == Dummy modules compilation == You need to select the following config options: * {{{CONFIG_IIO_DUMMY_EVGEN}}}} - for building {{{iio_dummy_evgen}}} kernel module * {{{CONFIG_IIO_SIMPLE_DUMMY}}} - for building {{{iio_dummy}}} kernel module * {{{CONFIG_IIO_SIMPLE_DUMMY_EVENTS}}}, {{{CONFIG_IIO_SIMPLE_DUMMY_BUFFER}}} should be selected for events and buffer functionality. Use the following commands for modules compilation: * {{{$ make drivers/staging/iio/iio_simple_dummy.ko}}} * {{{$ make drivers/staging/iio/iio_dummy.ko}}} == IIO sysfs attributes == * TBA == IIO event monitor == IIO event monitor is an user space example application which reads events from IIO layer and pretty prints the results. Implementation can be found in {{{iio_event_monitor.c}}} under {{{iio/drivers/staging/iio/Documentation}}}. [[BR]] Task: * compile {{{iio_event_monitor.c}}} to obtain an executable called {{{iio_event_monitor}}}. Send an email with the command used for compilation to mentors listed at the top of the page. |
Mentors: [http://kernelnewbies.org/OctavianPurdila Octavian Purdila], [http://kernelnewbies.org/DanielBaluta Daniel Baluta]
checkpatch.pl cleanups
Use scripts/checkpatch.pl to align code in staging/drivers/iio to Linux kernel coding style.
- accel/
- status: assigned to Tapasweni Pathak (irc: tapasweni)
- adc/
- status: assigned to Vaishali Thakkar (irc: vaishu)
- addac/
- status: assigned to Roxana Blaj (irc: roxana)
- cdc/
status: clean
- Documentation/
- status: assigned to Heena Sirwani (irc: heena)
- frequency/
status: clean - resolved by Roxana Blaj (irc: roxana)
- gyro/
- status: assigned to Heena Sirwani (irc: heena)
- impedance-analyzer/
status: clean
- light/
- status: assigned to Roberta Dobrescu (irc: roberta)
- magnetometer/
status: clean (there is one line over 80 chars but we won't fix it because it makes code harder to read)
- meter/
- status: assigned to Darshana Padmadas (irc: darshana)
- resolver/
- status: assigned to Roberta Dobrescu (irc: roberta)
- trigger/
- status: assigned to Darshana Padmadas (irc: darshana)
A directory (e.g. accel) is considered clean in the context of checkpatch.pl if running the following commands results in no warnings or errors:
scripts/checkpatch.pl -f drivers/staging/iio/accel/*.c
scripts/checkpatch.pl -f drivers/staging/iio/accel/*.h
scripts/checkpatch.pl -f drivers/staging/iio/accel/Kconfig
Please send us an email with the directory you want to work on. Don't forget to specify your full name and IRC handle.
Experimenting with IIO subsystem
For this we will use two kernel modules found in drivers/staging/iio:
iio_dummy_evgen.ko - generates fake events interrupts to be used by the iio_dummy example driver
implementation for this module is in iio_dummy_evgen.c
iio_dummy.ko - example IIO driver to demonstrate existing functionality
core implementation can be found in iio_simple_dummy.c
buffer functionality is implemented in iio_simple_dummy_buffer.c
events functionality is implemented in iio_simple_dummy_events.c
Dummy modules compilation
You need to select the following config options:
CONFIG_IIO_DUMMY_EVGEN} - for building iio_dummy_evgen kernel module
CONFIG_IIO_SIMPLE_DUMMY - for building iio_dummy kernel module
CONFIG_IIO_SIMPLE_DUMMY_EVENTS, CONFIG_IIO_SIMPLE_DUMMY_BUFFER should be selected for events and buffer functionality.
Use the following commands for modules compilation:
$ make drivers/staging/iio/iio_simple_dummy.ko
$ make drivers/staging/iio/iio_dummy.ko
IIO sysfs attributes
- TBA
IIO event monitor
IIO event monitor is an user space example application which reads events from IIO layer and pretty prints the results. Implementation can be found in iio_event_monitor.c under iio/drivers/staging/iio/Documentation. BR Task:
compile iio_event_monitor.c to obtain an executable called iio_event_monitor. Send an email with the command used for compilation to mentors listed at the top of the page.