The book of dt interrupts

[MOUNTAIN747]

Returning to PICbasic after five years of working with BS2 in a number of K12 schools. It’s not a walk in the park to pick up where you left off. I’ve jump back in working with DT’s interrupts. I’m having to start from day one. After reviewing much of DT's work and the great stuff that has been posted on wiki, I was wondering how difficult it would be to develop an index of all DT’s work by individual interrupt topics. As I try to decipher all the threads on an individual topic I find many of the links no longer work and many threads jump from one topic to another. This all makes unraveling needed information extremely difficult and it's only going to get more difficult over time.

I know this would be a great effort. Many forum members could, and would, become involved to make this happen. Key persons could agree on a format and members with experience in each topic could contribute information developed around the agreed format, submit to a location, and moderators could agree or disagree to post to the BOOK. I am no expert on organizing this kind of effort but I’m sure someone out there is. Links could be added to extend relevant information if needed but many links fall short over time. This could also add some needed spice to the forum. This would be “The Book of DT_INT’s” and a tribute to Darrel's contributions.

Example:
General: DT_Interrupts must be used with MPASM
Include files:
INCLUDE DT_INTS-14.bas
INCLUDE ReEnterPBP-14.bas

1. ASM
2. INT_LIST macro ; IntSource, Label, Type, ResetFlag?
3. INT_Handler RX_INT, _GetData, PBP, yes
4. endm
5. INT_CREATE ; Creates the interrupt processor
6. ENDASM

Works with PIC12fxxxx and PIC16fxxxx
RX_INT - USART Receive Interrupt. Interrupt for HSERIN communication
* RX_INT will NOT work with Serin or Serin2
* INT_ENABLE RX_INT – to enable RX interrupt after handler is created.
* INT_DISABLE RX_INT – disable RX interrupt
* INT_RETURN – To restore and return to the program where interrupt was made.
* ResetFlag switch is not required to be YES, FIFO buffer is cleared when read.
*
* all other relevant information on this topic
*

TX_INT - USART Transmit Interrupt. Interrupt for HSEROUT communication
* TX_INT will NOT work with Serout or Serout2
*
*

comments please,
Wayne

[lester]

I think this is a great idea
There is no reason why this could not be created in a new section of the WiKi with all relavent code examples, being copied from their current locations and uploaded to a single repositiry on the forum server.

I could set up the facility, but it would require moderation and general oversight by a trusted from member.

I can give users permissions to post into the new Wiki area and provide extended markup language to easy flexible page generation.

Let me know if you'd like to go ahead with this and i'll make the changes required.

[lester]

I'm putting something together

i'll PM with some information

[MOUNTAIN747]

Lester, I think the WiKi would be a great place for THE BOOK. And yes, it would be great to link to examples. I think the main pages should be relevant information only and any further discussion on an aspect of the topic should be linked to off page. I am sure others would have an opinion about what this should look like and I would like to hear from them.

Adding to an individual INT subject should be simple and straight forward. Someone may want to add only one line.
*RX_INT will NOT work with Serin or Serout

Someone may have an excellent example of code or discussion to describe the one line. I’m not sure yet how this would be submitted but I’m sure this can also be simplified.

I think we should start with DT’ on original list of interrupts. What do you think?

INT_INT -- INT External Interrupt
RBC_INT -- RB Port Change Interrupt
TMR0_INT -- TMR0 Overflow Interrupt 16f
TMR1_INT -- TMR1 Overflow Interrupt
TMR2_INT -- TMR2 to PR2 Match Interrupt

We could start with the list and expand each item.

Wayne

[lester]

Wayne, could you kick things off by posting links to the posts by DT that you think should be in the 'Book'

I will find some time to create the first pages..these can be used as examples to those that want to join in and create additional pages.

[lester]

Visual Impact is very important

there are a umber of 'off the shelf ' skins that we can use for the "book'

Take a look here, let me know what skin you think best,

currently we are using Adapt

a skin that adapts to screen size, from large high-resolution desktop displays through mobile phones. The side menu automagically switches to a hamburger menu on mobile devices. This skin has a big easy-to-read default font size for compatibility with modern high-density displays.

[HenrikOlsson]

You know about the "temporary" repository of Darrels work, right?
http://www.picbasic.co.uk/forum/showthread.php?t=19638

/Henrik.

[lester]

You know about the "temporary" repository of Darrels work, right?
http://www.picbasic.co.uk/forum/showthread.php?t=19638

er, yes! , I think i know the forum inside out and upside down

I also think the "temporary" repository, is just that ,"temporary".

It was somewhere to put things as an aide memoir. At the time , it was a good idea, but time has shown it to be inefficient and a daunting area to navigate through for new and old users alike.

The proposed new resource, is far more organized, therefore easier to navigate and is NOT integral to the forum, so will not be depreciated over time as the forum grows.

I could use some help.....

[HenrikOlsson]

You did ask Wayne for links to Darrels posts, I just wanted to make sure that you and/or Wayne hadn't missed the apparently obvious one, my appologies.
I'd be happy to help where I can but setting up the overall layout, or "style" or whatever for a complete book is out of my comfort zone.

[MOUNTAIN747]

Henrik,
Thanks for the link, I would like to see you become QC. You simply review what we’ve done and comment if we have errors or if something that could be explained in a better manner. I have only worked with a few of the INT’s so I may not interpret what is said in the treads with absolute accuracy. And we want absolute accuracy said in a manor a ten year old could understand (if that’s possible). I’ve been reading your comments for a long time and I know you would be perfect for this job.
Wayne

[MOUNTAIN747]

Too all members and visitors,
Lester has come up with a pretty good LOGO for THE BOOK but I would be interested in what all of you may be able to come up with. Please submit your idea for a LOGO for Darrel Taylor's ........... THE BOOK of DT's INTERRUPTS. The LOGO would be on the HOME page of the BOOK. Submit a sketch if possible.
Wayne

[lester]

Henrik.
if you can assist at all, i'd be happy to receive your confirmation via PM. (my response to your post was with a smile. - as you can imagine not much goes on here without me seeing :-)

then i'll send you log in details

currently the work is behind a wall, so that the work can carry on to completion before making it public

Of course other volunteers are welcome

[mpgmike]

May I suggest a work zone where tasks needing to be done can be posted and volunteers can claim the next one to work on? What this does is prevent 5 volunteers from performing the same work, yet other work never gets done. I volunteered but have no clue where to start, or if there is already work in progress.

[MOUNTAIN747]

Volunteers are always welcome. Lester will have to give you access and will get in touch at first chance. He will explain the markup language that is being used, not too difficult at all for just laying in text. I have all the -14's started but a long way to go. Lester may want you to lay in text for the -18s. Thanks for stepping up.
Wayne

[Ioannis]

It seems that I cannot access the page of dt.picbasic.co.uk.

Has the password changed?

Please also interested in any directions on setting up new articles.

Ioannis

[lester]

There is a new forum area for discussion between those that have expressed an interest in assisting

http://www.picbasic.co.uk/forum/forumdisplay.php?f=41

access is limited to those that have volunteered their time.