Return value in Mailbox Doc Topic is solved

Report here problems in any of ChibiOS components. This forum is NOT for support.
User avatar
aGuegu
Posts: 29
Joined: Thu Dec 07, 2017 4:15 am
Has thanked: 1 time
Been thanked: 5 times

Return value in Mailbox Doc  Topic is solved

Postby aGuegu » Thu Dec 14, 2017 5:16 am

http://chibios.sourceforge.net/html/gro ... boxes.html

The return msg_t in mailbox functions should be MSG_OK, MSG_RESET, MSG_TIMEOUT, not RDY_OK, RDY_RESET, RDY_TIMEOUT.

User avatar
aGuegu
Posts: 29
Joined: Thu Dec 07, 2017 4:15 am
Has thanked: 1 time
Been thanked: 5 times

Re: Return value in Mailbox Doc

Postby aGuegu » Thu Dec 14, 2017 5:53 am

and in the main function of the demo code

Code: Select all

for (i == 0; i < NUM_BUFFERS; i++)
    (void)chMBPost(&free_buffers, (msg_t)&buffers[i]);


should be

Code: Select all

for (i = 0; i < NUM_BUFFERS; i++)
    (void)chMBPost(&free_buffers, (msg_t)&buffers[i]);

User avatar
Giovanni
Site Admin
Posts: 14444
Joined: Wed May 27, 2009 8:48 am
Location: Salerno, Italy
Has thanked: 1074 times
Been thanked: 921 times
Contact:

Re: Return value in Mailbox Doc

Postby Giovanni » Thu Dec 14, 2017 8:17 am

Hi,

Exactly what demo code? there are several.

Giovanni

User avatar
aGuegu
Posts: 29
Joined: Thu Dec 07, 2017 4:15 am
Has thanked: 1 time
Been thanked: 5 times

Re: Return value in Mailbox Doc

Postby aGuegu » Thu Dec 14, 2017 1:28 pm

aGuegu wrote:and in the main function of the demo code

Code: Select all

for (i == 0; i < NUM_BUFFERS; i++)
    (void)chMBPost(&free_buffers, (msg_t)&buffers[i]);


should be

Code: Select all

for (i = 0; i < NUM_BUFFERS; i++)
    (void)chMBPost(&free_buffers, (msg_t)&buffers[i]);


The demo code at the guide book: http://www.chibios.org/dokuwiki/doku.ph ... _mailboxes

User avatar
aGuegu
Posts: 29
Joined: Thu Dec 07, 2017 4:15 am
Has thanked: 1 time
Been thanked: 5 times

Re: Return value in Mailbox Doc

Postby aGuegu » Thu Dec 14, 2017 1:31 pm

aGuegu wrote:http://chibios.sourceforge.net/html/group__mailboxes.html

The return msg_t in mailbox functions should be MSG_OK, MSG_RESET, MSG_TIMEOUT, not RDY_OK, RDY_RESET, RDY_TIMEOUT.


There are several RDY_XXX in the reference:

http://chibios.sourceforge.net/html/group___i2_c.html
http://chibios.sourceforge.net/html/gro ... boxes.html

Maybe should do a find all search, as they are no more defined in headers.

User avatar
Giovanni
Site Admin
Posts: 14444
Joined: Wed May 27, 2009 8:48 am
Location: Salerno, Italy
Has thanked: 1074 times
Been thanked: 921 times
Contact:

Re: Return value in Mailbox Doc

Postby Giovanni » Thu Dec 14, 2017 1:32 pm

Ah, you mean in the web book, fixed thanks.

You are looking at the 2.6.9 documentation, this is why you find those RDY_, it is the old name.

Giovanni

User avatar
aGuegu
Posts: 29
Joined: Thu Dec 07, 2017 4:15 am
Has thanked: 1 time
Been thanked: 5 times

Re: Return value in Mailbox Doc

Postby aGuegu » Fri Dec 15, 2017 3:59 am

Oh, I thought the online doc is always the latest stable release.

Would you please update it?

I managed to build the doc locally and served with http-server.

The new Doxygen 1.8.13, would suggest upgrade the config file

Code: Select all

ChibiOS_17.6.3/doc/hal $ doxygen Doxyfile_html
warning: Tag `CLANG_ASSISTED_PARSING' at line 1082 of file `Doxyfile_html' belongs to an option that was not enabled at compile time.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u", or recompile doxygen with this feature enabled.
warning: Tag `CLANG_OPTIONS' at line 1090 of file `Doxyfile_html' belongs to an option that was not enabled at compile time.
         To avoid this warning please remove this line from your configuration file or upgrade it using "doxygen -u", or recompile doxygen with this feature enabled.
Warning: node 'complete', graph 'example' size too small for label
Warning: node 'complete', graph 'example' size too small for label

User avatar
Giovanni
Site Admin
Posts: 14444
Joined: Wed May 27, 2009 8:48 am
Location: Salerno, Italy
Has thanked: 1074 times
Been thanked: 921 times
Contact:

Re: Return value in Mailbox Doc

Postby Giovanni » Fri Dec 15, 2017 8:32 am

Hi,

The documentation is accessible from here: http://chibios.org/dokuwiki/doku.php?id ... tion:start

From where are you accessing it? perhaps an old link somewhere.

Giovanni

User avatar
aGuegu
Posts: 29
Joined: Thu Dec 07, 2017 4:15 am
Has thanked: 1 time
Been thanked: 5 times

Re: Return value in Mailbox Doc

Postby aGuegu » Fri Dec 15, 2017 4:16 pm

Giovanni wrote:Hi,

The documentation is accessible from here: http://chibios.org/dokuwiki/doku.php?id ... tion:start

From where are you accessing it? perhaps an old link somewhere.

Giovanni


you are right. I know how I always go to the old link.

With the same hal i2c page.

The old link is http://chibios.sourceforge.net/html/group___i2_c.html
The new link is http://chibios.sourceforge.net/docs3/ha ... _i2_c.html

comparing these urls, we can see that the new one is "deeper". In the SEO words, deeper url ranks lower than higher one. So Google always guides me to the old doc.

Try google "chibios i2c", "chibios mailbox", "chibios spi", you would know what I mean. I must have been googled and stuck in the old one for quite a while...


Return to “Bug Reports”

Who is online

Users browsing this forum: No registered users and 6 guests